ToolTip.AutoPopDelay Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient ou définit la période pendant laquelle l’info-bulle reste visible si le pointeur est stationnaire sur un contrôle avec du 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, setPublic Property AutoPopDelay As IntegerValeur de propriété
Période, en millisecondes, que le ToolTip pointeur reste visible quand le pointeur est stationnaire sur un contrôle. Sur Windows 11, la valeur par défaut entraîne l’affichage indéfini de l’info-bulle.
Exemples
L’exemple de code suivant crée une instance de la ToolTip classe et associe l’instance à celle Form dans laquelle l’instance est créée. Le code initialise ensuite les propriétés AutoPopDelayde délai, InitialDelayet ReshowDelay. En outre, l’instance de la ToolTip classe définit la ShowAlways propriété pour permettre au true texte Info-bulle d’être affiché, que le formulaire soit actif ou non. Enfin, l’exemple associe du texte info-bulle à deux contrôles sur un formulaire, un Button et un CheckBox. L’exemple de code nécessite que la méthode définie dans l’exemple se trouve dans un Form contrôle 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 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 le temps d’affichage de la ToolTip fenêtre lorsque le pointeur se trouve sur un contrôle. Par exemple, si vous affichez une aide étendue dans une fenêtre Info-bulle, vous pouvez augmenter la valeur de cette propriété pour vous assurer que l’utilisateur a suffisamment de temps pour lire le texte.
Si vous souhaitez avoir un modèle de délai cohérent pour vos fenêtres Info-bulle, vous pouvez définir la AutomaticDelay propriété. La AutomaticDelay propriété définit les AutoPopDelayvaleurs initiales , ReshowDelayet InitialDelay les propriétés en fonction d’une seule valeur. 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.
Le comportement de cette propriété varie selon la version de Windows :
- Sur Windows 10, la durée maximale pendant laquelle vous pouvez retarder une fenêtre contextuelle est de 5 000 millisecondes. Les valeurs supérieures à 5 000 ms sont limitées à 5 000 ms.
- Sur Windows 11, la valeur par défaut entraîne l’affichage indéfini des info-bulles. Lorsqu’elle est définie sur une valeur personnalisée, il n’y a pas de limite de 5 000 ms et l’info-bulle s’affiche pour la durée spécifiée.
Pour des durées plus longues ou un contrôle précis sur le moment où l’info-bulle est affichée, utilisez la Show méthode.
