ToolTip クラス

定義

public ref class ToolTip sealed : System::ComponentModel::Component, System::ComponentModel::IExtenderProvider

public ref class ToolTip : System::ComponentModel::Component, System::ComponentModel::IExtenderProvider

public sealed class ToolTip : System.ComponentModel.Component, System.ComponentModel.IExtenderProvider

public class ToolTip : System.ComponentModel.Component, System.ComponentModel.IExtenderProvider

type ToolTip = class
    inherit Component
    interface IExtenderProvider

Public NotInheritable Class ToolTip
Inherits Component
Implements IExtenderProvider

Public Class ToolTip
Inherits Component
Implements IExtenderProvider

継承

Object

MarshalByRefObject

Component

ToolTip

実装

IExtenderProvider

例

次のコード例では、 クラスのインスタンスを ToolTip 作成し、インスタンス Form をインスタンスが作成された に関連付けます。 次に、遅延プロパティ AutoPopDelay、、 InitialDelayおよび ReshowDelayを初期化します。 さらに、 クラスの ToolTip インスタンスは、 プロパティを ShowAlways に true 設定して、フォームがアクティブかどうかに関係なく、ツールヒント テキストを常に表示できるようにします。 最後に、ツールヒント テキストをフォーム Button の 2 つのコントロール ( と CheckBox) に関連付けます。 コード例では、この例で定義されているメソッドが、 という名前のコントロールと checkBox1CheckBox という名前button1のコントロールを含む Button 内Formにあり、 メソッドが の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 使用すると、ユーザーがコントロールにポインターを置いたときにヒントをユーザーに提供できます。 クラスは ToolTip 、通常、コントロールの意図した使用方法をユーザーに警告するために使用されます。 たとえば、名前を受け入れるコントロールに ToolTip TextBox テキストを指定し、コントロールに入力する名前の形式を指定できます。 ヒントの提供に加えて、 クラスを ToolTip 使用して実行時の状態情報を提供することもできます。 たとえば、 クラスを ToolTip 使用すると、ユーザーがインターネット接続状態を表示するコントロールに PictureBox ポインターを移動したときに、接続速度と回線品質データを表示できます。

クラスは ToolTip 、任意のコンテナーで使用できます。 コンテナーを明示的に指定するには、 コンストラクターを ToolTip(IContainer) 使用します。 通常、1 つの ToolTip コンポーネントを使用して、1 つのフォーム上に複数のコントロールのツールヒントを作成します。 を作成した後、 ToolTipメソッドを個別に呼び出して SetToolTip 、ツールヒント表示テキストを個々のコントロールに関連付けます。 次に、ユーザーがコントロール上でポインターを移動すると、テキストを含むツールヒントが表示されます。 同じコントロールに対して複数回を呼び出 SetToolTip して、コントロールに関連付けられているテキストを変更できます。 コントロールに関連付けられているテキストを取得するには、 メソッドを使用します GetToolTip 。 クラスのインスタンスとのすべての ToolTip テキストの ToolTip 関連付けを削除するには、 メソッドを使用します RemoveAll 。

クラスには ToolTip 、ツールヒントの既定の動作と外観を変更するための次のプロパティとメソッドが用意されています。

アプリケーションに表示できないようにすべてのツールヒント テキストを無効にする場合は、 プロパティを Active 使用できます。 通常、ツールヒントはオペレーティング システムによって描画されますが、 の ToolTip外観をカスタマイズするために、 プロパティを OwnerDraw に true 設定し、イベントを Draw 処理できます。

クラスは ToolTipTitle 、 インターフェイスを System.ComponentModel.IExtenderProvider 実装します。このインターフェイスには、 という 1 つのメソッドがあります CanExtend。 ツールヒントは、デザイン時に同じフォーム上のコントロールを拡張し、プロパティを ToolTip 追加します。 エクステンダー プロバイダーの詳細については、「 エクステンダー プロバイダー」を参照してください。

コンストラクター

プロパティ

メソッド

イベント

適用対象

こちらもご覧ください

• ToolTipIcon
• HelpProvider
• 拡張プロバイダー
• ToolTip コンポーネント (Windows フォーム)