Control.Text Control.Text Control.Text Control.Text Property

Definition

Ruft den diesem Steuerelement zugeordneten Text ab oder legt diesen 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.

Beispiele

Im folgenden Codebeispiel wird ein GroupBox erstellt, und einige der allgemeinen Eigenschaften werden festgelegt.The following code example creates a GroupBox and sets some of its common properties. Im Beispiel wird ein TextBox erstellt und 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 wird 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. Dies 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 Text die-Eigenschaft Form eines in der Titelleiste am oberen Rand des Formulars 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 RichTextBox eines 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 Tabstopp 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 Text die-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-Accessoren der- Text set 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