ToolTip.AutoPopDelay Свойство

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

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

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

Примеры

В следующем примере кода создается экземпляр класса и связывается экземпляр 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

Комментарии

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

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

Поведение этого свойства зависит от версии Windows:

• В Windows 10 максимальное время, когда всплывающее окно может быть отложено в 5000 миллисекундах. Значения, превышающие 5000 мс, зажаты до 5000 мс.
• В Windows 11 значение по умолчанию приводит к тому, что подсказки остаются видимыми на неопределенный срок. Если задано настраиваемое значение, ограничение в 5000 мс отсутствует, а подсказка отображается в течение указанной длительности.

Для длительной длительности или точного управления при отображении подсказки используйте Show этот метод.

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

• AutomaticDelay
• InitialDelay
• ReshowDelay
• UseFading
• Popup