Číst v angličtině

Sdílet prostřednictvím


Control.Text Vlastnost

Definice

Získá nebo nastaví text přidružený k tomuto ovládacímu prvku.

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

Hodnota vlastnosti

Text přidružený k tomuto ovládacímu prvku.

Atributy

Příklady

Následující příklad kódu vytvoří GroupBox a nastaví některé z jeho společných vlastností. Příklad vytvoří TextBox a nastaví Location ho v poli skupiny. Potom nastaví Text vlastnost skupinového rámečku a ukotví ho k horní části formuláře. Nakonec zakáže skupinové pole nastavením Enabled vlastnosti na false, což způsobí, že všechny ovládací prvky obsažené v poli skupiny budou zakázány.

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

Poznámky

Vlastnost Text ovládacího prvku používá každá odvozená třída odlišně. Například Text vlastnost objektu Form je zobrazena v záhlaví v horní části formuláře, je poměrně malý počet znaků a obvykle zobrazuje název aplikace nebo dokumentu. Vlastnost objektu TextRichTextBox však může být velká a může obsahovat řadu nevisuálních znaků použitých k formátování textu. Například text zobrazený v objektu RichTextBox lze formátovat úpravou Font vlastností nebo přidáním mezer nebo znaků tabulátoru, které text zarovnají.

Poznámky pro dědice

Při přepsání Text vlastnosti v odvozené třídě použijte vlastnost základní třídy Text k rozšíření základní implementace. V opačném případě musíte zadat celou implementaci. Není nutné přepsat přístupové objekty Text vlastnosti a get . set V případě potřeby můžete přepsat pouze jeden.

Platí pro

Produkt Verze
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9, 10

Viz také