Control.Text, propriété

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

Lors de la substitution de la propriété Text dans une classe dérivée, utilisez la propriété Text de la classe de base pour étendre l'implémentation de base. Sinon, vous devez fournir toute l'implémentation. Il n'est pas nécessaire de substituer les deux accesseurs get et set de la propriété Text ; vous pouvez en substituer un seul si nécessaire.

L'exemple de code suivant crée un objet 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 propriété Text de la zone de groupe et ancre cette dernière en haut du formulaire. Enfin, il désactive la zone de groupe en affectant à la propriété Enabled la valeur false 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 = 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);
}

.NET Framework

.NET Framework Client Profile

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Référence