SELECT LIST ITEMS BY POSITION

Version 2004 (Geändert)

SELECT LIST ITEMS BY POSITION (Liste; EintragPos{; PosArray})

Der Befehl SELECT LIST ITEMS BY POSITION wählt den Eintrag mit der in EintragPos übergebenen Position und optional in PosArray in der Liste mit der in Liste übergebenen Referenznummer.

Die Position der Einträge richtet sich immer nach dem aktuellen Status geschlossen/erweitert der Liste und der dazugehörigen Unterlisten. Sie übergeben einen Wert zwischen 1 und dem von Count list items zurückgegebenen Wert. Liegt der Wert außerhalb dieses Bereichs, wird kein Eintrag ausgewählt.

Übergeben Sie den Parameter PosArray nicht, enthält EintragPos die Position des auszuwählenden Eintrags.

Mit dem optionalen Parameter PosArray können Sie in Liste mehrere Einträge gleichzeitig auswählen. In PosArray müssen Sie ein Array übergeben, in dem jede Zeile die Position eines auszuwählenden Eintrags angibt.

Mit diesem Parameter setzt der in EintragPos definierte Eintrag den neuen aktuellen Eintrag der Liste in die Auswahl im Ergebnis. Er gehört nicht zwingend zum Satz Einträge, definiert durch das Array. Der aktuelle Eintrag ist vielmehr der, welcher bei Verwendung des Befehls EDIT ITEM bearbeitet wird.

Hinweis: Damit Sie mehrere Einträge gleichzeitig – manuell oder per Programmierung – in einer hierarchischen Liste auswählen können, muss für die Liste die Eigenschaft MultiSelections aktiviert sein. Sie wird über den Befehl SET LIST PROPERTIES gesetzt.

In der Benutzerumgebung gibt es die hierarchische Liste hList:

Nach Ausführung des Code:

   SELECT LIST ITEMS BY POSITION(hList;Count list items(hList))
   REDRAW LIST(hList) 
      ` Vergessen Sie nicht, REDRAW LIST aufzurufen, damit die Liste aktualisiert wird 

wird der letzte sichtbare Eintrag aufgerufen:

(2) Nach Ausführung des Code:

   SET LIST PROPERTIES(hList,0;0;18;0;1)   
      ` Übergeben Sie 1 als letzten Parameter, damit  mehrfache Auswahlen möglich sind.
   SELECT LIST ITEMS BY POSITION(hList;3;$arr)
      ` Der 3. Eintrag wird als aktueller Eintrag bestimmt 
   REDRAW LIST(hList) 
      

SELECT LIST ITEMS BY REFERENCE, Selected list items.

Anwendung des Befehls

Open 4D Preferences, XML hierarchische Listen

---