TextBox-Objekt (Outlook Forms-Skript)

Zeigt Informationen eines Benutzers oder einer Datengruppe an.

HinwBemerkungeneise

Ein Textfeld (TextBox-Objekt) ist das am häufigsten verwendete Steuerelement für die Anzeige der von einem Benutzer eingegebenen Informationen. Es kann auch zur Anzeige von Datengruppen wie Tabellen, Abfragen, Arbeitsblättern oder Ergebnissen von Berechnungen verwendet werden. Wenn ein TextBox-Element an eine Datenquelle gebunden ist, ändert sich beim Ändern des Inhalts des TextBox-Elements auch der Wert der gebundenen Datenquelle.

Auf Text in einem TextBox-Objekt angewendete Formatierungen betreffen den gesamten Text des Steuerelements. Wenn Sie beispielsweise die Schriftart oder die Schriftgröße eines Steuerelementzeichens ändern, wirkt sich diese Änderung auf alle Zeichen des Steuerelements aus.

Die Standardeigenschaft für ein Textfeld-Steuerelement ( TextBox) ist die Value -Eigenschaft.

Tipps zur Verwendung von Textfeldern

Das TextBox-Objekt ist ein flexibles Steuerelement, das von folgenden Eigenschaften bestimmt wird: Text, MultiLine, WordWrap und AutoSize.

Text enthält den Text, der im Textfeld angezeigt wird.

MultiLine steuert, ob das TextBox-Objekt Text ein- oder mehrzeilig anzeigen kann. Neue-Zeile-Zeichen bestimmen, wo eine Zeile endet und eine neue beginnt. Wenn MultiLine auf False (Standardwert) festgelegt ist, wird der Text nicht umgebrochen, sondern abgeschnitten.

WordWrap ermöglicht es für das TextBox-Objekt, dass Zeilen, die länger als die Breite des TextBox-Objekts sind, in kürzere Zeilen mit einer passenden Zeilenlänge umgebrochen werden. Der Standardwert ist True.

Wenn Sie WordWrap nicht verwenden, startet das TextBox-Objekt eine neue Textzeile, wenn im Text ein Zeilenvorschubzeichen angezeigt wird. Wenn WordWrap deaktiviert ist, können Textzeilen vorhanden sein, die nicht vollständig in das Textfeld passen. Das Textfeld zeigt die Textabschnitte an, die in seine Breite passen, und schneidet die Teile des Texts ab, die nicht passen. WordWrap ist nur aktiv, wenn MultiLine auf True festgelegt ist.

AutoSize steuert, ob das TextBox-Objekt angepasst wird, um den gesamten Text anzuzeigen. Wenn AutoSize für ein TextBox-Objekt angewendet wird, wird die Breite des TextBox-Objekts entsprechend dem Text im TextBox-Objekt und der verwendeten Schriftgröße zur Anzeige des Texts verkleinert oder vergrößert. Der Standardwert ist False.

AutoSize eignet sich für folgende Situationen:

• Anzeigen eines Titels mit einer oder mehreren Zeilen.

• Anzeigen des Inhalts eines einzeiligen TextBox-Objekts.

• Anzeigen des Inhalts eines mehrzeiligen TextBox-Objekts, das für den Benutzer schreibgeschützt ist.

AutoSize sollte nicht auf ein leeres TextBox-Objekt angewendet werden, das auch die Eigenschaften MultiLine und WordWrap verwendet. Wenn der Benutzer Text in ein TextBox-Objekt mit diesen Eigenschaften eingibt, wird die Größe des TextBox-Objekts automatisch auf ein langes schmales Feld mit der Breite eines Buchstabens und der Länge der Textzeile angepasst.

Methoden

Name	Beschreibung
Copy	Kopiert den Inhalt eines Objekts in die Zwischenablage.
Cut	Entfernt markierte Informationen aus einem Objekt und speichert diese in der Zwischenablage.
Paste	Fügt den Inhalt der Zwischenablage in ein Objekt ein.

Eigenschaften

