Control.Text Eigenschaft

Definition

Ruft den Text ab, der diesem Steuerelement zugeordnet ist, oder legt ihn fest.Gets or sets the text associated with this control.

public:
 virtual property System::String ^ Text { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.Bindable(true)]
public virtual string Text { get; set; }
member this.Text : string with get, set
Public Overridable Property Text As String

Eigenschaftswert

Der diesem Steuerelement zugeordnete Text.The text associated with this control.

Attribute

Beispiele

Im folgenden Codebeispiel wird eine GroupBox erstellt und einige der allgemeinen Eigenschaften festgelegt.The following code example creates a GroupBox and sets some of its common properties. Im Beispiel wird ein TextBox erstellt und dessen Location innerhalb des Gruppen Felds festgelegt.The example creates a TextBox and sets its Location within the group box. Anschließend wird die Text-Eigenschaft des Gruppen Felds festgelegt und das Gruppenfeld an den oberen Rand des Formulars angedockt.Next, it sets the Text property of the group box, and docks the group box to the top of the form. Schließlich wird das Gruppenfeld deaktiviert, indem die Enabled-Eigenschaft auf falsefestgelegt wird, was bewirkt, dass alle im Gruppenfeld enthaltenen Steuerelemente deaktiviert werden.Lastly, it disables the group box by setting the Enabled property to false, which causes all controls contained within the group box to be disabled.

   // 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 Steuer Elements wird von jeder abgeleiteten Klasse unterschiedlich verwendet.The Text property of the control is used differently by each derived class. Beispielsweise wird die Text-Eigenschaft einer Form in der Titelleiste oben im Formular angezeigt, ist in der Zeichen Anzahl relativ klein und zeigt in der Regel den Anwendungs-oder Dokumentnamen an.For example the Text property of a Form is displayed in the title bar at the top of the form, is fairly small in character count, and usually displays the application or document name. Die Text-Eigenschaft einer RichTextBox kann jedoch sehr groß sein und kann zahlreiche nicht visuelle Zeichen enthalten, die zum Formatieren des Texts verwendet werden.However, the Text property of a RichTextBox can be large and can include numerous nonvisual characters used to format the text. Beispielsweise kann der in einem RichTextBox angezeigte Text formatiert werden, indem die Font Eigenschaften angepasst werden, oder durch das Hinzufügen von Leerzeichen oder Tabulator Zeichen, um den Text auszurichten.For example, the text displayed in a RichTextBox can be formatted by adjusting the Font properties, or by the addition of spaces or tab characters to align the text.

Hinweise für Vererber

Wenn Sie die Text-Eigenschaft in einer abgeleiteten Klasse überschreiben, verwenden Sie die Text-Eigenschaft der Basisklasse, um die Basis Implementierung zu erweitern.When overriding the Text property in a derived class, use the base class's Text property to extend the base implementation. Andernfalls müssen Sie die gesamte-Implementierung bereitstellen.Otherwise, you must provide all the implementation. Es ist nicht erforderlich, die get-und set Accessoren der Text-Eigenschaft zu überschreiben. Sie können bei Bedarf nur eine überschreiben.You are not required to override both the get and set accessors of the Text property; you can override only one if needed.

Gilt für:

Siehe auch