Formatierungstipps für das "TextBox"-Steuerelement

TextBox-Steuerelemente können verwendet werden, um Benutzereingaben aufzunehmen oder Text anzuzeigen. Generell werden diese Elemente für editierbaren Text verwendet, können aber auch schreibgeschützt festegelegt werden. TextBox-Objekte können mehrere Zeilen anzeigen und den Text auf die Größe des Steuerelements umbrechen.

Wie alle Steuerelemente können TextBox-Steuerelemente geändert werden, um dem Element ein Aussehen zu verleihen, das vom Design des Standardelements abweicht. Das Standarddesign des TextBox-Elements sieht folgendermaßen aus:

Wichtige TextBox-Steuerelementeigenschaften

Das TextBox-Steuerelement ist ein Textsteuerelement. Sie können also Text im TextBox-Steuerelement anzeigen, indem Sie die Text-Eigenschaft unter Allgemeine Eigenschaften im Eigenschaftenpanel festlegen.

Sie können das TextBox-Steuerelement schreibschützen, indem Sie die IsReadOnly-Eigenschaft festlegen.

Sie können zulassen, dass Benutzer dem eingegebenen Text Zeilenumbruchszeichen hinzufügen, indem der Benutzer die AcceptsReturn-Eigenschaft auswählt. In diesem Fall möchten Sie unter Umständen die Schiebeleisten aktivieren. Das erreichen Sie, indem Sie die HorizontalScrollBarVisibility- und die VerticalScrollBarVisibility-Eigenschaft festlegen.

Um Schriftart, Schriftgrad, Schriftfamilie usw. anzugeben, legen Sie im Eigenschaftenpanel unter Text die Eigenschaften fest. Sie können dem Projekt auch benutzerdefinierte Schriftarten hinzufügen und diese Schriftarten in den Textsteuerelementen anwenden.

Weitere Informationen finden Sie unter Zeichnen von Text.

Sie können diese Eigenschaften folgendermaßen festlegen:

• Legen Sie die Eigenschaften des Objekts fest   Nachdem Sie ein TextBox-Objekt auf die Zeichenfläche gezeichnet haben, können Sie die Eigenschaften des Objekts unmittelbar festlegen. Wenn Sie für mehrere TextBox-Objekte denselben Wert verwenden möchten, setzen Sie diese Eigenschaften in einem Stil fest.

• Legen Sie die Eigenschaften in einem Stil fest   Wenn Sie diese Eigenschaften im Stil des TextBox-Objekts festlegen , verwendet jedes TextBox-Objekt, das diesen Stil verwendet, diese Werte standardmäßig. Sie können die Werte für ein bestimmtes Objekt überschreiben.

  Weitere Informationen finden Sie unter Erstellen einer Formatvorlage.

Teile der TextBox-Vorlage

TextBox-Steuerelemente verwenden eine Vorlage, die die Darstellung dieser Elemente definiert: die TextBox-Vorlage Jeder einzelne Teil der Vorlage übernimmt eine bestimmte Rolle hinsichtlich der Darstellung und des Verhaltens des TextBox-Objekts, auf das die Vorlage angewendet wird.

Es können andere Objekte in der Vorlage enthalten sein, um die Darstellung des TextBox-Steuerelements optisch aufzubessern. Allerdings ist das Verhalten des Teils, das in der folgenden Tabelle aufgeführt wird, an einen Vertrag gebunden.

Wenn Sie die Teile der Vorlage anzeigen möchten, öffnen Sie das Teilepanel während der Bearbeitung der Vorlage. Im Panel Objekte und Zeitachsen wird neben einem Objekt, das die Rolle eines Teils im Teilepanel übernimmt, ein Symbol  angezeigt.

Teilename	Objekttyp	Beschreibung
ContentElement	FrameworkElement	Objekt, das Text anzeigt. Dieses Teil ist obligatorisch.

Die anderen Objekte in der TextBox-Vorlage werden verwendet, um die Darstellung des TextBox-Steuerelements in verschiedenen Status zu ändern.

Status des TextBox-Steuerelements

Standardmäßig kann das TextBox-Steuerelement in der CommonStates-Statusgruppe einen der vier folgenden Status annehmen. Die Statusgruppe können Sie im Zuständepanel anzeigen, während Sie eine TextBox-Vorlage ändern:

Zustandsname	Beschreibung
Normal	Darstellung des TextBox-Steuerelements, wenn keine Interaktion mit dem Steuerelement besteht.
MouseOver	Darstellung des TextBox-Steuerelements, wenn der Benutzer den Zeiger auf das Steuerelement bewegt.
Pressed	Darstellung des TextBox-Steuerelements, wenn der Benutzer auf das Steuerelement klickt oder wenn das Steuerelement über einen Fokus verfügt und der Benutzer die EINGABE- oder LEERTASTE drückt.
Disabled	Darstellung des TextBox-Steuerelements, wenn die IsEnabled-Eigenschaft auf False festgelegt ist.

Das TextBox-Steuerelement kann einen der beiden folgenden Status der FocusStates-Statusgruppe annehmen:

Zustandsname	Beschreibung
Unfocused	Darstellung des TextBox-Steuerelements, wenn es über keinen Tastaturfokus verfügt.
Focused	Darstellung des TextBox-Steuerelements, wenn es über einen Tastaturfokus verfügt. So kann z. B. ein Benutzer die TAB-TASTE drücken, um die Objekte seiner Anwendung zu durchlaufen, bis sich der Tastaturfokus auf dem TextBox-Steuerelement befindet.

Das TextBox-Steuerelement kann einen der drei folgenden Status der ValidationStates-Statusgruppe annehmen:

