ToolTip.ReshowDelay プロパティ
マウス ポインタが 1 つのコントロールから別のコントロールに移動するのに合わせて、後続のツール ヒント ウィンドウを表示するまでに、経過する必要がある時間の長さを取得または設定します。
Public Property ReshowDelay As Integer
[C#]
public int ReshowDelay {get; set;}
[C++]
public: __property int get_ReshowDelay();public: __property void set_ReshowDelay(int);
[JScript]
public function get ReshowDelay() : int;public function set ReshowDelay(int);
プロパティ値
後続のツール ヒント ウィンドウを表示するまでにかかる時間 (ミリ秒単位)。
解説
このプロパティを使用すると、前のツール ヒント ウィンドウを表示してから次のツール ヒント ウィンドウを表示するまでに ToolTip が待機する時間を短くしたり、長くしたりできます。ツール ヒント ウィンドウが初めて表示されるときは、 InitialDelay プロパティの値を使用して、そのツール ヒント ウィンドウを初めて表示する前に適用する遅延が決定されます。ツール ヒント ウィンドウが現在表示されており、ツール ヒント ウィンドウを表示する別のコントロールにユーザーがカーソルを移動する場合は、新しいコントロールのツール ヒントが表示される前に ReshowDelay プロパティの値が使用されます。 ReshowDelay プロパティで指定した遅延を使用するには、前のコントロールのツール ヒント ウィンドウを表示しておく必要があります。それ以外の場合は、 InitialDelay プロパティ値が使用されます。
ツール ヒント ウィンドウに一貫した遅延パターンを設定する場合は、 AutomaticDelay プロパティを設定します。 AutomaticDelay プロパティは、 AutoPopDelay 、 ReshowDelay 、 InitialDelay の各プロパティを単一の値に基づいた初期値に設定します。 AutomaticDelay プロパティを設定するたびに、 ReshowDelay プロパティは AutomaticDelay プロパティ値の 1/5 の値に設定されます。 AutomaticDelay プロパティを設定すると、既定値をオーバーライドして、個別に ReshowDelay プロパティを設定できます。
使用例
[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 | InitialDelay | AutoPopDelay