ToolTip ToolTip ToolTip ToolTip Class

Définition

Représente une petite fenêtre contextuelle rectangulaire qui affiche une brève description de l'objectif d'un contrôle lorsque l'utilisateur positionne le pointeur sur ce dernier.Represents a small rectangular pop-up window that displays a brief description of a control's purpose when the user rests the pointer on the control.

public ref 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 Class ToolTip
Inherits Component
Implements IExtenderProvider
Héritage
Implémente

Exemples

L’exemple de code suivant crée une instance de la ToolTip classe et associe l’instance avec le Form où l’instance est créée.The following code example creates an instance of the ToolTip class and associates the instance with the Form that the instance is created within. Le code initialise ensuite les propriétés de délai AutoPopDelay, InitialDelay, et ReshowDelay.The code then initializes the delay properties AutoPopDelay, InitialDelay, and ReshowDelay. En outre l’instance de la ToolTip classe définit la ShowAlways propriété true pour activer le texte d’info-bulle doit toujours être affichage que le formulaire soit actif.In addition the instance of the ToolTip class sets the ShowAlways property to true to enable ToolTip text to always be display regardless of whether the form is active. Enfin, l’exemple associe le texte info-bulle avec deux contrôles sur un formulaire, un Button et un CheckBox.Finally, the example associates ToolTip text with two controls on a form, a Button and a CheckBox. L’exemple de code requiert 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 est appelée à partir du constructeur de la Form.The code example requires that the method defined in the example is located within a Form that contains a Button control named button1 and a CheckBox control named checkBox1, and that the method is called from the constructor of the 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 le ToolTip (classe), vous pouvez fournir des indications à un utilisateur lorsque l’utilisateur place le pointeur sur un contrôle.With the ToolTip class, you can provide hints to a user when the user places the pointer on a control. Le ToolTip classe est généralement utilisée pour avertir les utilisateurs de l’utilisation prévue d’un contrôle.The ToolTip class is typically used to alert users to the intended use of a control. Par exemple, vous pouvez spécifier le texte d’info-bulle pour un TextBox contrôle qui accepte un nom, en spécifiant le format du nom doit être tapé dans le contrôle.For example, you can specify ToolTip text for a TextBox control that accepts a name, specifying the format of the name to be typed into the control. En plus de fournir des indications, vous pouvez également utiliser le ToolTip classe pour fournir des informations sur l’état exécution.In addition to providing hints, you can also use the ToolTip class to provide run time status information. Par exemple, vous pouvez utiliser la ToolTip classe pour afficher les données de qualité de vitesse et de la ligne de connexion lorsque l’utilisateur déplace le pointeur sur un PictureBox contrôle qui affiche l’état de la connexion Internet.For example, you can use the ToolTip class to display connection speed and line quality data when the user moves the pointer onto a PictureBox control that displays Internet connection status.

Le ToolTip classe peut être utilisée dans n’importe quel conteneur.The ToolTip class can be used in any container. Pour spécifier explicitement un conteneur, utilisez la ToolTip(IContainer) constructeur.To explicitly specify a container, use the ToolTip(IContainer) constructor. Un seul ToolTip composant est généralement utilisé pour créer des info-bulles de plusieurs contrôles sur un seul formulaire.A single ToolTip component typically is used to create ToolTips for multiple controls on a single form. Après avoir créé un ToolTip, utilisez un appel séparé à la SetToolTip méthode à associer le texte d’affichage info-bulle à un contrôle individuel.After you create a ToolTip, use a separate call to the SetToolTip method to associate ToolTip display text to an individual control. Lorsque l’utilisateur déplace le pointeur sur un contrôle, l’info-bulle avec son texte s’affiche.Then when the user moves the pointer on a control, the ToolTip with its text is displayed. Vous pouvez appeler SetToolTip plusieurs fois pour le même contrôle modifier le texte qui est associé au contrôle.You can call SetToolTip more than once for the same control to change the text that is associated with the control. Pour obtenir le texte associé à un contrôle, utilisez le GetToolTip (méthode).To get the text that is associated with a control, use the GetToolTip method. Pour supprimer toutes les associations de texte d’info-bulle avec une instance de la ToolTip classe, utilisez le RemoveAll (méthode).To remove all ToolTip text associations with an instance of the ToolTip class, use the RemoveAll method.

Notes

