Selected-Eigenschaft
Gibt den Auswahlstatus von Elementen in einem ListBox-Objekt zurück oder legt den Auswahlstatus fest.
Syntax
-Objekt.Selected(index) [= Boolean ]
Die Syntax der Selected-Eigenschaft enthält die folgenden Bestandteile:
| Bestandteil | 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. |
Einstellungen
Die Einstellungen für Boolean sind:
| Wert | Beschreibung |
|---|---|
| True | Das Element ist ausgewählt. |
| False | Das Element ist nicht ausgewählt. |
Hinweise
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.