{"id":55000215,"date":"2020-04-01T00:00:00","date_gmt":"2020-08-25T08:47:58","guid":{"rendered":"http:\/\/access-im-unternehmen.aix-dev.de\/aiu\/?p=215"},"modified":"-0001-11-30T00:00:00","modified_gmt":"-0001-11-30T00:00:00","slug":"Das_TextBoxSteuerelement","status":"publish","type":"post","link":"https:\/\/vbentwickler.de\/Das_TextBoxSteuerelement\/","title":{"rendered":"Das TextBox-Steuerelement"},"content":{"rendered":"

Das wohl am meisten verwendete Steuer-element ist das TextBox-Steuerelement. Es dient zur Eingabe von Texten und bietet eine Menge von Eigenschaften, Ereignissen und Methoden, um damit zu arbeiten. Sie können ungebundene Textfelder nutzen, um Text einzugeben, der auf bestimmte Weise verarbeitet werden soll oder Textfelder über das Entity Data Model an die Datenquelle binden, um Datenbankinhalte anzuzeigen und zu bearbeiten. Dieser Artikel liefert die Grundlagen zum TextBox-Steuerelement unter WPF.<\/b><\/p>\n

Ein Textfeld ist unter WPF schnell erstellt. Sie fügen einfach das öffnende und das schließende TextBox<\/b>-Element in das Grid-Element ein und fügen dazwischen einen Text hinzu:<\/p>\n

<Grid>\r\n     <TextBox>Dies ist ein Beispieltext.<\/TextBox>\r\n<\/Grid><\/pre>\n
Das Textfeld nimmt dann allerdings den gesamten Platz im Grid ein, sodass wir noch ein paar Anpassungen vornehmen. Entweder wir legen die Position und die Größe absolut mit den Eigenschaften Width<\/b>, Height<\/b>, Top <\/b>und Left <\/b>fest oder wir fügen zum Grid einige Zeilen und Spalten hinzu, damit wir gleich mehrere Steuer-elemente gleichmäßig anordnen können. Wir wählen letztere Alternative, die Sie im Quellcode ansehen können und die im Entwurf wie in Bild 1 aussieht. Hier haben wir noch ein Label<\/b>-Element in die erste Spalte der ersten Zeile eingefügt und das TextBox<\/b>-Element in die zweite Spalte der ersten Zeile:<\/p>\n
\"Textfeld<\/p>\n
Bild 1: Textfeld mit Bezeichnungsfeld<\/span><\/b><\/p>\n
<Label>Beispieltext:<\/Label>\r\n<TextBox Grid.Column=\"1\">Dies ist ein Beispieltext.<\/TextBox><\/pre>\n
Formatierter Text<\/b><\/p>\n
Unterschiedliche Textformatierungen lassen sich mit dem TextBox<\/b>-Steuerelement nicht anwenden oder anzeigen. Dazu benötigen wir beispielsweise das RichTextBox<\/b>-Steuerelement.<\/p>\n
Padding: Abstand des Inhalts zum Textfeldrand<\/b><\/p>\n
Neben den Standardeigenschaften Width<\/b>, Height<\/b>, Top <\/b>und Left <\/b>benötigen Sie vermutlich noch die Eigenschaften Margin <\/b>und Padding<\/b>. Mit Padding <\/b>stellen Sie den Abstand des Inhalts, also in der Regel des Textes, von den Begrenzungen des Steuerelements ein.<\/p>\n
Soll der Abstand oben, unten, rechts und links gleich groß sein, legen Sie es zum Beispiel mit Padding=”3″ <\/b>fest. Wenn Sie unterschiedliche Abstände wünschen, geben Sie die Werte durch Kommata getrennt an, wobei die Reihenfolge links, oben, rechts und unten lautet.<\/p>\n
Margin: Abstand zu den umgebenden Steuerelementen<\/b><\/p>\n
Mit der Eigenschaft Margin <\/b>hingegen geben Sie den Abstand an, den das Steuer-element zu den umgebenden Steuerelementen aufweisen soll. Wenn Sie also etwa ein Grid verwenden, um die Steuer-elemente anzuordnen, und keinen Wert für Margin <\/b>angeben, gibt es keinen Abstand zwischen den Steuerelementen. Um einen solchen Abstand herzustellen, legen Sie also etwa Margin=”3″ <\/b>fest – so hat das Steuer-element jeweils einen Abstand von 3 <\/b>zum nächsten angrenzenden Element, in diesem Fall zu den gedachten Linien des Grid<\/b>-Elements.<\/p>\n
Textfeld ausrichten<\/b><\/p>\n
Für Textfelder gibt es die üblichen Möglichkeiten zur Ausrichtung. Für die horizontale Ausrichtung im Grid verwenden Sie die Eigenschaft HorizontalAlignment <\/b>mit den Werten Center<\/b>, Left<\/b>, Right <\/b>und Stretch<\/b>. Für die vertikale Ausrichtung nutzen Sie die Eigenschaft VerticalAlignment <\/b>mit den Werten Bottom<\/b>, Center<\/b>, Stretch <\/b>und Top<\/b>.<\/p>\n
Text ausrichten<\/b><\/p>\n
Natürlich können Sie auch den Text im Textfeld ausrichten. Dazu verwenden Sie die Eigenschaft TextAlignment <\/b>mit den Werten Center<\/b>, Justify<\/b>, Left <\/b>(Standardwert) und Right<\/b>:<\/p>\n
<TextBox Text=\"Mittig zentrierter Text\" TextAlignment=\"Center\"><\/TextBox><\/pre>\n
Inhalt des Steuerelements<\/b><\/p>\n
Den Inhalt des Steuerelements können Sie, wie oben gesehen, einfach zwischen das öffnende und schließende TextBox<\/b>-Element einfügen. Dies entspricht der Verwendung der Eigenschaft Text<\/b>:<\/p>\n
<TextBox Text=\"Dies ist ein Beispieltext.\"><\/TextBox><\/pre>\n
Eingebautes Kontextmenü<\/b><\/p>\n
Das TextBox<\/b>-Steuerelement liefert standardmäßig ein Kontextmenü mit den drei Befehlen Ausschneiden<\/b>, Kopieren <\/b>und Einfügen <\/b>mit, das Sie wie üblich mit einem Klick der rechten Maustaste auf das Steuer-element anzeigen (siehe Bild 2). Dieses Kontextmenü können Sie anpassen. Wie das geht, erklären wir in einem weiteren Artikel namens Kontextmenüs unter WPF <\/b>(www.datenbankentwickler.net\/214<\/b>).<\/p>\n
\"Kontextmenü<\/p>\n
Bild 2: Kontextmenü eines Textfeldes<\/span><\/b><\/p>\n
Weitere Einträge kommen zum Kontextmenü hinzu, wenn die Rechtschreibprüfung aktiviert ist – siehe nächster Abschnitt.<\/p>\n
Rechtschreibprüfung<\/b><\/p>\n
Standardmäßig ist keine Rechtschreibprüfung für TextBox<\/b>-Elemente aktiviert. Sie können diese jedoch leicht anschalten, indem Sie die Eigenschaft Spellcheck.IsEnabled <\/b>auf den Wert True <\/b>einstellen. Wenn Sie dann ein falsch geschriebenes Wort einfügen, wird dieses rot unterstrichen. Klicken Sie dann mit der rechten Maustaste auf das Wort, zeigt das Kontextmenü Verbesserungsvorschläge an (siehe Bild 3).<\/p>\n
\"Rechtschreibprüfung<\/p>\n
Bild 3: Rechtschreibprüfung im Textfeld mit Verbesserungsvorschlägen<\/span><\/b><\/p>\n
Eingabe kontrollieren<\/b><\/p>\n
Wenn Sie sicherstellen wollen, dass nicht mehr als eine bestimmte Anzahl Zeichen in einem Textfeld landen, können Sie die Anzahl mit der Eigenschaft MaxLength <\/b>begrenzen. Geben Sie einfach die maximale Anzahl als Wert an:<\/p>\n
<TextBox MaxLength=\"50\"><\/TextBox><\/pre>\n
Textumbruch aktivieren<\/b><\/p>\n
Normalerweise wird Text, der die Breite des Textfeldes übersteigt, einfach nicht komplett angezeigt (Voraussetzung dafür ist, dass sich das Textfeld nicht automatisch verbreitern kann – also wenn entweder eine feste Breite festgelegt oder die Breite des Fensters begrenzt ist). Das gilt auch für Textfelder, deren Höhe für die Darstellung von mehr als einer Zeile ausreicht. Wenn sie möchten, dass der Text am Ende des Textfeldes umgebrochen wird, können Sie die Eigenschaft TextWrapping<\/b> verwenden. Diese bietet drei mögliche Werte an:<\/p>\n