Texte info-bulle s’affiche pas pour les contrôles qui sont désactivés.ToolTip text is not displayed for controls that are disabled. À moins que le ShowAlways propriété est définie sur true, info-bulles ne sont pas affichés lors de leur conteneur est inactif.Unless the ShowAlways property is set to true, ToolTips are not displayed when their container is inactive.

Le ToolTip classe fournit les propriétés et méthodes permettant de modifier le comportement par défaut et l’apparence d’une info-bulle suivantes.The ToolTip class provides the following properties and methods to modify the default behavior and appearance of a ToolTip.

CategoryCategory Membres associésAssociated members
Affichage manuelManual display Active, Show, Hide, ShowAlways, Popup, StopTimerActive, Show, Hide, ShowAlways, Popup, StopTimer
Minutage de l’info-bulleToolTip timing AutoPopDelay, InitialDelay, ReshowDelay, AutomaticDelay, StopTimerAutoPopDelay, InitialDelay, ReshowDelay, AutomaticDelay, StopTimer
ContenuContent SetToolTip, GetToolTip, StripAmpersands, ToolTipIcon, ToolTipTitle, RemoveAllSetToolTip, GetToolTip, StripAmpersands, ToolTipIcon, ToolTipTitle, RemoveAll
ApparenceAppearance BackColor, ForeColor, IsBalloon, OwnerDraw, UseAnimation, UseFadingBackColor, ForeColor, IsBalloon, OwnerDraw, UseAnimation, UseFading

Si vous souhaitez désactiver tout le texte info-bulle afin qu’il ne peut pas être affichée dans votre application, vous pouvez utiliser le Active propriété.If you want to disable all ToolTip text so that it cannot be displayed in your application, you can use the Active property. L’info-bulle est dessiné par le système d’exploitation, mais pour personnaliser l’apparence de la ToolTip, vous pouvez définir le OwnerDraw propriété true et gérer le Draw événement.Usually the ToolTip is drawn by the operating system, but to customize the appearance of the ToolTip, you can set the OwnerDraw property to true and handle the Draw event.

Le ToolTipTitle la classe implémente le System.ComponentModel.IExtenderProvider interface, ce qui a une méthode unique, CanExtend.The ToolTipTitle class implements the System.ComponentModel.IExtenderProvider interface, which has a single method, CanExtend. Info-bulles étendent des contrôles sur le même formulaire au moment du design, ajout d’un ToolTip propriété.ToolTips extend controls on the same form at design time, adding a ToolTip property. Pour plus d’informations sur les fournisseurs d’extendeurs, consultez fournisseurs d’extendeurs.For more information about extender providers, see Extender Providers.

Constructeurs

ToolTip() ToolTip() ToolTip() ToolTip()

Initialise une nouvelle instance de la ToolTip sans conteneur spécifié.Initializes a new instance of the ToolTip without a specified container.

ToolTip(IContainer) ToolTip(IContainer) ToolTip(IContainer) ToolTip(IContainer)

Initialise une nouvelle instance de la ToolTip classe avec un conteneur spécifié.Initializes a new instance of the ToolTip class with a specified container.

Propriétés

Active Active Active Active

Obtient ou définit une valeur indiquant si l'info-bulle est actuellement active.Gets or sets a value indicating whether the ToolTip is currently active.

AutomaticDelay AutomaticDelay AutomaticDelay AutomaticDelay

Obtient ou définit le délai initial pour l'info-bulle.Gets or sets the automatic delay for the ToolTip.

AutoPopDelay AutoPopDelay AutoPopDelay AutoPopDelay

Obtient ou définit la durée d'affichage de l'info-bulle lorsque le pointeur de la souris s'immobilise sur un contrôle contenant le texte d'info-bulle spécifié.Gets or sets the period of time the ToolTip remains visible if the pointer is stationary on a control with specified ToolTip text.

BackColor BackColor BackColor BackColor

Obtient ou définit la couleur d'arrière-plan de l'info-bulle.Gets or sets the background color for the ToolTip.

CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

Obtient une valeur qui indique si le composant peut déclencher un événement.Gets a value indicating whether the component can raise an event.

(Inherited from Component)
Container Container Container Container

Obtient le IContainer qui contient Component.Gets the IContainer that contains the Component.

(Inherited from Component)
CreateParams CreateParams CreateParams CreateParams

Obtient les paramètres de création de la fenêtre d'info-bulle.Gets the creation parameters for the ToolTip window.

DesignMode DesignMode DesignMode DesignMode

Obtient une valeur qui indique si Component est actuellement en mode design.Gets a value that indicates whether the Component is currently in design mode.