Zustandsname	Beschreibung
Valid	Darstellung des TextBox-Steuerelements, wenn das Steuerelement gültig ist.
InvalidUnfocused	Darstellung des TextBox-Steuerelements, wenn das Steuerelement ungültig ist und über keinen Tastaturfokus verfügt.
InvalidFocused	Darstellung des TextBox-Steuerelements, wenn das Steuerelement ungültig ist und über einen Tastaturfokus verfügt.

Tipp:

Eine Statusgruppe enthält die visuellen Status, die Teil derselben logischen Kategorie sind und die nicht gleichzeitig angezeigt werden können. Beispiel: Die Gruppe CommonStates beinhaltet Zustände, die sich auf die Benutzerinteraktion mit einem Eingabegerät wie der Maus beziehen. In einer Statusgruppe kann immer nur ein Status angezeigt werden. Ein Status aus einer Gruppe kann jedoch gleichzeitig als Status in einer anderen Gruppe angezeigt werden.

Wenn Sie einen Status auswählen, wird die Statusaufzeichnung aktiviert und die vorgenommenen Änderungen für diesen Status werden aufgezeichnet. Um die Statusaufzeichnung zu deaktivieren, klicken Sie auf die Aufzeichnungsschaltfläche , oder wählen Sie Basis im Zuständepanel aus. Um die Darstellung des Steuerelements zu ändern, wenn zwei separate Status aktiv sind, können Sie in einer Statusgruppe eine Vorschau eines Status einpassen, während Sie in einer anderen Statusgruppe einen Status ändern.

So konvertieren Sie Objekte in TextBox-Steuerelemente

Führen Sie einen der folgenden Schritte aus, um die Vorlage eines TextBox-Steuerelements zu ändern:

• Zeichnen Sie eine TextBox  auf die Zeichenfläche, und erstellen Sie eine Kopie der Standardvorlage.

  Weitere Informationen finden Sie unter Erstellen oder Bearbeiten einer Vorlage.

• Entwerfen Sie ein TextBox-Steuerelement, indem Sie Objekte zeichnen oder Bilder importieren, und verwenden Sie dann den Befehl Steuerelement erstellen.

Wenn Sie den Befehl Steuerelement erstellen verwenden, führen Sie folgende Schritte aus, um sicherzustellen, dass Sie alle Objekte erstellt haben, die für eine TextBox-Vorlage erforderlich sind:

1. Um Text in einem TextBox-Steuerelement anzuzeigen, fügen Sie einen TextBlock  mit den Objekten hinzu, die für die Darstellung des TextBox-Steuerelements zuständig sind.

   Wenn Sie Vorlagen, die ein TextBlock-Objekt enthalten, in eine Vorlage für ein TextBox-Steuerelement konvertieren, führt der Befehl Steuerelement erstellen folgende Schritte aus:

   • An die Stelle des TextBlock-Steuerelements wird ein ScrollViewer-Objekt platziert, das ein ContentElement-Teil in der Vorlage darstellt.

   • Layouteigenschaften werden vom TextBlock-Steuerelement in das ContentElement-Objekt kopiert.

   • Typografische Eigenschaften werden vom TextBock-Steuerelement in den Stil des TextBox-Steuerelements kopiert. (Der Stil wird um die Vorlage umgebrochen.)

   • Die Text-Eigenschaften werden vom TextBlock-Steuerelement in das TextBox-Objekt kopiert, auf das die Vorlage angewendet wird.

   Alternativ können Sie dem ContentElement-Teil ein Objekt zuweisen, nachdem Sie die Objekte in eine Steuerelementvorlage konvertiert haben. Weitere Informationen finden Sie unter Zuweisen von Vorlagenteilen zu Objekten.

2. Gruppieren Sie die Objekte in ein Layoutpanel, wählen das Layoutpanel aus, und klicken Sie dann im Menü Werkzeug auf Steuerelement erstellen.

3. Wählen Sie TextBox im angezeigten Dialogfeld aus, geben Sie der Vorlage einen Namen, und wählen Sie den Speicherort aus, an dem die Vorlage gespeichert werden soll.

4. Nachdem Sie auf OK geklickt haben, öffnet Microsoft Expression Blend den Vorlagenbearbeitungsmodus und zeigt die Objekte an, aus denen sich das TextBox-Steuerelement zusammensetzt. Sie können die Vorlage in diesem Modus weiter ändern. Ändern Sie z. B. Objekte, oder fügen Sie Objekte hinzu, oder wählen Sie einen Status im Zuständepanel aus, um die Darstellung der Vorlage in diesem Status zu ändern.

5. Sie können ggf. einige Pinseleigenschaften von Objekten in der Vorlage mit folgenden Eigenschaften des TextBox-Objekts verbinden, die die Vorlage unter Umständen verwendet:

   • Background

   • BorderBrush

   • Foreground

   • BorderThickness

   Weitere Informationen finden Sie unter Übernehmen von Objekteigenschaften für die Vorlage.

6. Um den Vorlagenbearbeitungsmodus zu verlassen, klicken Sie in der Breadcrumb-Leiste am oberen Rand der Zeichenfläche auf [TextBox], oder klicken Sie im Panel Objekte und Zeitachsen auf Zurück zum Anfang .

Weitere Informationen zur Anwendung einer neuen TextBox-Vorlage auf andere TextBox-Objekte finden Sie unter Anwenden oder Entfernen einer Ressource.

Verweise

Detaillierte Informationen zu den Eigenschaften und Ereignissen des Microsoft Silverlight-TextBox-Steuerelements finden Sie in der Silverlight Control Gallery auf MSDN.

Siehe auch

Konzepte

Gestaltungstipps für häufig verwendete Silverlight-Steuerelemente

Formatieren eines Steuerelements, das Vorlagen unterstützt

Zeichnen von Text