TextBox-Klasse
Stellt ein Textfeld-Steuerelement von Windows dar.
Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)
Syntax
'Declaration
<ComVisibleAttribute(True)> _
<ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)> _
Public Class TextBox
Inherits TextBoxBase
'Usage
Dim instance As TextBox
[ComVisibleAttribute(true)]
[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]
public class TextBox : TextBoxBase
[ComVisibleAttribute(true)]
[ClassInterfaceAttribute(ClassInterfaceType::AutoDispatch)]
public ref class TextBox : public TextBoxBase
/** @attribute ComVisibleAttribute(true) */
/** @attribute ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) */
public class TextBox extends TextBoxBase
ComVisibleAttribute(true)
ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)
public class TextBox extends TextBoxBase
Hinweise
Mit dem TextBox-Steuerelement kann der Benutzer Text in einer Anwendung eingeben. Dieses Steuerelement bietet eine Funktionalität, die über das Standard-Textfeld-Steuerelement von Windows hinausgeht. Dazu gehören Mehrzeilenbearbeitung und Zeichenmaskierung für Kennwörter.
Normalerweise wird ein TextBox-Steuerelement für die Anzeige oder Eingabe einer einzelnen Textzeile verwendet. Über die Multiline-Eigenschaft und die ScrollBars-Eigenschaft kann die Anzeige bzw. Eingabe mehrerer Textzeilen aktiviert werden. Legen Sie die AcceptsTab-Eigenschaft und die AcceptsReturn-Eigenschaft auf true fest, um die umfangreichere Textbearbeitung in einem mehrzeiligen TextBox-Steuerelement zu ermöglichen.
Die in einem TextBox-Steuerelement eingegebene Textmenge kann begrenzt werden, indem die MaxLength-Eigenschaft auf eine bestimmte Anzahl von Zeichen festgelegt wird. Mit TextBox-Steuerelementen können auch Kennwörter und andere vertrauliche Informationen abgefragt werden. Die PasswordChar-Eigenschaft kann verwendet werden, um die in einer einzeiligen Version des Steuerelements eingegebenen Zeichen zu maskieren. Mit der CharacterCasing-Eigenschaft können Sie Benutzern die ausschließliche Eingabe von Großbuchstaben, von Kleinbuchstaben oder einer Kombination von Groß- und Kleinbuchstaben im TextBox-Steuerelement ermöglichen.
Um die Texteingabe für ein TextBox-Steuerelement zu beschränken, können Sie für das KeyDown-Ereignis einen Ereignishandler erstellen, damit jedes im Steuerelement eingegebene Zeichen validiert wird. Außerdem können Sie alle Dateneingaben in einem TextBox-Steuerelement beschränken, indem Sie die ReadOnly-Eigenschaft auf true festlegen.
Hinweis
Die Funktionalität des TextBox-Steuerelements wird größtenteils von der TextBoxBase-Klasse vererbt.
Hinweis
Die Verwendung des TextBox-Steuerelements bei gleichzeitig aktivierten visuellen Stilen verursacht eine fehlerhafte Behandlung von Ersatzschriftarten.
Hinweis zu Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows CE: In Pocket PC-Anwendungen werden Registerkarten in einem einzeiligen Textfeld als Klammern angezeigt. Sie werden jedoch normal angezeigt, wenn Multiline auf true festgelegt ist.
Beispiel
Im folgenden Codebeispiel wird ein mehrzeiliges TextBox-Steuerelement mit vertikalen Bildlaufleisten erstellt. In diesem Beispiel werden die Eigenschaften AcceptsTab, AcceptsReturn und WordWrap verwendet, um das mehrzeilige Textfeld-Steuerelement zum Erstellen von Textdokumenten verwenden zu können.
Private Sub CreateMyMultilineTextBox()
' Create an instance of a TextBox control.
Dim textBox1 As New TextBox()
' Set the Multiline property to true.
textBox1.Multiline = True
' Add vertical scroll bars to the TextBox control.
textBox1.ScrollBars = ScrollBars.Vertical
' Allow the RETURN key to be entered in the TextBox control.
textBox1.AcceptsReturn = True
' Allow the TAB key to be entered in the TextBox control.
textBox1.AcceptsTab = True
' Set WordWrap to True to allow text to wrap to the next line.
textBox1.WordWrap = True
' Set the default text of the control.
textBox1.Text = "Welcome!"
End Sub
private void CreateMyMultilineTextBox()
{
// Create an instance of a TextBox control.
TextBox textBox1 = new TextBox();
// Set the Multiline property to true.
textBox1.Multiline = true;
// Add vertical scroll bars to the TextBox control.
textBox1.ScrollBars = ScrollBars.Vertical;
// Allow the RETURN key to be entered in the TextBox control.
textBox1.AcceptsReturn = true;
// Allow the TAB key to be entered in the TextBox control.
textBox1.AcceptsTab = true;
// Set WordWrap to True to allow text to wrap to the next line.
textBox1.WordWrap = true;
// Set the default text of the control.
textBox1.Text = "Welcome!";
}
private:
void CreateMyMultilineTextBox()
{
// Create an instance of a TextBox control
TextBox^ textBox1 = gcnew TextBox;
// Set the Multiline property to true.
textBox1->Multiline = true;
// Add vertical scroll bars to the TextBox control.
textBox1->ScrollBars = ScrollBars::Vertical;
// Allow the RETURN key to be entered in the TextBox control.
textBox1->AcceptsReturn = true;
// Allow the TAB key to be entered in the TextBox control.
textBox1->AcceptsTab = true;
// Set WordWrap to True to allow text to wrap to the next line.
textBox1->WordWrap = true;
// Set the default text of the control.
textBox1->Text = "Welcome!";
}
private void CreateMyMultilineTextBox()
{
// Create an instance of a TextBox control.
TextBox textBox1 = new TextBox();
// Set the Multiline property to true.
textBox1.set_Multiline(true);
// Add vertical scroll bars to the TextBox control.
textBox1.set_ScrollBars(ScrollBars.Vertical);
// Allow the RETURN key to be entered in the TextBox control.
textBox1.set_AcceptsReturn(true);
// Allow the TAB key to be entered in the TextBox control.
textBox1.set_AcceptsTab(true);
// Set WordWrap to True to allow text to wrap to the next line.
textBox1.set_WordWrap(true);
// Set the default text of the control.
textBox1.set_Text("Welcome!");
} //CreateMyMultilineTextBox
private function CreateMyMultilineTextBox()
{
// Create an instance of a TextBox control
textBox1 = new TextBox();
// Set the Multiline property to true.
textBox1.Multiline = true;
// Add vertical scroll bars to the TextBox control.
textBox1.ScrollBars = ScrollBars.Vertical;
// Allow the RETURN key to be entered in the TextBox control.
textBox1.AcceptsReturn = true;
// Allow the TAB key to be entered in the TextBox control.
textBox1.AcceptsTab = true;
// Set WordWrap to True to allow text to wrap to the next line.
textBox1.WordWrap = true;
// Set the default text of the control.
textBox1.Text = "Welcome!";
}
Vererbungshierarchie
System.Object
System.MarshalByRefObject
System.ComponentModel.Component
System.Windows.Forms.Control
System.Windows.Forms.TextBoxBase
System.Windows.Forms.TextBox
System.Windows.Forms.DataGridTextBox
System.Windows.Forms.DataGridViewTextBoxEditingControl
Threadsicherheit
Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Plattformen
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
.NET Compact Framework
Unterstützt in: 2.0, 1.0