Auf Englisch lesen

Freigeben über


TextBox-Objekt (Outlook Forms Script)

Zeigt Informationen eines Benutzers oder einer Datengruppe an.

Hinweise

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.