ToolTip Classe

Définition

public ref class ToolTip sealed : System::ComponentModel::Component, System::ComponentModel::IExtenderProvider

public ref class ToolTip : System::ComponentModel::Component, System::ComponentModel::IExtenderProvider

public sealed class ToolTip : System.ComponentModel.Component, System.ComponentModel.IExtenderProvider

public class ToolTip : System.ComponentModel.Component, System.ComponentModel.IExtenderProvider

type ToolTip = class
    inherit Component
    interface IExtenderProvider

Public NotInheritable Class ToolTip
Inherits Component
Implements IExtenderProvider

Public Class ToolTip
Inherits Component
Implements IExtenderProvider

Héritage

Object

MarshalByRefObject

Component

ToolTip

Implémente

IExtenderProvider

Exemples

L’exemple de code suivant crée une instance de la ToolTip classe et associe l’instance au Form dans lequel l’instance est créée. Le code initialise ensuite les propriétés AutoPopDelayde délai , InitialDelay, et ReshowDelay. En outre, l’instance de la ToolTip classe définit la ShowAlways propriété sur true pour permettre au texte d’info-bulle d’être toujours affiché, que le formulaire soit actif ou non. Enfin, l’exemple associe du texte d’info-bulle à deux contrôles sur un formulaire, un Button et un CheckBox. L’exemple de code exige que la méthode définie dans l’exemple se trouve dans un Form qui contient un Button contrôle nommé button1 et un CheckBox contrôle nommé checkBox1, et que la méthode soit appelée à partir du constructeur du Form.

// This example assumes that the Form_Load event handling method
// is connected to the Load event of the form.
void Form1_Load( Object^ sender, System::EventArgs^ e )
{
   // Create the ToolTip and associate with the Form container.
   ToolTip^ toolTip1 = gcnew 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" );
}

// 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");
}

' This example assumes that the Form_Load event handling method
' is connected to the Load event of the form.
Private Sub Form1_Load(sender As Object, e As System.EventArgs) Handles MyBase.Load
   ' Create the ToolTip and associate with the Form container.
   Dim toolTip1 As 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(Me.button1, "My button1")
   toolTip1.SetToolTip(Me.checkBox1, "My checkBox1")
End Sub

Remarques

Avec la ToolTip classe , vous pouvez fournir des conseils à un utilisateur lorsque l’utilisateur place le pointeur sur un contrôle. La ToolTip classe est généralement utilisée pour alerter les utilisateurs de l’utilisation prévue d’un contrôle. Par exemple, vous pouvez spécifier le texte d’info-bulle d’un TextBox contrôle qui accepte un nom, en spécifiant le format du nom à taper dans le contrôle. En plus de fournir des indicateurs, vous pouvez également utiliser la ToolTip classe pour fournir des informations d’état au moment de l’exécution. Par exemple, vous pouvez utiliser la classe pour afficher les ToolTip données de vitesse de connexion et de qualité de ligne lorsque l’utilisateur déplace le pointeur sur un PictureBox contrôle qui affiche l’état de la connexion Internet.

La ToolTip classe peut être utilisée dans n’importe quel conteneur. Pour spécifier explicitement un conteneur, utilisez le ToolTip(IContainer) constructeur . Un seul ToolTip composant est généralement utilisé pour créer des info-bulles pour plusieurs contrôles sur un seul formulaire. Après avoir créé un ToolTip, utilisez un appel distinct à la méthode pour associer le SetToolTip texte d’affichage d’info-bulle à un contrôle individuel. Ensuite, lorsque l’utilisateur déplace le pointeur sur un contrôle, l’info-bulle avec son texte s’affiche. Vous pouvez appeler SetToolTip plusieurs fois pour le même contrôle afin de modifier le texte associé au contrôle. Pour obtenir le texte associé à un contrôle, utilisez la GetToolTip méthode . Pour supprimer toutes les associations de texte d’info-bulle avec une instance de la ToolTip classe , utilisez la RemoveAll méthode .

La ToolTip classe fournit les propriétés et méthodes suivantes pour modifier le comportement et l’apparence par défaut d’une info-bulle.

Si vous souhaitez désactiver tout le texte de l’info-bulle afin qu’il ne puisse pas être affiché dans votre application, vous pouvez utiliser la Active propriété . En règle générale, l’info-bulle est dessinée par le système d’exploitation, mais pour personnaliser l’apparence du ToolTip, vous pouvez définir la OwnerDraw propriété sur true et gérer l’événement Draw .

La ToolTipTitle classe implémente l’interface System.ComponentModel.IExtenderProvider , qui a une seule méthode, CanExtend. Les info-bulles étendent les contrôles sur le même formulaire au moment du design, en ajoutant une ToolTip propriété. Pour plus d’informations sur les fournisseurs d’extendeurs, consultez Fournisseurs d’extendeurs.

Constructeurs

Propriétés

Méthodes

Événements

S’applique à

Voir aussi

• ToolTipIcon
• HelpProvider
• Fournisseurs d'extendeurs
• ToolTip, composant (Windows Forms)