ToolTip.InitialDelay Свойство

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Исходный код:

ToolTip.cs

Возвращает или задает время, которое проходит до появления подсказки.

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

Значение свойства

Int32

Период времени в миллисекундах, который указатель должен оставаться на месте элемента управления перед отображением окна подсказки.

Примеры

В следующем примере кода создается экземпляр класса и связывается экземпляр ToolTip с Form созданным экземпляром. Затем код инициализирует свойства AutoPopDelayзадержки и InitialDelayReshowDelay. Кроме того, экземпляр ToolTip класса задает ShowAlways свойство для true включения отображения текста подсказки независимо от того, активна ли форма. Наконец, в примере сопоставляется текст подсказки с двумя элементами управления в форме, a Button и a CheckBox. В примере кода требуется, чтобы метод, определенный в примере, находится в Form пределах элемента Button управления с именем button1 и именем checkBox1, элемента управления, а CheckBox метод вызывается из конструктора.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

Комментарии

InitialDelay С помощью свойства можно сократить или продлить время ToolTip ожидания перед отображением окна подсказки. Если для свойства задано значение InitialDelay , которое слишком долгое время, пользователь приложения может не знать, что ваше приложение предоставляет справку по подсказкам. Это свойство можно использовать, чтобы убедиться, что у пользователя есть подсказки, отображаемые быстро, сокращая указанное время.

Значение этого свойства не может превышать 32767.

Если вы хотите иметь согласованный шаблон задержки для окон подсказки, можно задать AutomaticDelay свойство. Свойство AutomaticDelay задает AutoPopDelayзначения , ReshowDelayа InitialDelay свойства — начальным значениям на основе одного значения времени. Каждый раз, когда AutomaticDelay свойство задано, свойство имеет то же значение, InitialDelay что AutomaticDelay и свойство. AutomaticDelay После установки свойства можно самостоятельно задать InitialDelay свойство, переопределив значение по умолчанию.

См. также раздел

• AutomaticDelay
• AutoPopDelay
• ReshowDelay
• UseFading
• Popup