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。 此外， 类的 ToolTip 实例将 ShowAlways 属性设置为 ， true 以便无论窗体是否处于活动状态，都可以显示工具提示文本。 最后，该示例将工具提示文本与窗体上的两个控件（和 ButtonCheckBox）相关联。 代码示例要求示例中定义的方法位于包含Button名为 的控件和CheckBox名为 checkBox1,button1 的控件的 中Form，并且该方法是从 的构造函数中调用的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属性都设置为属性值的 AutomaticDelay 10 倍。 AutomaticDelay设置属性后，可以独立设置 AutoPopDelay 属性，重写默认值。

可以延迟弹出窗口的最长时间为 5000 毫秒。 对于较长的持续时间，请使用 Show 方法控制显示工具提示的确切时刻。

另请参阅

• AutomaticDelay
• InitialDelay
• ReshowDelay
• UseFading
• Popup