ToolTip.InitialDelay ToolTip.InitialDelay ToolTip.InitialDelay ToolTip.InitialDelay Property

定义

获取或设置工具提示显示之前经过的时间。Gets or sets the time that passes before the ToolTip appears.

public:
 property int InitialDelay { int get(); void set(int value); };
public int InitialDelay { get; set; }
member this.InitialDelay : int with get, set
Public Property InitialDelay As Integer

属性值

工具提示窗口显示之前,指针必须在控件上保持静止的时间期限(以毫秒为单位)。The period of time, in milliseconds, that the pointer must remain stationary on a control before the ToolTip window is displayed.

示例

下面的代码示例创建ToolTip类的一个实例, 并将该实例Form与在其中创建该实例的关联。The following code example creates an instance of the ToolTip class and associates the instance with the Form that the instance is created within. 然后, 该代码初始化延迟属性AutoPopDelayInitialDelayReshowDelayThe code then initializes the delay properties AutoPopDelay, InitialDelay, and ReshowDelay. 此外, ToolTip类的实例ShowAlways将属性设置为true , 以启用显示工具提示文本, 而不考虑窗体是否处于活动状态。In addition the instance of the ToolTip class sets the ShowAlways property to true to enable ToolTip text to be displayed regardless of whether the form is active. 最后, 该示例将工具提示文本与窗体上的Button两个控件 ( CheckBox和) 相关联。Finally, the example associates ToolTip text with two controls on a form, a Button and a CheckBox. 此代码示例要求在示例中定义的Form方法位于Button包含名为button1的控件和CheckBoxcheckBox1,为的控件以及从构造函数中调用方法的FormThe code example requires that the method defined in the example is located within a Form that contains a Button control named button1 and a CheckBox control named checkBox1, and that the method is called from the constructor of the 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

注解

使用属性, 可以缩短或延长在ToolTip显示工具提示窗口之前等待的时间。 InitialDelayWith the InitialDelay property, you can shorten or lengthen the time that the ToolTip waits before displaying a ToolTip window. 如果将InitialDelay属性的值设置为长度过长的值, 应用程序的用户可能不知道您的应用程序提供工具提示帮助。If the value of the InitialDelay property is set to a value that is too long in duration, the user of your application might not know that your application provides ToolTip Help. 您可以使用此属性来确保用户通过缩短指定的时间快速显示工具提示。You can use this property to ensure that the user has ToolTips displayed quickly by shortening the time specified.

此属性的值不能超过32767。The value for this property cannot exceed 32767.

如果要为 "工具提示" 窗口设置一致的延迟模式, 可以设置AutomaticDelay属性。If you want to have a consistent delay pattern for your ToolTip windows, you can set the AutomaticDelay property. 属性根据单个时间AutoPopDelayReshowDelay将、 InitialDelay和属性设置为初始值。 AutomaticDelayThe AutomaticDelay property sets the AutoPopDelay, ReshowDelay, and InitialDelay properties to initial values based on a single time value. 每次设置AutomaticDelay此属性时InitialDelay , 都将属性设置为与AutomaticDelay属性相同的值。Every time the AutomaticDelay property is set, the InitialDelay property is set to the same value as the AutomaticDelay property. 设置属性后, 可以单独InitialDelay设置属性, 重写默认值。 AutomaticDelayOnce the AutomaticDelay property is set, you can independently set the InitialDelay property, overriding the default value.

适用于

另请参阅