ToolTip.InitialDelay ToolTip.InitialDelay ToolTip.InitialDelay ToolTip.InitialDelay Property

Définition

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.

public:
 property int InitialDelay { int get(); void set(int value); };
public int InitialDelay { get; set; }
member this.InitialDelay : int with get, set
Public Property InitialDelay As Integer

Valeur de propriété

Durée, en millisecondes, pendant laquelle le pointeur de la souris doit rester immobile sur un contrôle avant que la fenêtre d'info-bulle s'affiche.The period of time, in milliseconds, that the pointer must remain stationary on a control before the ToolTip window is displayed.

Exemples

L’exemple de code suivant crée une instance de ToolTip la classe et l’associe à Form l’instance dans laquelle 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 AutoPopDelayDelay, InitialDelayet ReshowDelay.The code then initializes the delay properties AutoPopDelay, InitialDelay, and ReshowDelay. En outre, l’instance de ToolTip la classe affecte ShowAlways à la true propriété la valeur pour permettre l’affichage du texte info-bulle, que le formulaire soit actif ou non.In addition the instance of the ToolTip class sets the ShowAlways property to true to enable ToolTip text to be displayed regardless of whether the form is active. Enfin, l’exemple associe le texte info-bulle à deux contrôles sur Button un formulaire CheckBox, un et un.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 Form un qui contient Button un contrôle button1 nommé et CheckBox un contrôle checkBox1, nommé et que la méthode soit appelée à partir du constructeur de 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 la InitialDelay propriété, vous pouvez raccourcir ou allonger la ToolTip durée d’attente avant d’afficher une fenêtre d’info-bulle.With the InitialDelay property, you can shorten or lengthen the time that the ToolTip waits before displaying a ToolTip window. Si la valeur de la InitialDelay propriété est définie sur une valeur trop longue, l’utilisateur de votre application peut ne pas savoir que votre application fournit de l’aide pour l’info-bulle.If the value of the InitialDelay property is set to a value that is too long in duration, the user of your application might not know that your application provides ToolTip Help. Vous pouvez utiliser cette propriété pour vous assurer que les info-bulles s’affichent rapidement sur l’utilisateur en réduisant le temps spécifié.You can use this property to ensure that the user has ToolTips displayed quickly by shortening the time specified.

La valeur de cette propriété ne peut pas dépasser 32767.The value for this property cannot exceed 32767.

Si vous souhaitez avoir un modèle de délai cohérent pour vos fenêtres d’info-bulle, vous AutomaticDelay pouvez définir la propriété.If you want to have a consistent delay pattern for your ToolTip windows, you can set the AutomaticDelay property. La AutomaticDelay propriété ReshowDelay InitialDelay affecte aux propriétés, et des valeurs initiales basées sur une seule valeur d’heure. AutoPopDelayThe AutomaticDelay property sets the AutoPopDelay, ReshowDelay, and InitialDelay properties to initial values based on a single time value. Chaque fois que AutomaticDelay la propriété est définie InitialDelay , la propriété est définie sur la même valeur que AutomaticDelay la propriété.Every time the AutomaticDelay property is set, the InitialDelay property is set to the same value as the AutomaticDelay property. Une fois AutomaticDelay la propriété définie, vous pouvez InitialDelay définir indépendamment la propriété, en remplaçant la valeur par défaut.Once the AutomaticDelay property is set, you can independently set the InitialDelay property, overriding the default value.

S’applique à

Voir aussi