Name	Beschreibung
AutoSize	Dient zum Zurückgeben oder Festlegen eines Werts vom Typ Boolean, der angibt, ob die Größe eines Objekts automatisch geändert wird, damit der gesamte Inhalt angezeigt wird. Lese-/Schreibzugriff.
AutoTab	Gibt einen Wert vom Typ Boolean zurück, der angibt, ob eine automatische Registerkarte auftritt, wenn ein Benutzer die maximal zulässige Anzahl von Zeichen in ein TextBox-Objekt eingibt, oder legt diesen Wert fest. Lese-/Schreibzugriff.
AutoWordSelect	Dient zum Zurückgeben oder Festlegen eines Werts vom Typ Boolean, mit dem angegeben wird, ob ein Wort oder ein Zeichen die Grundeinheit für die Erweiterung einer Auswahl darstellt. Lese-/Schreibzugriff.
BackColor	Dient zum Zurückgeben oder Festlegen eines Werts vom Typ Long, der die Hintergrundfarbe des Objekts angibt. Lese-/Schreibzugriff.
BackStyle	Dient zum Zurückgeben oder Festlegen eines Werts vom Typ Integer, der das Hintergrundformat eines 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.
CanPaste	Gibt einen Wert vom Typ Boolean zurück, der angibt, ob die Zwischenablage Daten enthält, die vom Objekt unterstützt werden. Schreibgeschützt.
CurLine	Dient zum Zurückgeben oder Festlegen eines Werts vom Typ Long, der die aktuelle Linie eines Steuerelements darstellt. Lese-/Schreibzugriff.
CurTargetX	Gibt einen Wert vom Typ Long zurück, der die bevorzugte horizontale Position der Einfügemarke in einem mehrzeiligen TextBox -Objekt darstellt. Schreibgeschützt.
CurX	Dient zum Zurückgeben oder Festlegen eines Werts vom Typ Long, der die aktuelle horizontale Position der Einfügemarke in einem mehrzeiligen TextBox -Objekt darstellt. Lese-/Schreibzugriff.
DragBehavior	Returns or sets an Integer that specifies whether the system enables the drag-and-drop feature for the control. 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.
EnterFieldBehavior	Dient zum Zurückgeben oder Festlegen eines Werts vom Typ Integer, der das Auswahlverhalten eines TextBox -Objekts angibt, wenn es den Fokus erhält. Lese-/Schreibzugriff.
EnterKeyBehavior	Gibt einen Wert vom Typ Boolean zurück, der die Auswirkung des Drückens der EINGABETASTE in einem TextBox-Objekt definiert, oder legt diesen Wert fest. Lese-/Schreibzugriff.
ForeColor	Dient zum Zurückgeben oder Festlegen eines Werts vom Typ Long, der die Vordergrundfarbe eines Objekts angibt. Lese-/Schreibzugriff.
HideSelection	Dient zum Zurückgeben oder Festlegen eines Werts vom Typ Boolean, der angibt, ob der markierte Text weiterhin markiert bleibt, wenn ein Steuerelement den Fokus verliert. 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 TextBox Textzeilen vollständig oder teilweise anzeigt. Lese-/Schreibzugriff.
LineCount	Gibt einen Wert vom Typ Long zurück, der die Anzahl der Textzeilen in einem TextBox -Objekt angibt. Schreibgeschützt.
Locked	Dient zum Zurückgeben oder Festlegen eines Werts vom Typ Boolean, der angibt, ob ein Steuerelement bearbeitet werden kann. Lese-/Schreibzugriff.
MaxLength	Gibt einen Wert vom Typ Long zurück, der die maximale Anzahl von Zeichen angibt, die ein Benutzer in ein TextBox-Objekt eingeben kann, oder legt diesen Wert fest. 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.
MultiLine	Gibt einen Wert vom Typ Boolean zurück oder legt ihn fest, mit dem angegeben wird, ob ein Steuerelement mehrere Textzeilen akzeptieren und anzeigen kann. Lese-/Schreibzugriff.
PasswordChar	Dient zum Zurückgeben oder Festlegen eines Werts vom Typ String, der ein Platzhalterzeichen angibt, das anstelle der eigentlich in das TextBox -Objekt eingegebenen Zeichen angezeigt wird. Lese-/Schreibzugriff.
ScrollBars	Dient zum Zurückgeben oder Festlegen eines Werts vom Typ Integer, der angibt, ob ein Steuerelement über vertikale Bildlaufleisten, über horizontale Bildlaufleisten oder über beide Arten von Bildlaufleisten verfügt. Lese-/Schreibzugriff.
SelectionMargin	Gibt einen Wert vom Typ Boolean zurück oder legt ihn fest, mit dem angegeben wird, ob der Benutzer eine Textzeile markieren kann, indem er auf den Bereich links des Texts klickt. Lese-/Schreibzugriff.
SelLength	Gibt einen Wert vom Typ Long zurück, der die Anzahl der in einem TextBox-Objekt ausgewählten Zeichen darstellt, oder legt diesen Wert fest. Lese-/Schreibzugriff.
SelStart	Dient zum Zurückgeben oder Festlegen eines Werts vom Typ Long, der den Anfangspunkt des markierten Texts darstellt oder die Einfügemarke, wenn kein Text markiert ist. Lese-/Schreibzugriff.
SelText	Dient zum Zurückgeben oder Festlegen eines Werts vom Typ String, der den markierten Text in einem Steuerelement darstellt. Lese-/Schreibzugriff.
SpecialEffect	Dient zum Zurückgeben oder Festlegen eines Werts vom Typ Integer, der die grafische Darstellungsweise eines Objekts angibt. Lese-/Schreibzugriff.
TabKeyBehavior	Dient zum Zurückgeben oder Festlegen eines Werts vom Typ Boolean, der angibt, ob Registerkarten im Bearbeitungsbereich zulässig sind. Lese-/Schreibzugriff.
Text	Dient zum Zurückgeben oder Festlegen eines Werts vom Typ String, der Text im Steuerelement angibt. 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.
TextLength	Gibt einen Wert vom Typ Long zurück, der die Länge des Texts im Bearbeitungsbereich eines TextBox-Objekts in Anzahl von Zeichen darstellt. Schreibgeschützt.
Wert	Dient zum Zurückgeben oder Festlegen eines Werts vom Typ Variant, der Text im Bearbeitungsbereich angibt. Lese-/Schreibzugriff.
WordWrap	Dient zum Zurückgeben oder Festlegen eines Werts vom Typ Boolean, der angibt, ob für den Inhalt eines Steuerelements ein automatischer Zeilenumbruch eingefügt wird und ob das Steuerelement vergrößert wird, damit der gesamte Text hineinpasst. 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.