Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

ToolTip.SetToolTip méthode (Control, String)

 

Date de publication : novembre 2016

Associe un texte d'info-bulle au contrôle spécifié.

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

public void SetToolTip(
	Control control,
	string caption
)

Paramètres

control
Type: System.Windows.Forms.Control

Le Control pour associer le texte info-bulle.

caption
Type: System.String

Le texte info-bulle à afficher lorsque le pointeur se trouve sur le contrôle.

En plus de spécifier le texte info-bulle à afficher pour un contrôle, vous pouvez également utiliser cette méthode pour modifier le texte d’info-bulle pour un contrôle. Appel de la SetToolTip méthode plusieurs fois pour un contrôle donné ne spécifie pas plusieurs texte info-bulle à afficher pour un contrôle, mais remplace le texte d’info-bulle actuel pour le contrôle. Pour déterminer le texte info-bulle qui est associé à un contrôle au moment de l’exécution, utilisez la GetToolTip méthode.

En règle générale, le texte utilisé doit être court ; Toutefois, vous pouvez insérer des sauts de ligne à l’aide de la \r\n séquence de caractère d’échappement. Et commercial (&) dans le texte sont gérés tel que décrit par le StripAmpersands propriété.

L’exemple de code suivant crée une instance de la ToolTip classe et associe l’instance avec le Form que l’instance est créée. Le code initialise ensuite les propriétés de délai AutoPopDelay, InitialDelay, et ReshowDelay. En outre l’instance de la ToolTip classe définit les ShowAlways propriété true pour activer le texte d’info-bulle à afficher que le formulaire soit actif. Enfin, l’exemple associe le texte info-bulle à deux contrôles sur un formulaire, un Button et un CheckBox. Cet exemple suppose que la méthode définie dans l’exemple est située dans un Form contenant un Button contrôle nommé button1 et un CheckBox contrôle nommé checkBox1, et que la méthode est appelée à partir du constructeur de la Form.

// This example assumes that the Form_Load event handling method
// is connected to the Load event of the form.
private void Form1_Load(object sender, System.EventArgs e)
{
   // Create the ToolTip and associate with the Form container.
   ToolTip toolTip1 = new ToolTip();

   // Set up the delays for the ToolTip.
   toolTip1.AutoPopDelay = 5000;
   toolTip1.InitialDelay = 1000;
   toolTip1.ReshowDelay = 500;
   // Force the ToolTip text to be displayed whether or not the form is active.
   toolTip1.ShowAlways = true;

   // Set up the ToolTip text for the Button and Checkbox.
   toolTip1.SetToolTip(this.button1, "My button1");
   toolTip1.SetToolTip(this.checkBox1, "My checkBox1");
}

.NET Framework
Disponible depuis 1.1
Retour au début
Afficher: