Partager via

ToolTip.AutoPopDelay Propriété

  • Référence

Définition

Espace de noms:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

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é.

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

Valeur de propriété

Int32

La durée d'affichage, en millisecondes, de ToolTip lorsque le pointeur de la souris s'immobilise sur un contrôle. La valeur par défaut est 5000.

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 l’affichage du texte d’info-bulle, 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

La AutoPopDelay propriété vous permet de raccourcir ou d’allonger la durée d’affichage de la ToolTip fenêtre lorsque le pointeur se trouve sur un contrôle. Par exemple, si vous affichez une aide détaillée dans une fenêtre d’info-bulle, vous pouvez augmenter la valeur de cette propriété pour vous assurer que l’utilisateur dispose de suffisamment de temps pour lire le texte.

Si vous souhaitez avoir un modèle de délai cohérent pour vos fenêtres d’info-bulle, vous pouvez définir la AutomaticDelay propriété . La AutomaticDelay propriété définit les AutoPopDelaypropriétés , ReshowDelayet InitialDelay sur des valeurs initiales basées sur une valeur unique. Chaque fois que la AutomaticDelay propriété est définie, la AutoPopDelay propriété est définie sur 10 fois la valeur de la AutomaticDelay propriété. Une fois la AutomaticDelay propriété définie, vous pouvez définir la AutoPopDelay propriété indépendamment, en remplaçant la valeur par défaut.

La durée maximale pendant laquelle vous pouvez retarder une fenêtre contextuelle est de 5 000 millisecondes. Pour des durées plus longues, utilisez la Show méthode pour contrôler le moment exact où l’info-bulle est affichée.

S’applique à

Voir aussi