Selected-Eigenschaft

  • Artikel

Gibt den Auswahlstatus von Elementen in einem ListBox-Objekt zurück oder legt diese fest.

Syntax

-Objekt.Selected(index) [= Boolean ]

Die Syntax der Selected-Eigenschaft enthält die folgenden Bestandteile:

Teil Beschreibung
Objekt Erforderlich. Ein gültiges Objekt.
Index Erforderlich. Eine ganze Zahl im Bereich zwischen 0 und der Zahl, die sich aus der Anzahl der Elemente in der Liste minus 1 berechnet.
Boolean Optional. Gibt an, ob ein Element ausgewählt ist.

Settings

Die Einstellungen für Boolean sind:

Wert Beschreibung
True Das Element ist ausgewählt.
False Das Element ist nicht ausgewählt.

HinwBemerkungeneise

Die Selected-Eigenschaft ist nützlich, wenn Benutzer eine Mehrfachauswahl treffen können. Verwenden Sie diese Eigenschaft, um die ausgewählten Zeilen in einem Listenfeld mit mehrfacher Auswahl zu bestimmen. Darüber hinaus können Sie die Eigenschaft verwenden, um Zeilen in einer Liste aus Code zu markieren oder die Markierung aufzuheben.

Der Standardwert für diese Eigenschaft basiert auf dem aktuellen Markierungsstatus des Listenfeld-Steuerelements ( ListBox).

Bei Einfachauswahl-Listenfeldern wird das Verwenden der Eigenschaften Value oder ListIndex für das Abrufen und Festlegen der Markierung empfohlen. In diesem Fall gibt ListIndex den Index des markierten Elements zurück. Bei Mehrfachauswahl-Listenfeldern gibt ListIndex jedoch den Index der Zeile zurück, die sich innerhalb des Fokus-Rechtecks befindet, unabhängig davon, ob die Zeile tatsächlich markiert ist.

Wenn die MultiSelect-Eigenschaft eines Listenfeld-Steuerelements auf None festgelegt wurde, kann die Selected-Eigenschaft nur für eine Zeile auf True festgelegt werden.

Wenn ein Wert eingegeben wird, der sich außerhalb des Indexbereichs befindet, wird keine Fehlermeldung generiert, es wird jedoch auch keine Eigenschaft für ein Element in der Liste festgelegt.

Siehe auch

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.