Freigeben über


ListBox-Objekt (Outlook Forms Script)

Zeigt eine Liste mit Werten an und ermöglicht die Auswahl von einem oder mehreren Werten.

Hinweise

Wenn das Listenfeld-Steuerelement ( ListBox) an eine Datenquelle gebunden ist, speichert das ListBox-Objekt den ausgewählten Wert in dieser Datenquelle.

Das ListBox-Steuerelement kann als Liste oder als Gruppe von OptionButton - oder CheckBox -Steuerelementen angezeigt werden.

Die Standardeigenschaft für ein Listenfeld-Steuerelement ( ListBox) ist die Value -Eigenschaft.

Das Standardereignis für ein Listenfeld-Steuerelement ( ListBox) ist das Click -Ereignis.

Es ist nicht möglich, Text in ein Dropdown-Listenfeld ( ListBox-Objekt) einzugeben.

Listenfeld-Formatvorlagen

Sie können zwischen zwei Präsentationsformaten für ein ListBox-Objekt auswählen. Dies wird durch die ListStyle -Eigenschaft ausgedrückt. Jedes Format bietet unterschiedliche Möglichkeiten, um Elemente aus der Liste auszuwählen.

If the style is 0, each item is on a separate row; the user selects an item by highlighting one or more rows.

If the style is 1, an OptionButton or CheckBox appears at the beginning of each row. With this style, the user selects an item by clicking the option button or check box. Check boxes appear only when the MultiSelect property is True.

Ereignisse

Name Beschreibung
Click Tritt auf, wenn der Benutzer einen Wert für das Steuerelement, für das mehrere Werte verfügbar sind, definitiv auswählt.

Methoden

Name Beschreibung
AddItem Bei einem einspaltigen Listenfeld-Steuerelement ( ListBox ) wird mit der AddItem-Methode der Liste ein Element hinzugefügt. Bei einem mehrspaltigen ListBox-Objekt wird der Liste mit dieser Methode eine Zeile hinzugefügt.
Clear Entfernt alle Einträge aus der Liste in einem ListBox -Objekt.
RemoveItem Entfernt eine Zeile aus der Liste in einem ListBox-Objekt.

Eigenschaften

