Control.Text Właściwość

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Pobiera lub ustawia tekst skojarzony z tą kontrolką.

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

Wartość właściwości

String

Tekst skojarzony z tą kontrolką.

Atrybuty

BindableAttribute

Przykłady

Poniższy przykład kodu tworzy obiekt GroupBox i ustawia niektóre z jego typowych właściwości. W przykładzie tworzony jest obiekt TextBox i ustawia go Location w polu grupy. Następnie ustawia Text właściwość pola grupy i dokuje pole grupy do góry formularza. Na koniec wyłącza pole grupy, ustawiając Enabled właściwość na false, co powoduje wyłączenie wszystkich kontrolek zawartych w polu grupy.

   // 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

Uwagi

Właściwość Text kontrolki jest używana inaczej przez każdą klasę pochodną. Na przykład Text właściwość obiektu Form jest wyświetlana na pasku tytułu w górnej części formularza, ma dość małą liczbę znaków i zwykle wyświetla nazwę aplikacji lub dokumentu. Jednak Text właściwość obiektu RichTextBox może być duża i może zawierać wiele znaków nienadzoranych używanych do formatowania tekstu. Na przykład tekst wyświetlany w obiekcie RichTextBox można sformatować przez dostosowanie Font właściwości lub dodanie spacji lub znaków tabulacji w celu wyrównania tekstu.

Uwagi dotyczące dziedziczenia

Podczas zastępowania Text właściwości w klasie pochodnej użyj właściwości klasy Text bazowej, aby rozszerzyć implementację podstawową. W przeciwnym razie należy podać całą implementację. Nie jest wymagane zastąpienie zarówno metod dostępuText, jak get i set właściwości ; w razie potrzeby można zastąpić tylko jedną.

Zobacz też

• TextLength