ToolTip.AutoPopDelay Eigenschaft

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

Eigenschaftswert

Die Zeitspanne in Millisekunden, die ToolTip sichtbar bleibt, wenn der Zeiger auf einem Steuerelement stationiert ist. Unter Windows 11 bewirkt der Standardwert, dass die QuickInfo unbegrenzt sichtbar bleibt.

Beispiele

Im folgenden Codebeispiel wird eine Instanz der ToolTip Klasse erstellt und der Instanz zugeordnet, in der Form die Instanz erstellt wird. Der Code initialisiert dann die Verzögerungseigenschaften AutoPopDelay, InitialDelayund ReshowDelay. Darüber hinaus legt die Instanz der ToolTip Klasse die ShowAlways Eigenschaft so fest, dass true QuickInfo-Text unabhängig davon angezeigt werden kann, ob das Formular aktiv ist. Schließlich ordnet das Beispiel QuickInfo-Text zwei Steuerelementen in einem Formular, einem Button und einem Steuerelement CheckBoxzu. Das Codebeispiel erfordert, dass sich die im Beispiel definierte Methode in einem Form Steuerelement befindet, das ein Button Steuerelement namens button1 und ein CheckBox Steuerelement mit dem Namen checkBox1, enthält und dass die Methode vom Konstruktor der .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

Hinweise

Mit der AutoPopDelay Eigenschaft können Sie die Zeit verkürzen oder verlängern, zu der das ToolTip Fenster angezeigt wird, wenn sich der Zeiger auf einem Steuerelement befindet. Wenn Sie beispielsweise umfangreiche Hilfe in einem QuickInfo-Fenster anzeigen, können Sie den Wert dieser Eigenschaft erhöhen, um sicherzustellen, dass der Benutzer ausreichend Zeit zum Lesen des Texts hat.

Wenn Sie ein einheitliches Verzögerungsmuster für Ihre QuickInfo-Fenster haben möchten, können Sie die AutomaticDelay Eigenschaft festlegen. Die AutomaticDelay Eigenschaft legt die AutoPopDelayAnfangswerte ReshowDelayund InitialDelay Die Eigenschaften basierend auf einem einzelnen Wert fest. Jedes Mal, wenn die AutomaticDelay Eigenschaft festgelegt wird, wird die AutoPopDelay Eigenschaft auf 10 mal den AutomaticDelay Eigenschaftswert festgelegt. Nachdem die AutomaticDelay Eigenschaft festgelegt wurde, können Sie die AutoPopDelay Eigenschaft unabhängig festlegen und den Standardwert überschreiben.

Das Verhalten dieser Eigenschaft variiert je nach Windows-Version:

• Unter Windows 10 beträgt die maximale Zeit, mit der Sie ein Popup verzögern können, 5000 Millisekunden. Werte größer als 5000 ms werden auf 5000 ms geklemmt.
• Unter Windows 11 bewirkt der Standardwert, dass QuickInfos unbegrenzt sichtbar bleiben. Wenn sie auf einen benutzerdefinierten Wert festgelegt ist, gibt es keinen Grenzwert von 5000 ms, und die QuickInfo wird für die angegebene Dauer angezeigt.

Verwenden Sie Show die Methode, wenn die QuickInfo angezeigt wird, für längere Dauer oder präzise Kontrolle.

Weitere Informationen

• AutomaticDelay
• InitialDelay
• ReshowDelay
• UseFading
• Popup