Control.Text Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtient ou définit le texte associé à ce contrôle.

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

Valeur de propriété

String

Texte associé à ce contrôle.

Attributs

BindableAttribute

Exemples

L’exemple de code suivant crée un GroupBox et définit certaines de ses propriétés communes. L’exemple crée un TextBox et définit son Location dans la zone de groupe. Ensuite, il définit la Text propriété de la zone de groupe et ancre la zone de groupe en haut du formulaire. Enfin, il désactive la zone de groupe en affectant à falsela propriété la Enabled valeur , ce qui entraîne la désactivation de tous les contrôles contenus dans la zone de groupe.

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

Remarques

La Text propriété du contrôle est utilisée différemment par chaque classe dérivée. Par exemple, la Text propriété d’un Form est affichée dans la barre de titre en haut du formulaire, est relativement petite en nombre de caractères et affiche généralement le nom de l’application ou du document. Toutefois, la Text propriété d’un RichTextBox peut être volumineuse et peut inclure de nombreux caractères nonvisuels utilisés pour mettre en forme le texte. Par exemple, le texte affiché dans un RichTextBox peut être mis en forme en ajustant les Font propriétés ou en ajoutant des espaces ou des caractères de tabulation pour aligner le texte.

Notes pour les héritiers

Lorsque vous substituez la Text propriété dans une classe dérivée, utilisez la propriété de la classe de Text base pour étendre l’implémentation de base. Sinon, vous devez fournir toute l’implémentation. Vous n’êtes pas obligé de remplacer les get accesseurs et set de la Text propriété ; vous ne pouvez remplacer qu’un seul si nécessaire.

Voir aussi

• TextLength