Freigeben über

ItemData-Eigenschaft

  • Artikel

Verweist mit Hilfe eines Indexes auf ein eindimensionales Array, das dieselbe Anzahl an Einträgen wie die Einstellung der List-Eigenschaft eines Kombinationsfeld- oder Listenfeld-Steuerelements enthält. Diese Eigenschaft steht Ihnen zur Entwurfszeit nicht zur Verfügung; zur Laufzeit besteht Lese-/Schreibzugriff.

Control.ItemData(nIndex)[ = nData]

Eigenschaftswerte

  • nIndex
    Gibt den Index des Elements an, das gespeichert oder abgerufen werden soll. nIndex entspricht der Anzeigereihenfolge der Elemente in der Liste.
  • nData
    Die Anzahl der zu speichernden oder in der ItemData-Liste abzurufenden Einträge.

Hinweise

Mit Hilfe der ItemData-Eigenschaft können Sie jeden Eintrag in einem Kombinations- oder Listenfeld mit einer bestimmten Zahl verbinden. Anschließend können Sie diese Zahlen im Code verwenden, um die Einträge in der Liste zu kennzeichnen. Mit Hilfe einer Kennung können z. B. die Namen der einzelnen Mitarbeiter/innen in einem Listenfeld gekennzeichnet werden. Beim Füllen des Listenfeldes füllen Sie auch die entsprechenden Elemente im ItemData-Array mit den Mitarbeiternummern aus.

Anmerkung   Beim Einfügen eines Eintrags in eine Liste mit Hilfe der AddItem-Methode wird automatisch auch ein Eintrag im ItemData-Array zugewiesen. Der Wert wird jedoch nicht initialisiert, sondern behält den Wert bei, der sich vor Hinzufügen des Eintrags in die Liste an dieser Position befand. Stellen Sie beim Verwenden der ItemData-Eigenschaft sicher, dass Sie den Wert für jedes Element festlegen, wenn Sie einer Liste neue Einträge hinzufügen. Beachten Sie außerdem, dass der Wert der ItemData-Eigenschaft nur für Kombinations- und Listenfelder mit weniger als 60 Einträgen korrekt ist.

Siehe auch

AddItem-Methode | ItemIDToIndex-Methode | List-Eigenschaft | ListItemID-Eigenschaft | NewItemID-Eigenschaft | RemoveItem-Methode | Selected-Eigenschaft | TopItemID-Eigenschaft

Betrifft: Kombinationsfeld-Steuerelement (ComboBox) | Listenfeld-Steuerelement (ListBox)