27.1 Übersicht

Die Listview-Klasse (Listenansicht) leitet sich von der Area-Klasse ab und zeigt einen Listencontainer, der mit Datenelementen gefüllt werden kann. Die Listview-Klasse von RapaGUI ist sehr mächtig und unterstützt mehrspaltige Listen (siehe weiter unten), Auswahlkästchen (Checkboxen), editierbare Listenelemente, Datensortierung über benutzerdefinierte Callback-Funktionen und Icons für die einzelnen Listenelemente.

Wenn Sie eine Listenansicht im XML-Code erstellen, müssen Sie immer mindestens eine Spalte hinzufügen. Dies geschieht über die Listviewcolumn-Klasse (Listenansichtsspalten). Hier ist ein Beispiel für eine minimale Listenansicht-Definition mit nur einer einzigen Spalte:

 
<listview>
   <column/>
</listview>

Es ist auch möglich, einige Einträge direkt während der Definition in die Listenansicht einzufügen. Dies kann mit dem Tag <item> geschehen:

 
<listview>
   <column>
      <item>Entry 1</item>
      <item>Entry 2</item>
      <item>Entry 3</item>
   </column>
</listview>

Wenn Sie eine mehrspaltige Liste haben wollen, müssen Sie den Tag <column> mehrmals verwenden. Hier ist ein Beispiel:

 
<listview>
   <column title="Column 1">
      <item>Entry 1</item>
      <item>Entry 2</item>
      <item>Entry 3</item>
   </column>
   <column title="Column 2">
      <item>Entry 1</item>
      <item>Entry 2</item>
      <item>Entry 3</item>
   </column>
   <column title="Column 3">
      <item>Entry 1</item>
      <item>Entry 2</item>
      <item>Entry 3</item>
   </column>
</listview>

In diesem Beispiel haben wir auch das Attribut Listviewcolumn.Title verwendet, um jeder unserer Spalten eine Titelleiste hinzuzufügen. Es gibt noch einige weitere Attribute, mit denen Sie das Aussehen Ihrer Spalten anpassen können. Beispielsweise können Sie Ihren Spalten Auswahlkästchen (Checkboxen) hinzufügen und die Bearbeitung von Spaltenelementen erlauben. Siehe Listviewcolumn-Klasse für Details.

Beachten Sie, dass RapaGUI für diese Klasse bis zu drei verschiedene Arten von Widgets verwenden kann: Wenn Sie eine Listenansicht erstellen, die keine erweiterten Eigenschaften verwendet (z.B. mehrere Spalten, Symbole, Sortierung), erstellt RapaGUI möglicherweise ein einfacheres Listenansichts-Widget für Sie, weil einige Betriebssysteme verschiedene Arten von listenbasierten Widgets anbieten. So gibt es z.B. unter Windows ein Listbox-Widget und ein Listenansichts-Widget. RapaGUI verwendet das Listbox-Widget, falls Ihre Listenansicht keine der erweiterten Eigenschaften verwendet, da Listbox-Widgets normalerweise schneller sind als Listenansichts-Widgets. Wenn Sie das nicht möchten, können Sie RapaGUI erzwingen, Ihnen immer eine vollständige Listenansicht zu geben, indem Sie das Attribut Listview.ForceMode auf den entsprechenden Tag setzen. Siehe Listview.ForceMode für Details.

Navigation zeigen