GET LIST ITEM

Version 2004 (Geändert)

GET LIST ITEM (Liste; EintragPos  | *; EintragRef; EintragText{; Unterliste{; Erweitert}})

EintragText	String		Text des Listeneintrags
Unterliste	ListenRef		Referenznummer der Unterliste
			(sofern vorhanden)
Erweitert	Boolean		Ist eine >Unterliste zugeordnet:
			TRUE = Unterliste ist gerade erweitert
			FALSE = Unterliste ist gerade geschlossen

Der Befehl GET LIST ITEM gibt Informationen zum Eintrag angegeben in EintragPos in der Liste mit der Referenznummer übergeben in Liste.

Die Position richtet sich nach dem aktuellen Status erweitert/geschlossen der Liste und den dazugehörigen Unterlisten. Die Position muss zwischen 1 und dem von Count list items zurückgebenen Wert liegen. Liegt er außerhalb dieses Bereichs, gibt GET LIST ITEM leere Werte zurück, also 0 (Null), "", o.ä..

Nach dem Aufruf finden Sie:

• In EintragRef die Referenznummer des Eintrags.

• In EintragText den Text des Eintrags.

Mit den optionalen Parametern Unterliste und Erweitert:

• Gibt Unterliste die Referenznummer der zugeordneten Unterliste zurück. Hat der Eintrag keine Unterliste, gibt Unterliste Null (0) zurück.

• Hat der Eintrag eine Unterliste, gibt Erweitert TRUE zurück, wenn sie erweitert ist, FALSE, wenn sie geschlossen ist.

(1) hList hat Einträge mit einmaligen Referenznummern. Folgender Code wechselt per Programmierung den Status erweitert/geschlossen der Unterliste, sofern sie vorhanden ist und dem aktuell ausgewählten Eintrag zugeordnet wurde:

   $vlItemPos:=Selected list items(hList)
   If ($vlItemPos>0)
      GET LIST ITEM(hList;$vlItemPos;$vlItemRef;$vsItemText;$hSublist;$vbExpanded)
      If (Is a list($hSublist))
         SET LIST ITEM(hList;$vlItemRef;$vsItemText;$vlItemRef;
                                             $hSublist;Not($vbExpanded))
         REDRAW LIST(hList)
      End if 
   End if 

(2) Siehe Beispiel zum Befehl APPEND TO LIST.

GET LIST ITEM PROPERTIES, List item parent, List item position, Selected list items, SET LIST ITEM, SET LIST ITEM PROPERTIES.

Anwendung des Befehls

Open 4D Preferences, Using Hierarchical Lists, XSLT Office 2003

---