ToolTip.AutoPopDelay Свойство

Определение

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

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Возвращает или задает интервал времени, в течение которого всплывающая подсказка отображается на экране, когда указатель мыши останавливается в границах элемента управления с текстом данной подсказки.

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

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

Int32

Интервал времени, в миллисекундах, в течение которого подсказка ToolTip остается видимой, когда указатель мыши останавливается на элементе управления. По умолчанию используется значение 5000.

Примеры

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

Комментарии

Свойство AutoPopDelay позволяет сократить или удлинить время ToolTip отображения окна при наложении указателя на элемент управления. Например, если в окне подсказки отображается обширная справка, можно увеличить значение этого свойства, чтобы у пользователя было достаточно времени для чтения текста.

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

Максимальное время задержки всплывающего окна составляет 5000 миллисекундах. В течение более длительного Show времени используйте метод для управления точным моментом отображения подсказки.

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

• AutomaticDelay
• InitialDelay
• ReshowDelay
• UseFading
• Popup