Einführung in Listboxen

Version 2004.2 (Geändert)

Die Befehle und Funktionen dieses Kapitels dienen zum Verwalten von Formularobjekten vom Typ Listbox.

Listboxen sind vergleichbar mit dem Objekt Gruppierte rollbare Bereiche. Eine Listbox bietet alle Funktionen von gruppierten rollbaren Bereichen, insbesondere die Möglichkeit, Daten in Form von Spalten und auswählenbaren Zeilen darzustellen. In Listboxen können Sie darüberhinaus Werte eingeben, Spalten sortieren, wechselnde Farben definieren, etc.

Sie können eine Listbox komplett im Formulareditor von 4th Dimension einrichten und sie auch über Programmierung verwalten. Weitere Informationen zum Erstellen und Verwenden im Formulareditor finden Sie im Handbuch 4th Dimension Designmodus.

Die Programmierung von Listboxen erfolgt auf dieselbe Art und Weise wie für andere 4th Dimension Formularobjekte vom Typ Liste. Hierfür müssen jedoch spezifische Regeln beachtet werden.

Hinweis: Listboxen werden nur für Bildschirmoberflächen angelegt. Sie können nicht gedruckt werden.

Das Objekt "Listbox" kann eine oder mehrere Spalten enthalten. Jede Spalte muss einem eindimensionalen 4th Dimension Array zugewiesen sein; alle Array-Typen sind möglich, mit Ausnahme von Array mit Zeigern. Das Anzeigeformat für jede Spalte lässt sich im Formulareditor oder über den Befehl SET FORMAT definieren.

Zum Verwalten der Werte in den Spalten (Eingabe und Anzeige) per Programmierung dienen Befehle für Listboxen, z.B. INSERT LISTBOX ROW oder DELETE LISTBOX ROW, sowie Befehle für Arrays. Sie können z.B. den Inhalt einer Spalte mit folgender Anweisung initialisieren:

   ARRAY TEXT(ColumnName; size)

Sie können auch eine Liste verwenden:

   LIST TO ARRAY("ListName"; ColumnName)

Warnung: Enthält die Listbox mehrere Spalten in verschiedenen Größen, erscheint nur die Anzahl der Einträge im kleinsten Array (Spalte). Stellen Sie sicher, dass alle Arrays jeweils dieselbe Anzahl Elemente haben. Auch wenn eine Spalte der Listbox leer ist, zeigt die Listbox nichts an. Das passiert, wenn das Array nicht korrekt deklariert wurde oder über die Programmiersprache in der Größe angepasst wurde.

Das Objekt List box besteht aus drei Elementen:

• Das Objekt selbst,

• Spalten,

• Spaltentitel

Diese Elemente lassen sich im Formulareditor einzeln auswählen, jedes davon hat einen eigenen Objekt- und Variablennamen und lässt sich separat bearbeiten.

Spalten haben im Formular standardmäßig den Namen Spalte1, 2 ... X, Spaltentitel Header1, 2 ... X, sie sind unabhängig vom Objekt Listbox selbst.

Jede Art Eintrag enthält eigene sowie mit anderen Einträgen geteilte Merkmale. Schriften lassen sich z.B. für die ganze Listbox zuweisen oder für getrennt Spalten und Kopfteil. Eigenschaften für die Eingabe lassen sich hingegen nur für Spalten definieren.

Diese Regeln gelten für die Befehle im Kapitel "Objekteigenschaften", die für Listboxen geeignet sind. Je nach Funktionalität gelten sie für die gesamte Listbox, für Spalten bzw. Spaltentitel. Das entsprechende Element übergeben Sie mit seinem Namen oder über die dazuhörige Variable.

Nachfolgende Tabelle zeigt die bisherigen und neuen Routinen aus dem Kapitel „Objekte" an und für welche Elemente sie gelten:

Hinweise:

• Alle Routinen im Kapitel "Listbox" gelten nur für Objekte der Listbox, mit Ausnahme des Befehls SET LISTBOX COLUMN WIDTH (gilt für Objekte, Spalten und Kopfteile) und der Funktion Get listbox column width (gilt nur für Spalten und Kopfteile).

• Nur die Farbe für Spaltentitel lassen sich über die Befehle SET COLOR und SET RGB COLORS verändern.

Sie können eine Objektmethode einem Objekt bzw. einer Spalte der Listbox hinzufügen. Objektmethoden werden in folgender Reihenfolge aufgerufen:

1. Objektmethode jeder Spalte

2. Objektmethode der Listbox

Die Objektmethode der Spalte erhält Ereignisse, die im Kopfteil eintreten

