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. 次に、このコードは、 AutoPopDelay遅延InitialDelayプロパティ、 ReshowDelay、およびを初期化します。The 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. 最後に、フォームの2つのコントロール ( Button CheckBoxおよび) にツールヒントテキストを関連付けます。Finally, the example associates ToolTip text with two controls on a form, a Button and a CheckBox. このコード例では、例で定義されているメソッドがForm 、というButton名前のbutton1コントロールCheckBoxとというcheckBox1,名前のコントロールを含む内にあり、メソッドがのコンストラクターから呼び出されることが必要です。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. プロパティAutomaticDelay AutoPopDelayは、1つReshowDelayの時刻値に基づいて、、、およびInitialDelayの各プロパティを初期値に設定します。The AutomaticDelay property sets the AutoPopDelay, ReshowDelay, and InitialDelay properties to initial values based on a single time value. プロパティが設定されるたびにInitialDelay 、プロパティはプロパティとAutomaticDelay同じ値に設定されます。 AutomaticDelayEvery 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.

適用対象

こちらもご覧ください