Name Beschreibung
BackColor Dient zum Zurückgeben oder Festlegen eines Werts vom Typ Long, der die Hintergrundfarbe des Objekts angibt. Lese-/Schreibzugriff.
BorderColor Dient zum Zurückgeben oder Festlegen eines Werts vom Typ Long, der die Rahmenfarbe eines Objekts angibt. Lese-/Schreibzugriff.
BorderStyle Dient zum Zurückgeben oder Festlegen eines Werts vom Typ Integer, der den Rahmentyp des Steuerelements angibt. Lese-/Schreibzugriff.
BoundColumn Dient zum Zurückgeben oder Festlegen eines Werts vom Typ Variant, der die Datenquelle in einem mehrspaltigen ListBox -Objekt angibt. Lese-/Schreibzugriff.
Spalte Dient zum Zurückgeben oder Festlegen eines Werts vom Typ Variant, der einzelne Werte, Spalten mit Werten oder zweidimensionale Arrays darstellt, die in ein ListBox -Objekt geladen werden sollen. Lese-/Schreibzugriff.
ColumnCount Dient zum Zurückgeben oder Festlegen eines Werts vom Typ Long, der die Anzahl von Spalten darstellt, die in einem Listenfeld angezeigt werden. Lese-/Schreibzugriff.
ColumnHeads Dient zum Zurückgeben oder Festlegen eines Werts vom Typ Boolean, der angibt, ob eine einzelne Zeile mit Spaltenüberschriften angezeigt wird. Lese-/Schreibzugriff.
ColumnWidths Dient zum Zurückgeben oder Festlegen eines Werts vom Typ String, der die Breite der einzelnen Spalten in einem mehrspaltigen ListBox -Objekt angibt. Lese-/Schreibzugriff.
Enabled Dient zum Zurückgeben oder Festlegen eines Werts vom Typ Boolean, der angibt, ob ein Steuerelement den Fokus erhalten und auf benutzerseitig generierte Ereignisse reagieren kann. Lese-/Schreibzugriff.
ForeColor Dient zum Zurückgeben oder Festlegen eines Werts vom Typ Long, der die Vordergrundfarbe eines Objekts angibt. Lese-/Schreibzugriff.
IMEMode Dient zum Zurückgeben oder Festlegen eines Werts vom Typ Integer, der den standardmäßigen Laufzeitmodus des Eingabemethoden-Editors (IME) für ein Steuerelement angibt. Lese-/Schreibzugriff.
IntegralHeight Dient zum Zurückgeben oder Festlegen eines Werts vom Typ Boolean, der angibt, ob ListBox Textzeilen in einer Liste vollständig oder teilweise anzeigt. Lese-/Schreibzugriff.
List Gibt einen Variant-Wert zurück, der den angegebenen Eintrag in einem ListBox-Objekt darstellt, oder legt diesen Wert fest. Lese-/Schreibzugriff.
ListCount Gibt einen Wert vom Typ Long zurück, der die Anzahl der Listeneinträge in einem Steuerelement darstellt. Schreibgeschützt.
ListIndex Dient zum Zurückgeben oder Festlegen eines Werts vom Typ Variant, der das derzeit ausgewählte Element in einem ListBox -Objekt darstellt. Lese-/Schreibzugriff.
ListStyle Dient zum Zurückgeben oder Festlegen eines Werts vom Typ Integer, der die visuelle Darstellung der Liste in einem ListBox-Objekt angibt. Lese-/Schreibzugriff.
Locked Dient zum Zurückgeben oder Festlegen eines Werts vom Typ Boolean, der angibt, ob ein Steuerelement bearbeitet werden kann. Lese-/Schreibzugriff.
MatchEntry Dient zum Zurückgeben oder Festlegen eines Werts vom Typ Integer, der angibt, wie ein ListBox -Objekt während einer Benutzereingabe seine Liste durchsucht. Lese-/Schreibzugriff.
MouseIcon Gibt einen Wert vom Typ String zurück, der den vollständigen Pfad eines benutzerdefinierten Symbols angibt, das dem Steuerelement zugewiesen wird. Schreibgeschützt.
MousePointer Dient zum Zurückgeben oder Festlegen eines Werts vom Typ Integer, der den Zeigertyp angibt, der angezeigt wird, wenn der Benutzer die Maus über einem bestimmten Objekt positioniert. Lese-/Schreibzugriff.
MultiSelect Dient zum Zurückgeben oder Festlegen eines Werts vom Typ Integer, der angibt, ob das Objekt eine Mehrfachauswahl zulässt. Lese-/Schreibzugriff.
Selected Dient zum Zurückgeben oder Festlegen eines Werts vom Typ Boolean, der den Auswahlstatus von Elementen in einem ListBox -Objekt angibt. Lese-/Schreibzugriff.
SpecialEffect Dient zum Zurückgeben oder Festlegen eines Werts vom Typ Integer, der die grafische Darstellungsweise eines Objekts angibt. Lese-/Schreibzugriff.
Text Dient zum Zurückgeben oder Festlegen eines Werts vom Typ String, der Text in einem ListBox -Objekt angibt, wobei die markierte Zeile im Steuerelement geändert wird. Lese-/Schreibzugriff.
TextAlign Dient zum Zurückgeben oder Festlegen eines Werts vom Typ Integer, der angibt, wie Text in einem Steuerelement ausgerichtet ist. Lese-/Schreibzugriff.
TextColumn Dient zum Zurückgeben oder Festlegen eines Werts vom Typ Variant, der die Spalte in einem ListBox -Objekt identifiziert, die dem Benutzer angezeigt werden soll. Lese-/Schreibzugriff.
TopIndex Dient zum Zurückgeben oder Festlegen eines Werts vom Typ Long, der den Index des Listenelements darstellt, das ganz oben in der Liste angezeigt wird. Lese-/Schreibzugriff.
Wert Dient zum Zurückgeben oder Festlegen eines Werts vom Typ Variant, der den Wert im BoundColumn -Objekt für die derzeit markierten Zeilen angibt. Lese-/Schreibzugriff.

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.