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

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

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

ToolTip.InitialDelay プロパティ

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

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

Visual Basic (宣言)

Public Property InitialDelay As
 Integer

Visual Basic (使用法)

Dim instance As ToolTip
Dim value As Integer

value = instance.InitialDelay

instance.InitialDelay = value

public int InitialDelay { get;
 set; }

C++

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

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

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

JScript

public function get InitialDelay
 () : int

public function set InitialDelay
 (value : int)

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

解説

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

このプロパティの最大値は 32767 です。

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

使用例

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