ToolTip.AutoPopDelay 属性

获取或设置当指针在具有指定工具提示文本的控件内保持静止时，工具提示保持可见的时间期限。

**命名空间:**System.Windows.Forms
**程序集:**System.Windows.Forms（在 system.windows.forms.dll 中）

语法

声明
Public Property AutoPopDelay As Integer
用法
Dim instance As ToolTip
Dim value As Integer

value = instance.AutoPopDelay

instance.AutoPopDelay = value

public int AutoPopDelay { get; set; }

public:
property int AutoPopDelay {
    int get ();
    void set (int value);
}

/** @property */
public int get_AutoPopDelay ()

/** @property */
public void set_AutoPopDelay (int value)

public function get AutoPopDelay () : int

public function set AutoPopDelay (value : int)

属性值

当指针在控件上保持静止时，ToolTip 保持可见的时间期限（以毫秒为单位）。默认值为 5000。

备注

AutoPopDelay 属性使您可以缩短或延长指针位于控件上时 ToolTip 窗口的显示时间。例如，如果在工具提示窗口中显示大量帮助信息，就可以增加此属性的值，以确保用户有足够的时间阅读文本。

如果需要一致的“工具提示”窗口延迟模式，则可以设置 AutomaticDelay 属性。AutomaticDelay 属性将 AutoPopDelay、ReshowDelay 和 InitialDelay 三个属性设置为基于单个值的初始值。每次设置 AutomaticDelay 属性时，AutoPopDelay 属性就会被设置为 AutomaticDelay 属性值的 10 倍。在设置 AutomaticDelay 属性以后，就可以独立设置 AutoPopDelay 属性（重写默认值）。

弹出提示的最大可延迟时间是 5000 毫秒。如需更长的持续时间，请使用 Show 方法控制显示工具提示的精确时间。

示例

下面的代码示例创建一个 ToolTip 类的实例，并将该实例与创建它时所在的 Form 相关联。代码随后初始化延迟属性 AutoPopDelay、InitialDelay 和 ReshowDelay。另外，ToolTip 类的实例将 ShowAlways 属性设置为 true，以使工具提示文本始终显示而不管窗体是否活动。最后，该示例将工具提示文本与窗体上的 Button 和 CheckBox 这两个控件关联。本代码示例要求示例中定义的方法位于 Form 之内，而该窗体应包含一个名为 button1 的 Button 控件和一个名为 checkBox1 的 CheckBox 控件，并且要求从 Form 的构造函数中调用该方法。

' 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

// 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.
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.set_AutoPopDelay(5000);
    toolTip1.set_InitialDelay(1000);
    toolTip1.set_ReshowDelay(500);
    // Force the ToolTip text to be displayed whether or not the form
    // is active.
    toolTip1.set_ShowAlways(true);
    // Set up the ToolTip text for the Button and Checkbox.
    toolTip1.SetToolTip(this.button1, "My button1");
    toolTip1.SetToolTip(this.checkBox1, "My checkBox1");
} //Form1_Load

平台

Windows 98、Windows 2000 SP4、Windows CE、Windows Millennium Edition、Windows Mobile for Pocket PC、Windows Mobile for Smartphone、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition

.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表，请参见系统要求。

版本信息

.NET Framework

受以下版本支持：2.0、1.1、1.0

请参见

参考

ToolTip 类
ToolTip 成员
System.Windows.Forms 命名空间
ToolTip.AutomaticDelay 属性
InitialDelay
ReshowDelay
UseFading
Popup