Menus and Toolbars for WinForms
メニューのツールチップ
メニューとツールバーの概要 > メニューの外観と動作 > メニューのツールチップ

ツールチップは、マウスがコントロール上に置くときにテキストを表示するために使用されます。 C1MainMenu クラスは、ShowToolTips プロパティを提供して、メニュー項目にマウスカーソルを置くときにツールチップテキストを表示できるかどうかを示します。デフォルトでは、このプロパティは 「false 」です。

ShowToolTips プロパティを「 true」 に設定すると、メニュー項目の Text プロパティの値がツールチップとして表示されます。たとえば、メインメニューに「File」としてテキスト値を持つメニュー項目がある場合、ツールチップは次のように表示されます。

Cursor over menu

各メニュー項目のツールチップとしてカスタム テキストを設定することもできます。これを行うには、 ShowTextAsToolTip プロパティを「False」 に設定し、ToolTipText プロパティを使用してカスタムテキストを設定します。たとえば、テキスト値が「File」で、ツールチップテキストが「View File」に設定されたメニュー項目がある場合、ツールチップは次のように表示されます。

Cursor over menu

ツールチップ テキストを表示するには、次のコードを使用します。

C#
コードのコピー
C1CommandMenu mmenu = ch.CreateCommand(typeof(C1CommandMenu)) as C1CommandMenu;
mmenu.Text = "File";
mmenu.ShowTextAsToolTip = false;
mmenu.ToolTipText = "View file";

ツールチップのフォントを指定する

MainMenu コントロールのプレーン テキスト ツールチップを表示できますが、ツールチップを豊富なHTML テキストで表示したり、異なるフォントを使用したりすることもできます。このようなツールチップを表示するには、MainMenu の外部 SuperTooltipコントロールを取得する C1MainMenu クラスの SuperTooltip プロパティを使用します。

次の画像は、「File」 メニューにカーソルを合わせると表示されるsupertooltipを示しています。

Tooltip over menu

SuperTooltip を構成する手順は次のとおりです。

  1. C1.Win.SuperTooltip パッケージをインストールします。
  2. SuperTooltip コンポーネントをフォームにドラッグ アンド ドロップします。
  3. Properties ウィンドウで、MainMenu コントロールの SuperTooltip プロパティのドロップダウン メニューから SuperTooltip コンポーネントを選択します。
    Properties window
    • Propertiesウィンドウで、MainMenu の c1SuperTooltip1 プロパティのツールチップの横にある省略記号ボタンをクリックして、C1SuperTooltip エディタを開きます。
  1. Properties ウィンドウで、MainMenu の c1SuperTooltip1 プロパティのツールチップの横にある省略記号ボタンをクリックして、C1SuperTooltip エディタを開きます。
  2. [Html] タブを選択します。[Html] テキスト ボックスに次の HTML コードを入力します。
    HTML
    コードのコピー
    <tr><td><b>View file menu</b><td></tr>
    

    Preview ペインに SuperTooltip のプレビューが表示されます。

    Tooltip editor
  3. Propertiesタブを選択し、supertooltip の BackgroundGradient、Font、および Size プロパティを設定し、[OK]をクリックしてエディターを閉じます。
    Properties tab
  1. C1SuperTooltipクラスのSetToolTip (System.Windows.Forms.Control コントロール、「string」テキスト)メソッドを使用して、ツールチップの HTML テキストを指定されたコントロール (この場合は MainMenu コントロール)に関連付けます。
    C#
    コードのコピー
    c1SuperTooltip1.SetToolTip(c1MainMenu1, "<tr><td><b>View file menu</b><td></tr>");
    
    メモ: SetToolTip プロパティは、コントロールと ToolStripItem でのみ機能し、コンポーネントでは機能しないため、メニュー項目には使用できません。このような場合、メニュー項目の SuperToolTip および ToolTipText プロパティを設定するだけです。
  2. SuperTooltip の BackgroundGradient プロパティと Font プロパティを設定します。
    C#
    コードのコピー
    c1SuperTooltip1.BackgroundGradient = BackgroundGradient.Vista;
     c1SuperTooltip1.Font = new Font("Arial", 9);
    

ツールチップの使用方法の詳細については、「メニューとツールバーのツールチップを表示する」を参照してください。

関連トピック