(Inherited from Component)
Events Events Events Events

Obtient la liste des gestionnaires d'événements attachés à ce Component.Gets the list of event handlers that are attached to this Component.

(Inherited from Component)
ForeColor ForeColor ForeColor ForeColor

Obtient ou définit la couleur de premier plan de l'info-bulle.Gets or sets the foreground color for the ToolTip.

InitialDelay InitialDelay InitialDelay InitialDelay

Obtient ou définit le temps écoulé avant l'apparition de l'info-bulle.Gets or sets the time that passes before the ToolTip appears.

IsBalloon IsBalloon IsBalloon IsBalloon

Obtient ou définit une valeur indiquant si l'info-bulle doit utiliser une fenêtre de bulle.Gets or sets a value indicating whether the ToolTip should use a balloon window.

OwnerDraw OwnerDraw OwnerDraw OwnerDraw

Obtient ou définit une valeur indiquant si l'info-bulle est dessinée par le système d'exploitation ou par le code que vous fournissez.Gets or sets a value indicating whether the ToolTip is drawn by the operating system or by code that you provide.

ReshowDelay ReshowDelay ReshowDelay ReshowDelay

Obtient ou définit le délai qui doit s'écouler avant que s'affichent des fenêtres d'info-bulle qui se suivent lorsque le pointeur de la souris passe d'un contrôle à un autre.Gets or sets the length of time that must transpire before subsequent ToolTip windows appear as the pointer moves from one control to another.

ShowAlways ShowAlways ShowAlways ShowAlways

Obtient ou définit une valeur indiquant si la fenêtre d'info-bulle apparaît même lorsque son contrôle parent n'est pas actif.Gets or sets a value indicating whether a ToolTip window is displayed, even when its parent control is not active.

Site Site Site Site

Obtient ou définit le ISite de Component.Gets or sets the ISite of the Component.

(Inherited from Component)
StripAmpersands StripAmpersands StripAmpersands StripAmpersands

Obtient ou définit une valeur qui détermine comment le et commercial (&) est traité.Gets or sets a value that determines how ampersand (&) characters are treated.

Tag Tag Tag Tag

Obtient ou définit l’objet qui contient les données fournies par le programmeur associées à la ToolTip.Gets or sets the object that contains programmer-supplied data associated with the ToolTip.

ToolTipIcon ToolTipIcon ToolTipIcon ToolTipIcon

Obtient ou définit une valeur qui définit le type d'icône à afficher le long du texte d'info-bulle.Gets or sets a value that defines the type of icon to be displayed alongside the ToolTip text.

ToolTipTitle ToolTipTitle ToolTipTitle ToolTipTitle

Obtient ou définit le titre de la fenêtre d'info-bulle.Gets or sets a title for the ToolTip window.

UseAnimation UseAnimation UseAnimation UseAnimation

Obtient ou définit une valeur déterminant si un effet d'animation doit être utilisé lors de l'affichage de l'info-bulle.Gets or sets a value determining whether an animation effect should be used when displaying the ToolTip.

UseFading UseFading UseFading UseFading

Obtient ou définit une valeur déterminant si un effet d'atténuation doit être utilisé lors de l'affichage de l'info-bulle.Gets or sets a value determining whether a fade effect should be used when displaying the ToolTip.

Méthodes

CanExtend(Object) CanExtend(Object) CanExtend(Object) CanExtend(Object)

Retourne true si l’info-bulle peut exposer une propriété extendeur au composant cible spécifié.Returns true if the ToolTip can offer an extender property to the specified target component.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

Crée un objet contenant toutes les informations appropriées requises pour générer un proxy permettant de communiquer avec un objet distant.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

Libère toutes les ressources utilisées par Component.Releases all resources used by the Component.

(Inherited from Component)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Libère les ressources non managées utilisées par Component et libère éventuellement les ressources managées.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

(Inherited from Object)
Finalize() Finalize() Finalize() Finalize()

Libère les ressources non managées et effectue d’autres opérations de nettoyage avant que le Cursor ne soit récupéré par le garbage collector.Releases the unmanaged resources and performs other cleanup operations before the Cursor is reclaimed by the garbage collector.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Récupère l'objet de service de durée de vie en cours qui contrôle la stratégie de durée de vie de cette instance.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetService(Type) GetService(Type) GetService(Type) GetService(Type)

Retourne un objet qui représente un service fourni par Component ou par son Container.Returns an object that represents a service provided by the Component or by its Container.

