＠IT
アジャイル/DevOps
Insider.NET
Windowsフォームでツールチップを表示するには？：...

Windowsフォームでツールチップを表示するには？：.NET TIPS

» 2005年10月21日 05時00分公開

[一色政彦，デジタルアドバンテージ]

印刷

通知

連載「％」の新着をメールで通知

鬯ｮ�ｫ驕ｨ繧托ｽｽ�ｹ隴趣ｽ｢�ｽ�ｽ�ｽ�ｽPost

Shareシェア

はてなブックマーク

SharePocket Button

この記事は会員限定です。会員登録（無料）すると全てご覧いただけます。

連載目次

2005/10/27 更新

　Windowsアプリケーションでは、コントロール上にマウス・カーソルを乗せて静止したまま少し時間（デフォルトでは0.5秒）がたつと、そのカーソル付近に「ツールチップ」（もしくは「ツールヒント」）と呼ばれる黄色い小さなウィンドウが表示されることがある。

　例えば次のサンプル・アプリケーションでは、ボタンにマウス・カーソルを乗せると、「ツールチップです。」という文字列のツールチップが表示される。

ツールチップを表示するサンプル・アプリケーション
［button1］というButtonコントロール上にマウス・カーソルを乗せると、「ツールチップです。」という文字列のツールチップが表示される。

　このようなツールチップを表示するには、ToolTipコンポーネント（System.Windows.Forms名前空間）を利用すればよい。具体的な利用手順は、以下のとおりだ。

ToolTipコンポーネントのインスタンス化

　まず次のコード例のように、Windowsフォームのクラス内でToolTipコンポーネントをフィールド変数としてインスタンス化する。

private ToolTip toolTip1;
public Form1()
{
toolTip1 = new ToolTip();
}

Friend WithEvents ToolTip1 As ToolTip
Public Sub New()
MyBase.New()
ToolTip1 = New ToolTip()
End Sub

ToolTipコンポーネントのインスタンス化（上：C#、下：VB.NET）

　なおインスタンス化の際、ToolTipクラスのコンストラクタにIContainerインターフェイス（System.ComponentModel名前空間）のオブジェクトを指定してもよい。IContainerオブジェクトはリソース破棄の仕組みで用いられるものである。詳しくは「連載：実例で学ぶWindowsプログラミング」の「コード上の重要な変化（リソース破棄の仕組み）」の項を参照してほしい。

　このToolTipコンポーネントのインスタンス化は、Visual Studio .NET（以降、VS.NET）を利用すれば、次の画面の例のようにWindowsフォーム・デザイナでToolTipコンポーネントをドラッグ＆ドロップするだけで済み、自らコーディングを行う必要はない。

VS.NETによるToolTipコンポーネントのインスタンス化
ToolTipコンポーネントのインスタンス化はVS.NETを利用すればとても簡単。
　（1）［ツールボックス］ウィンドウの［Windows フォーム］カテゴリにある「ToolTip」をWindowsフォーム上にドラッグ＆ドロップする。
　（2）すると、インスタンス化されたToolTipコンポーネント（この例では「toolTip1」）がWindowsフォーム・デザイナ下部のコンポーネント領域に表示される。これでToolTipコンポーネントのインスタンス化は終了だ。

　次に、インスタンス化したToolTipコンポーネント（以降、ToolTipオブジェクト）に対してツールチップの設定を行う。

ツールチップの設定

　ある1つのコントロールにツールチップを設定するために必要な情報は、「ツールチップを設定するコントロール」（本稿の例ではボタン）と、「ツールチップの表示文字列」の2つだ。

　この2つをパラメータに指定して、ToolTipオブジェクトのSetToolTipメソッドを呼び出せば、ツールチップの設定は完了だ。具体的には次のようなコードになる。

private void Form1_Load(object sender, System.EventArgs e)
{
toolTip1.SetToolTip(button1, "ツールチップです。");
}

Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load
ToolTip1.SetToolTip(Button1, "ツールチップです。")
End Sub

ツールチップの設定（上：C#、下：VB.NET）

　複数のコントロールでツールチップを表示したい場合には、以上の設定をコントロールごとに行う必要がある（つまり、コントロールごとにSetToolTipメソッドを呼び出す必要がある）。

　この設定もVS.NETなら、次の画面のように［プロパティ］ウィンドウから手軽に行うことができる。

VS.NETによるツールチップの設定
VS.NETの［プロパティ］ウィンドウを使えばツールチップ文字列の設定も簡単だ。なお以下の手順は、ツールチップを表示したいすべてのコントロールに対して行う必要がある。
　（1）ツールチップを表示したいコントロールを選択する。
　（2）［＜ToolTipオブジェクト名＞の ToolTip］プロパティに表示したい文字列を設定する。本稿の例では、［toolTip1 の ToolTip］プロパティに「ツールチップです。」という文字列を設定した。

　以上のコードを実装し、ビルドして実行すると、冒頭のサンプル・アプリケーションのようなツールチップが表示される。