Udostępnij za pośrednictwem

ToolTip.InitialDelay Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows.Forms
Zestaw:
System.Windows.Forms.dll

Pobiera lub ustawia czas, który upływa przed wyświetleniem etykietki narzędzia.

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

Wartość właściwości

Int32

Okres czasu, w milisekundach, że wskaźnik musi pozostać nieruchomy na kontrolce przed wyświetleniem okna Etykietka narzędzia.

Przykłady

Poniższy przykład kodu tworzy wystąpienie ToolTip klasy i kojarzy wystąpienie z Form wystąpieniem, w ramach którego jest tworzone wystąpienie. Następnie kod inicjuje właściwości AutoPopDelayopóźnienia , InitialDelayi ReshowDelay. Ponadto wystąpienie ToolTip klasy ustawia ShowAlways właściwość , aby true umożliwić wyświetlanie tekstu ToolTip niezależnie od tego, czy formularz jest aktywny. Na koniec przykład kojarzy tekst etykietki narzędzia z dwoma kontrolkami w formularzu, a Button i CheckBox. Przykładowy kod wymaga, aby metoda zdefiniowana w przykładzie znajdowała się w obiekcie Form zawierającym kontrolkę Button o nazwie i kontrolce CheckBox o nazwie checkBox1, button1 oraz że metoda jest wywoływana z konstruktora Formklasy .

// 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

Uwagi

InitialDelay Za pomocą właściwości można skrócić lub wydłużyć czas ToolTip oczekiwania przed wyświetleniem okna etykietki narzędzia. Jeśli wartość InitialDelay właściwości jest ustawiona na wartość, która jest zbyt długa w czasie trwania, użytkownik aplikacji może nie wiedzieć, że aplikacja udostępnia Pomoc etykietki narzędzi. Możesz użyć tej właściwości, aby upewnić się, że użytkownik ma wyświetlane szybko etykietki narzędzi, skracając określony czas.

Wartość tej właściwości nie może przekraczać 32767.

Jeśli chcesz mieć spójny wzorzec opóźnienia dla okien etykietek narzędzi, możesz ustawić AutomaticDelay właściwość . Właściwość AutomaticDelay ustawia AutoPopDelaywłaściwości , ReshowDelayi InitialDelay na wartości początkowe na podstawie pojedynczej wartości czasu. Za każdym razem, gdy AutomaticDelay właściwość jest ustawiana, InitialDelay właściwość jest ustawiana na taką samą wartość jak AutomaticDelay właściwość. Po ustawieniu AutomaticDelay właściwości można niezależnie ustawić InitialDelay właściwość, przesłaniając wartość domyślną.

Dotyczy

Zobacz też