Exporter (0) Imprimer
Développer tout
Développer Réduire

Control.Text, propriété

Mise à jour : novembre 2007

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)

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

public function get Text () : String
public function set Text (value : String)

Valeur de propriété

Type : System.String

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 Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professionnel Édition x64, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile pour Smartphone, Windows Mobile pour Pocket PC

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Pris en charge dans : 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Pris en charge dans : 3.5, 2.0, 1.0

Ajouts de la communauté

AJOUTER
Microsoft réalise une enquête en ligne pour recueillir votre opinion sur le site Web de MSDN. Si vous choisissez d’y participer, cette enquête en ligne vous sera présentée lorsque vous quitterez le site Web de MSDN.

Si vous souhaitez y participer,
Afficher:
© 2014 Microsoft