ToolTip.InitialDelay 属性

获取或设置工具提示显示之前经过的时间。

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

语法

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

value = instance.InitialDelay

instance.InitialDelay = value

public int InitialDelay { get; set; }

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

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

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

public function get InitialDelay () : int

public function set InitialDelay (value : int)

属性值

工具提示窗口显示之前，指针必须在控件上保持静止的时间期限（以毫秒为单位）。

备注

InitialDelay 属性使您可以缩短或延长显示工具提示窗口前 ToolTip 等待的时间。如果 InitialDelay 属性的值设置得太长，则应用程序的用户可能会不知道应用程序提供了工具提示帮助。使用此属性，就可以确保用户通过缩短指定的时间快速显示工具提示。

此属性的值不能超过 32767。

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

示例

下面的代码示例创建一个 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 属性
ToolTip.AutoPopDelay 属性
ReshowDelay
UseFading
Popup