ToolTip.InitialDelay Eigenschaft

  • Referenz

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Ruft die bis zum Anzeigen der QuickInfo verstreichende Zeit ab oder legt diese fest.

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

Eigenschaftswert

Int32

Die Zeitspanne in Millisekunden, in der der Zeiger auf einem Steuerelement nicht bewegt werden darf, bevor das QuickInfo-Fenster angezeigt wird.

Beispiele

Im folgenden Codebeispiel wird eine Instanz der ToolTip Klasse erstellt und der Instanz die 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 fest, true um ToolTip-Text anzuzeigen, unabhängig davon, ob das Formular aktiv ist. Schließlich verknüpft das Beispiel QuickInfo-Text mit zwei Steuerelementen in einem Formular, einer Button und einem CheckBox. Das Codebeispiel erfordert, dass die in dem Beispiel definierte Methode sich in einem Form Steuerelement befindet, das ein Steuerelement mit dem Namen und einem Button CheckBox Steuerelement checkBox1, enthältbutton1, das benannt ist und dass die Methode vom Konstruktor des .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 InitialDelay Eigenschaft können Sie die Zeit, die die ToolTip Wartezeit vor dem Anzeigen eines QuickInfo-Fensters anzeigt, kürzen oder verlängern. Wenn der Wert der InitialDelay Eigenschaft auf einen Wert festgelegt ist, der zu lang ist, weiß der Benutzer Ihrer Anwendung möglicherweise nicht, dass Ihre Anwendung ToolInfo-Hilfe bereitstellt. Sie können diese Eigenschaft verwenden, um sicherzustellen, dass der Benutzer ToolInfos schnell angezeigt hat, indem Sie die angegebene Zeit kürzen.

Der Wert für diese Eigenschaft darf nicht 32767 überschreiten.

Wenn Sie über ein konsistentes Verzögerungsmuster für Ihre QuickInfo-Fenster verfügen möchten, können Sie die AutomaticDelay Eigenschaft festlegen. Die AutomaticDelay Eigenschaft legt die AutoPopDelayWerte ReshowDelayund InitialDelay Eigenschaften auf basis eines einzelnen Zeitwerts fest. Jedes Mal, wenn die Eigenschaft festgelegt wird, wird die AutomaticDelay InitialDelay Eigenschaft auf denselben Wert wie die AutomaticDelay Eigenschaft festgelegt. Nachdem die AutomaticDelay Eigenschaft festgelegt wurde, können Sie die InitialDelay Eigenschaft unabhängig festlegen und den Standardwert außer Kraft setzen.

Gilt für

Siehe auch