バージョン

WinToolTipManager をランタイムに設定

WinToolTipManager は "UltraToolTip" というエクステンダ プロパティをコントロールに追加します。UltraToolTip プロパティは、WinToolTipManager でコントロールを管理することを目的とします。これにより、マウスがコントロールの上に置かれたときにツールヒントを自動的に表示できるようになります。

  1. コードの記述を開始する前にコード ビハインドに使用/インポートのディレクティブを配置します。そうすれば、メンバは完全に記述された名前を常に入力する必要がなくなります。

Visual Basic の場合：

Imports Infragistics.Win
Imports Infragistics.Win.UltraWinToolTip

C# の場合：

using Infragistics.Win;
using Infragistics.Win.UltraWinToolTip;

  1. フォームにコントロールを配置します。

どのようなコントロールを配置してもかまいませんが、この例では TextBox を使用します。

  1. UltraToolTipManager コンポーネントをフォームに配置します。

WinToolTip Walk Through Setting Up WinToolTips At Run Time 01.png

  1. コントロールの ToolTipInfo を取得します。

WinToolTip のプロパティを設定するためには、最初にコントロールの ToolTipInfo を取得する必要があります。これには WinToolTipManager の GetUltraToolTip メソッドを使用します。次のコードを Form_Load イベントに配置します。

Visual Basic の場合：

' TextBox1 の ToolTipInfo を取得します。
Dim toolTipInfo As UltraToolTipInfo = Me.ultraToolTipManager1.GetUltraToolTip(Me.textBox1)

C# の場合：

// TextBox1 の ToolTipInfo を取得します。
UltraToolTipInfo toolTipInfo = this.ultraToolTipManager1.GetUltraToolTip(this.textBox1);

  1. ToolTipText を設定します。

ツールヒントを表示するためには、ToolTipText プロパティを何らかのテキストに設定する必要があります。次のコードを追加します。

Visual Basic の場合：

' ToolTipText を設定します。
toolTipInfo.ToolTipText = "Enter some text here."

C# の場合：

// ToolTipText を設定します。
toolTipInfo.ToolTipText = "Enter some text here.";

  1. オプションのプロパティを設定します。

ToolTipText を設定したら、ランタイムに TextBox の上にマウスを置いたときに TextBox のツールヒントが表示されます。ツールヒントにタイトルを表示する場合は、ToolTipTitle プロパティを設定します。ツールヒントのタイトルにイメージを表示する場合は、ToolTipImage を設定します。ToolTipImage には一般的なイメージを表示するオプションがあります。カスタム イメージを表示するには、ToolTipImage プロパティを Custom に設定し、Appearance.Image プロパティまたは TitleAppearance.Image プロパティを設定します。この時点で、BackColor や ForeColor などの他の Appearance プロパティも設定できます。

Visual Basic の場合：

' ToolTipTitle を設定します。
toolTipInfo.ToolTipTitle = "This is textBox1"
' イメージを適用します。
toolTipInfo.ToolTipImage = ToolTipImage.Info
' 外観を適用します。
toolTipInfo.Appearance.BackColor = Color.White
toolTipInfo.Appearance.BackColor2 = Color.Chartreuse
toolTipInfo.Appearance.BackGradientStyle = GradientStyle.Circular
toolTipInfo.Appearance.ForeColor = Color.Black
' 外観をタイトルに適用します。
toolTipInfo.ToolTipTitleAppearance.ForeColor = Color.Red

C# の場合：

// Set the ToolTipTitle
toolTipInfo.ToolTipTitle = "This is textBox1";
// イメージを適用します。
toolTipInfo.ToolTipImage = ToolTipImage.Info;
// 外観を適用します。
toolTipInfo.Appearance.BackColor = Color.White;
toolTipInfo.Appearance.BackColor2 = Color.Chartreuse;
toolTipInfo.Appearance.BackGradientStyle = GradientStyle.Circular;
toolTipInfo.Appearance.ForeColor = Color.Black;
// 外観をタイトルに適用します。
toolTipInfo.ToolTipTitleAppearance.ForeColor = Color.Red;

  1. アプリケーションを実行します。

アプリケーションを実行して TextBox の上にマウスを置きます。WinToolTipManager の InitialDelay プロパティで指定された遅延時間（デフォルトは 0.5秒）が経過した後、ツールヒントが表示されます。

WinToolTip Walk Through Setting Up WinToolTips At Run Time 02.png