Control.Text Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft den diesem Steuerelement zugeordneten Text ab oder legt diesen fest.

public:
 virtual property System::String ^ Text { System::String ^ get(); void set(System::String ^ value); };

[System.ComponentModel.Bindable(true)]
public virtual string Text { get; set; }

[<System.ComponentModel.Bindable(true)>]
member this.Text : string with get, set

Public Overridable Property Text As String

Eigenschaftswert

String

Der diesem Steuerelement zugeordnete Text.

Attribute

BindableAttribute

Beispiele

Im folgenden Codebeispiel werden einige GroupBox der allgemeinen Eigenschaften erstellt und festgelegt. Im Beispiel wird ein TextBox Objekt erstellt und im Location Gruppenfeld festgelegt. Als Nächstes wird die Text Eigenschaft des Gruppenfelds festgelegt und das Gruppenfeld am oberen Rand des Formulars angedockt. Schließlich deaktiviert sie das Gruppenfeld, indem Sie die Enabled Eigenschaft falsefestlegen, was dazu führt, dass alle Steuerelemente im Gruppenfeld deaktiviert werden.

   // Add a GroupBox to a form and set some of its common properties.
private:
   void AddMyGroupBox()
   {
      // Create a GroupBox and add a TextBox to it.
      GroupBox^ groupBox1 = gcnew GroupBox;
      TextBox^ textBox1 = gcnew TextBox;
      textBox1->Location = Point(15,15);
      groupBox1->Controls->Add( textBox1 );

      // Set the Text and Dock properties of the GroupBox.
      groupBox1->Text = "MyGroupBox";
      groupBox1->Dock = DockStyle::Top;

      // Disable the GroupBox (which disables all its child controls)
      groupBox1->Enabled = false;

      // Add the Groupbox to the form.
      this->Controls->Add( groupBox1 );
   }

// Add a GroupBox to a form and set some of its common properties.
private void AddMyGroupBox()
{
   // Create a GroupBox and add a TextBox to it.
   GroupBox groupBox1 = new GroupBox();
   TextBox textBox1 = new TextBox();
   textBox1.Location = new Point(15, 15);
   groupBox1.Controls.Add(textBox1);

   // Set the Text and Dock properties of the GroupBox.
   groupBox1.Text = "MyGroupBox";
   groupBox1.Dock = DockStyle.Top;

   // Disable the GroupBox (which disables all its child controls)
   groupBox1.Enabled = false;

   // Add the Groupbox to the form.
   this.Controls.Add(groupBox1);
}

' Add a GroupBox to a form and set some of its common properties.
Private Sub AddMyGroupBox()
   ' Create a GroupBox and add a TextBox to it.
   Dim groupBox1 As New GroupBox()
   Dim textBox1 As New TextBox()
   textBox1.Location = New Point(15, 15)
   groupBox1.Controls.Add(textBox1)
   
   ' Set the Text and Dock properties of the GroupBox.
   groupBox1.Text = "MyGroupBox"
   groupBox1.Dock = DockStyle.Top
   
   ' Disable the GroupBox (which disables all its child controls)
   groupBox1.Enabled = False
   
   ' Add the Groupbox to the form.
   Me.Controls.Add(groupBox1)
End Sub

Hinweise

Die Text Eigenschaft des Steuerelements wird von jeder abgeleiteten Klasse unterschiedlich verwendet. Beispielsweise wird die Text Eigenschaft eines Form Objekts in der Titelleiste am oberen Rand des Formulars angezeigt, ist relativ klein in der Zeichenanzahl und zeigt normalerweise den Anwendungs- oder Dokumentnamen an. Die Eigenschaft eines RichTextBox Objekts kann jedoch groß sein und kann zahlreiche nichtvisuale Zeichen enthalten, die Text zum Formatieren des Texts verwendet werden. Der in einem RichTextBox Text angezeigte Text kann z. B. formatiert werden, indem die Font Eigenschaften angepasst werden, oder durch das Hinzufügen von Leerzeichen oder Registerkartenzeichen zum Ausrichten des Texts.

Hinweise für Vererber

Verwenden Sie beim Außerkraftsetzen der Eigenschaft in einer abgeleiteten Klasse die Text Basisklasse, um die Basisimplementierung Text zu erweitern. Andernfalls müssen Sie alle Implementierungen bereitstellen. Sie sind nicht erforderlich, um sowohl die Accessoren als auch die get set Zugriffsoren der Text Eigenschaft außer Kraft zu setzen. Sie können nur eine außer Kraft setzen, wenn sie erforderlich ist.

Siehe auch

• TextLength