ToolTip.InitialDelay プロパティ

ツール ヒントが表示されるまでに経過する時間を取得または設定します。

Public Property InitialDelay As Integer
[C#]
public int InitialDelay {get; set;}
[C++]
public: __property int get_InitialDelay();public: __property void set_InitialDelay(int);
[JScript]
public function get InitialDelay() : int;public function set InitialDelay(int);

プロパティ値

ツール ヒント ウィンドウが表示されるまでに、マウス ポインタがコントロール内で静止する必要のある時間 (ミリ秒単位)。

解説

このプロパティを使用すると、 ToolTip がツール ヒント ウィンドウを表示するまでに待機する時間を短くしたり、長くしたりできます。 InitialDelay プロパティの設定値が長すぎると、アプリケーションにツール ヒント ヘルプが表示されることに、アプリケーションのユーザーが気付かない可能性があります。このプロパティを使用して、指定時間を短くすることにより、ユーザーにすばやくツール ヒントを表示できます。

ツール ヒント ウィンドウに一貫した遅延パターンを設定する場合は、 AutomaticDelay プロパティを設定します。 AutomaticDelay プロパティは、 AutoPopDelay 、 ReshowDelay 、 InitialDelay の各プロパティを単一の値に基づいた初期値に設定します。 AutomaticDelay プロパティを設定するたびに、 InitialDelay プロパティは AutomaticDelay プロパティと同じ値に設定されます。 AutomaticDelay プロパティを設定すると、既定値をオーバーライドして、個別に InitialDelay プロパティを設定できます。

使用例

[Visual Basic, C#, C++] ToolTip クラスのインスタンスを作成し、そのインスタンスが内部に作成された Form に関連付ける例を次に示します。次に、このコードは AutoPopDelay 、 InitialDelay 、 ReshowDelay の各遅延プロパティを初期化します。また、 ToolTip クラスのインスタンスで ShowAlways プロパティを true に設定して、フォームがアクティブかどうかに関係なく、ツール ヒント テキストが表示されるようにします。最後に、ツール ヒント テキストをフォーム上の 2 つのコントロール Button および CheckBox に関連付けます。この例は、コード内で定義されたメソッドが button1 という名前の Button コントロールおよび checkBox1 という名前の CheckBox コントロールを含む Form 内に配置されており、その 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

[C#] 
// 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");
}

[C++] 
// 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, S"My button1");
   toolTip1->SetToolTip(this->checkBox1, S"My checkBox1");
}

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

参照

ToolTip クラス | ToolTip メンバ | System.Windows.Forms 名前空間 | AutomaticDelay | ReshowDelay | AutoPopDelay