VBA-Programmierung in Microsoft Excel

Tutorial: Die Dialoge

Text-Eigenschaft

Gibt den Text in einem Textfeld-Steuerelement (TextBox) zurück oder legt den Text fest. Ändert die ausgewählte Zeile in einem Kombinationsfeld-Steuerelement (ComboBox) oder in einem Listenfeld-Steuerelement (ListBox).

Syntax

object.Text [= String]

Die Syntax für die Text-Eigenschaft besteht aus folgenden Teilen:

Teil Beschreibung
object Erforderlich. Ein gültiges Objekt.
String Optional. Ein Zeichenfolgenausdruck, der Text angibt. Der Standardwert ist eine Null-Zeichenfolge ("").

Hinweise

Bei einem Textfeld-Steuerelement wird jeder Wert, den Sie der Text-Eigenschaft zuweisen, auch der Value-Eigenschaft zugewiesen.

Bei einem Kombinationsfeld-Steuerelement können Sie die Text-Eigenschaft verwenden, um die Werte des Steuerelements zu aktualisieren. Wenn der Wert der Text-Eigenschaft mit einem vorhandenen Listeneintrag übereinstimmt, wird der Wert der ListIndex-Eigenschaft (der Index der aktuellen Zeile) auf die Zeile gesetzt, die mit der Text-Eigenschaft übereinstimmt. Wenn der Wert der Text-Eigenschaft mit keiner Zeile übereinstimmt, wird der Wert der ListIndex-Eigenschaft auf -1 gesetzt.

Bei einem Listenfeld-Steuerelement muss der Wert der Text-Eigenschaft mit einem vorhandenen Listeneintrag übereinstimmen. Die Angabe eines Wertes, der mit keinem Listeneintrag übereinstimmt, verursacht einen Fehler.

Die Text-Eigenschaft kann nicht verwendet werden, um den Wert einer Eingabe in ein Kombinationsfeld-Steuerelement oder Listenfeld-Steuerelement zu ändern. Verwenden Sie für diesen Zweck die Column- oder die List-Eigenschaft.

Die ForeColor-Eigenschaft bestimmt die Textfarbe.