Text, propriété
TOC
Réduire la table des matières
Développer la table des matières

Control.Text, propriété

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

Espace de noms : System.Windows.Forms
Assembly : System.Windows.Forms (dans system.windows.forms.dll)

[LocalizableAttribute(true)] 
[BindableAttribute(true)] 
public virtual string Text { get; set; }
/** @property */
public String get_Text ()

/** @property */
public void set_Text (String value)

public function get Text () : String

public function set Text (value : String)

Valeur de la propriété

Texte associé à ce contrôle.

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.

Remarques à l'attention des héritiers 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);
}

// 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.set_Location(new Point(15, 15));
    groupBox1.get_Controls().Add(textBox1);
    // Set the Text and Dock properties of the GroupBox.
    groupBox1.set_Text("MyGroupBox");
    groupBox1.set_Dock(DockStyle.Top);
    // Disable the GroupBox (which disables all its child controls)
    groupBox1.set_Enabled(false);
    // Add the Groupbox to the form.
    this.get_Controls().Add(groupBox1);
} //AddMyGroupBox

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0

.NET Compact Framework

Prise en charge dans : 2.0, 1.0

Ajouts de la communauté

AJOUTER
Afficher:
© 2016 Microsoft