ToolTip.AutoPopDelay Eigenschaft

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft die Zeitspanne ab, während der die QuickInfo sichtbar bleibt, wenn der Zeiger auf einem Steuerelement mit angegebenem QuickInfo-Text nicht bewegt wird, oder legt diese Zeitspanne fest.

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

Int32

Die Zeitspanne in Millisekunden, während der der ToolTip sichtbar bleibt, wenn der Zeiger auf einem Steuerelement nicht bewegt wird. Der Standardwert lautet 5000.

Beispiele

Im folgenden Codebeispiel wird eine Instanz der ToolTip -Klasse erstellt und der Instanz Form zugeordnet, in der 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 auf fest true , damit 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 zu, einem Button und einem CheckBox. Das Codebeispiel erfordert, dass sich die im Beispiel definierte Methode in einem Form befindet, das ein Button Steuerelement mit dem Namen button1 und ein CheckBox Steuerelement namens checkBox1, enthält, und dass die -Methode vom Konstruktor des Formaufgerufen wird.

// 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 AutoPopDelay der -Eigenschaft können Sie die Zeit verkürzen oder verlängern, in 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 genügend Zeit zum Lesen des Texts hat.

Wenn Sie ein konsistentes Verzögerungsmuster für Ihre QuickInfo-Fenster haben möchten, können Sie die AutomaticDelay -Eigenschaft festlegen. Die AutomaticDelay -Eigenschaft legt die AutoPopDelayEigenschaften , ReshowDelayund InitialDelay auf Basis eines einzelnen Werts auf Anfangswerte fest. Jedes Mal, wenn die AutomaticDelay Eigenschaft festgelegt wird, wird die AutoPopDelay Eigenschaft auf das 10-fache des AutomaticDelay Eigenschaftswerts festgelegt. Sobald die AutomaticDelay Eigenschaft festgelegt ist, können Sie die AutoPopDelay Eigenschaft unabhängig festlegen und den Standardwert überschreiben.

Die maximale Zeit, die Sie ein Popup verzögern können, beträgt 5000 Millisekunden. Verwenden Sie für längere Zeiträume die Show -Methode, um den genauen Zeitpunkt zu steuern, zu dem die QuickInfo angezeigt wird.

Gilt für:

Freigeben über