Verwenden Sie den Befehl SET VISIBLE mit einem Spaltentitel, gilt er für alle Titel der Listbox , unabhängig vom Titel, der im Befehl übergeben wurde. So blendet die Anweisung SET VISIBLE(*;"header3";False) alle Spaltentitel im Objekt Listbox aus, zu denen „header3" gehört und nicht allein diesen Titel.

Die Funktion Self aus dem Kapitel "Programmiersprache" lässt sich in der Objektmethode einer Listbox bzw. einer Spalte der Listbox verwenden. In beiden Fällen gibt sie – je nachdem wo der Klick aufgetreten ist – einen Zeiger auf die Variable der Spalte oder des Spaltentitels zurück.

Die Funktion Focus Object gibt einen Zeiger auf die Spalte in der Listbox mit Fokus zurück (z.B. gegen ein Array). Über den Zeiger können Sie die Eintragsnummer des geänderten Array sehen. Nehmen wir an, der Benutzer hat die 5. Zeile in Spalte Sp2 geändert:

   $Column:= Focus Object
      ` $Column enthält einen Zeiger auf Sp2
   $Row:= $Column->   `$Row equals 5

Der Befehl SCROLL LINES (Kapitel "Benutzeroberfläche") lässt sich mit einer Listbox verwenden. Er scrollt in den Zeilen, so dass die erste gewählte oder angegebene Zeile angezeigt wird.

Mit dem Befehl EDIT ITEM im Kapitel "Eingabekontrolle" der 4D Programmiersprache können Sie eine Zelle des Objekts Listbox in den Bearbeitungsmodus setzen.

Es gibt spezifische Formularereignisse zum Verwalten von Listboxen, insbesondere für Drag&Drop und Sortieroperationen. Weitere Informationen dazu finden Sie in der Beschreibung zur Funktion Form event.

Bei Anklicken des Spaltentitels führt die Listbox automatisch eine Standardsortierung der Spalten durch. Das ist die alphanumerische Sortierung der Spaltenwerte in aufsteigender bzw. absteigender Reihenfolge durch mehrfache Klicks. Alle Spalten werden automatisch miteinander synchronisiert. Wollen Sie diese Standardsortierung unterbinden, deaktivieren Sie die Eigenschaft "Sortierbar" für die Listbox.

Der Entwickler kann über den Befehl SORT LISTBOX COLUMNS bzw. durch Kombinieren der Formularereignisse On Header Click und On After Sort und 4D Befehlen zur Array-Verwaltung eigene Sortierungen einrichten. Weitere Informationen dazu finden Sie unter der Funktion Form event.

Hinweis: Die Spalteneigenschaft „Sortierbar" gilt nur für Standardsortierungen des Benutzers. Der Befehl SORT LISTBOX COLUMNS berücksichtigt diese Eigenschaft nicht.

Über den Wert der Variablen für den Spaltentitel können Sie zusätzliche Information verwalten: die aktuelle Sortierung der Spalte im Lesemodus und die Anzeige des Sortierpfeils.

• Hat die Variable den Wert 0 (Null), wird die Spalte nicht sortiert, es erscheint kein Sortierpfeil;

• Hat die Variable den Wert 1, wird die Spalte in aufsteigender Reihenfolge sortiert, der Sortierpfeil erscheint;

• Hat die Variable den Wert 2, wird die Spalte in absteigender Reihenfolge sortiert, der Sortierpfeil erscheint.

Sie können den Wert der Variablen setzen, damit der Sortierpfeil angezeigt wird, z.B. Header2:=2. In diesem Fall wird die Spaltensortierung selbst nicht geändert; es ist Aufgabe des Entwicklers, das zu verwalten.

Über den Befehl SELECT LISTBOX ROW können Sie per Programmierung eine oder mehrere Zeilen in der Listbox wählen.

Diese Variable ist ein Array vom Typ Boolean, die 4th Dimension automatisch erstellt und pflegt . Die Größe des Array richtet sich nach der Größe der Listbox: Sie enthält dieselbe Anzahl Elemente wie das kleinste mit Spalten verknüpfte Array.

Jedes Element des Array gibt Wahr zurück, wenn die entsprechende Zeile gewählt ist, sonst Falsch. 4th Dimension aktualisiert den Inhalt dieses Array gemäß den Benutzeraktionen. Umgekehrt können Sie den Wert von Elementen im Array verändern, um die Auswahl in der Listbox zu ändern.

Dagegen können Sie in diesem Array weder Zeilen einfügen, überschreiben noch löschen.

Hinweis: Über die Funktion Count in array finden Sie die Anzahl der gewählten Zeilen.

Mit der folgenden Methode können Sie die Auswahl der ersten Zeile in der Listbox invertieren:

      ` tBListBox ist der Name der Listbox Variablen
   If (tBListBox{1} = True)
      tBListBox{1}:= False
   Else
      tBListBox{1}:= True
   End if