Control.Text Eigenschaft

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

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 Steuerelement erstellt und im Gruppenfeld festgelegt Location . Als Nächstes wird die Text Eigenschaft des Gruppenfelds festgelegt und das Gruppenfeld am oberen Rand des Formulars angedockt. Schließlich wird das Gruppenfeld durch Festlegen der Enabled Eigenschaft auf falsedeaktiviert, wodurch alle im Gruppenfeld enthaltenen Steuerelemente 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 Objekts Form in der Titelleiste oben im Formular angezeigt, ist relativ klein in der Zeichenanzahl und zeigt in der Regel den Anwendungs- oder Dokumentnamen an. Die Text Eigenschaft eines Objekts RichTextBox kann jedoch groß sein und kann zahlreiche nichtvisuale Zeichen enthalten, die zum Formatieren des Texts verwendet werden. Beispielsweise kann der in einem Text RichTextBox angezeigte Text durch Anpassen der Font Eigenschaften oder durch Hinzufügen von Leerzeichen oder Tabstoppzeichen formatiert werden, um den Text auszurichten.

Hinweise für Vererber

Verwenden Sie beim Überschreiben der Text Eigenschaft in einer abgeleiteten Klasse die Eigenschaft der Basisklasse Text , um die Basisimplementierung zu erweitern. Andernfalls müssen Sie alle Implementierungen bereitstellen. Sie müssen die get Eigenschaften und set Accessoren Text nicht außer Kraft setzen. Sie können bei Bedarf nur eine außer Kraft setzen.

Weitere Informationen

• TextLength