ToolTip.AutoPopDelay プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

ToolTip.AutoPopDelay プロパティ

ツールヒントテキストが指定されたコントロール上でポインタが静止している場合に、ツールヒントが表示される時間を取得または設定します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Property AutoPopDelay As
 Integer

Visual Basic (使用法)

Dim instance As ToolTip
Dim value As Integer

value = instance.AutoPopDelay

instance.AutoPopDelay = value

public int AutoPopDelay { get;
 set; }

C++

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

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

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

JScript

public function get AutoPopDelay
 () : int

public function set AutoPopDelay
 (value : int)

プロパティ値
コントロール上でポインタが静止している場合に、ToolTip が表示される時間 (ミリ秒単位)。既定値は、5000 です。

解説

AutoPopDelay プロパティを使用すると、ポインタがコントロール上にあるときに ToolTip ウィンドウが表示される時間を短くしたり、長くしたりできます。たとえば、ツールヒントウィンドウに詳細なヘルプを表示する場合は、このプロパティの値を大きくして、テキストを読むための十分な時間をユーザーに与えることができます。

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

ポップアップの最長遅延時間は 5000 ミリ秒です。遅延時間をこれよりも長くするには、Show メソッドを使用して、ツールヒントを表示する正確なタイミングを制御します。

使用例

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

Visual Basic

' 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");
}

C++

// 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