SET LIST ITEM PROPERTIES

Version 2004 (Geändert)

SET LIST ITEM PROPERTIES (Liste; EintragRef | *; Eingebbar; Stil; Icon{; Farbe})

Der Befehl SET LIST ITEM PROPERTIES ändert den Eintrag mit der in EintragRef übergebenen Referenznummer in der Liste mit der in Liste übergebenen Referenznummer.

Gibt es keinen Eintrag mit der übergebenen Referenznummer, hat der Befehl keine Auswirkung. Übergeben Sie in EintragRef den optionalen Parameter 0, können Sie mit APPEND TO LIST den zuletzt in der Liste angefügten Eintrag ändern.

Übergeben Sie in EintragRef den optionalen Parameter *, gilt der Befehl für den aktuellen Eintrag in der Liste. Wurden mehrere Einträge manuell ausgewählt, ist der zuletzt ausgewählte Eintrag der aktuelle. Wurde kein Eintrag ausgewählt, führt der Befehl nichts aus.

Arbeiten Sie mit Referenznummern, sollten diese einmalig sein, damit Sie die Einträge unterscheiden können. Weitere Informationen dazu finden Sie in der Beschreibung zum Befehl APPEND TO LIST.

Hinweis: Mit dem Befehl SET LIST ITEM können Sie den Text des Eintrags oder der dazugehörigen Unterlisten ändern.

Übergeben Sie in Eingebbar WAHR, ist der Eintrag eingebbar. Übergeben Sie FALSCH, ist er nicht eingebbar.

Wichtig: Eingebbare Einträge müssen zu einer eingebbaren Liste gehören. Der Befehl SET ENTERABLE macht eine ganze Liste eingebbar. Der Befehl SET LIST ITEM PROPERTIES macht einen einzelnen Eintrag der Liste eingebbar. Ändern Sie die Eigenschaft eingebbar für die Liste, hat das keine Auswirkung auf die Eigenschaft der einzelnen Einträge. Ein Eintrag kann jedoch nur eingebbar sein, wenn die dazugehörige Liste eingebbar ist.

Mit dem Parameter Stil legen Sie den Schriftstil des Eintrags fest. Übergeben Sie eine oder mehrere der folgenden vordefinierten Konstanten:

Hinweis: Unter Windows sind nur die Stilarten Plain oder eine Kombination aus Bold, Italic und Underline verfügbar. Die Stilarten Outline und Shadow werden nicht mehr unterstützt und nur aus Kompatibilitätsgründen noch beibehalten.

Wollen Sie einem Eintrag ein Icon zuordnen, übergeben Sie einen der nachfolgenden Werte vom Typ Zahl:

• N, wobei N die RessourcenID der Mac OS-basierten 'cicn' Ressource ist

• Use PICT resource+N, wobei N die RessourcenID der MacOS-basierten 'PICT' Ressource ist

• Use PicRef+N, wobei N die Referenznummer eines Bildes aus der Bildbibliothek der Designumgebung ist.

Übergeben Sie Null (0), wenn der Eintrag keine Grafik enthalten soll.

Hinweis: Use PICT resource und Use PicRef sind vordefinierte Konstanten unter dem Thema Hierarchische Listen.

Mit dem optionalen Parameter Farbe können Sie die Farbe eines Eintragstexts verändern. Sie muss als RGB-Farbe angegeben werden, z.B. eine Lange Ganzzahl mit 4-Byte im Format 0x00RRGGBB. Weitere Informationen dazu finden Sie in der Beschreibung zum Befehl SET RGB COLORS. Übergeben Sie -1 in Farbe, erscheint wieder die Orginalfarbe des Eintrags.

(1) Siehe Beispiel zum Befehl APPEND TO LIST.

(2) Das folgende Beispiel setzt den Schriftstil des aktuellen Eintrags von Liste in Fett und Hellrot.

   SET LIST ITEM PROPERTIES(List;*;True;Bold;0;0x00FF0000)
   REDRAW LIST(hList) 

GET LIST ITEM PROPERTIES, SET LIST ITEM.

Anwendung des Befehls

Display Icons in a Hierarchical List, Hierarchical List in 2004, HierarchicalLists, XML hierarchische Listen

---