(Inherited from Component)
GetToolTip(Control) GetToolTip(Control) GetToolTip(Control) GetToolTip(Control)

Récupère le texte d'info-bulle associé au contrôle spécifié.Retrieves the ToolTip text associated with the specified control.

GetType() GetType() GetType() GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Inherited from Object)
Hide(IWin32Window) Hide(IWin32Window) Hide(IWin32Window) Hide(IWin32Window)

Masque la fenêtre d'info-bulle spécifiée.Hides the specified ToolTip window.

InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Crée une copie superficielle de l'objet MarshalByRefObject actuel.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
RemoveAll() RemoveAll() RemoveAll() RemoveAll()

Supprime tout le texte d'info-bulle actuellement associé au composant ToolTip.Removes all ToolTip text currently associated with the ToolTip component.

SetToolTip(Control, String) SetToolTip(Control, String) SetToolTip(Control, String) SetToolTip(Control, String)

Associe un texte d'info-bulle au contrôle spécifié.Associates ToolTip text with the specified control.

Show(String, IWin32Window) Show(String, IWin32Window) Show(String, IWin32Window) Show(String, IWin32Window)

Définit le texte d'info-bulle associé au contrôle spécifié et affiche l'info-bulle de façon modale.Sets the ToolTip text associated with the specified control, and displays the ToolTip modally.

Show(String, IWin32Window, Int32) Show(String, IWin32Window, Int32) Show(String, IWin32Window, Int32) Show(String, IWin32Window, Int32)

Définit le texte d'info-bulle associé au contrôle spécifié, puis affiche l'info-bulle pour la durée spécifiée.Sets the ToolTip text associated with the specified control, and then displays the ToolTip for the specified duration.

Show(String, IWin32Window, Int32, Int32) Show(String, IWin32Window, Int32, Int32) Show(String, IWin32Window, Int32, Int32) Show(String, IWin32Window, Int32, Int32)

Définit le texte d'info-bulle associé au contrôle spécifié, puis affiche de façon modale l'info-bulle à la position relative spécifiée.Sets the ToolTip text associated with the specified control, and then displays the ToolTip modally at the specified relative position.

Show(String, IWin32Window, Int32, Int32, Int32) Show(String, IWin32Window, Int32, Int32, Int32) Show(String, IWin32Window, Int32, Int32, Int32) Show(String, IWin32Window, Int32, Int32, Int32)

Définit le texte d'info-bulle associé au contrôle spécifié, puis affiche l'info-bulle pour la durée spécifiée à la position relative spécifiée.Sets the ToolTip text associated with the specified control, and then displays the ToolTip for the specified duration at the specified relative position.

Show(String, IWin32Window, Point) Show(String, IWin32Window, Point) Show(String, IWin32Window, Point) Show(String, IWin32Window, Point)

Définit le texte d'info-bulle associé au contrôle spécifié, puis affiche de façon modale l'info-bulle à la position relative spécifiée.Sets the ToolTip text associated with the specified control, and then displays the ToolTip modally at the specified relative position.

Show(String, IWin32Window, Point, Int32) Show(String, IWin32Window, Point, Int32) Show(String, IWin32Window, Point, Int32) Show(String, IWin32Window, Point, Int32)

Définit le texte d'info-bulle associé au contrôle spécifié, puis affiche l'info-bulle pour la durée spécifiée à la position relative spécifiée.Sets the ToolTip text associated with the specified control, and then displays the ToolTip for the specified duration at the specified relative position.

StopTimer() StopTimer() StopTimer() StopTimer()

Arrête la minuterie qui masque les info-bulles affichées.Stops the timer that hides displayed ToolTips.

ToString() ToString() ToString() ToString()

Retourne une représentation sous forme de chaîne pour ce contrôle.Returns a string representation for this control.

Événements

Disposed Disposed Disposed Disposed

Se produit lorsque le composant est supprimé par un appel à la méthode Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Inherited from Component)
Draw Draw Draw Draw

Se produit lorsque l’info-bulle est dessinée et la OwnerDraw propriété est définie sur true et IsBalloon propriété est false.Occurs when the ToolTip is drawn and the OwnerDraw property is set to true and the IsBalloon property is false.

Popup Popup Popup Popup

Se produit avant l'affichage initial d'une info-bulle.Occurs before a ToolTip is initially displayed. C’est l’événement par défaut pour le ToolTip classe.This is the default event for the ToolTip class.

S’applique à

Voir aussi