[SuperToolTip for WinForms] リボンコントロールのタブやボタンなどにSuperToolTip for .NETのツールチップを表示できますか？ – MESCIUS ナレッジベース

作成日: 2014/09/26 最終更新日: 2014/09/26

文書種別

使用方法

詳細

SuperToolTip for .NETのツールチップを表示できる親コントロールは、System.Windows.Forms.Controlクラスまたは System.Windows.Forms.ToolStripItemクラスを継承するものに限られます。
Ribbon for .NETのリボンコントロールはSystem.Windows.Forms.Controlクラスを継承しているので、リボンコントロール全体にひとつのSuperToolTip for .NETのツールチップを表示することができます。
しかし、リボンコントロールに含まれるタブやボタンなどはSystem.ComponentModel.Componentクラスを継承をしているため、直接SuperToolTipのツールチップを設定することはできません。これらのアイテムのプロパティには「C1SuperTooltipのツールチップ」という項目は表示されません。
ただし、リボンコントロールに割り当てたSuperToolTipのHTMLテキストを、タブやボタンなどの各種アイテムのMouseEnterイベントなどで切り替えることで、目的の動作を行わせることが可能になります。
次のような準備を行ったのち、後述するサンプルコードを追加してプロジェクトを実行してください。

(1) フォームにC1Ribbonコントロール（C1Ribbon1）とC1SuperTooltipコントロール（C1SuperTooltip1）を貼り付けます。
(2) C1Ribbon1のグループにボタンを２つ（RibbonButton1、RibbonButton2）追加します。

(3) C1SuperTooltip1のImagesプロパティをクリックし、画像コレクションに２つの画像（image01.gif、image02.gif）を追加します。
◎サンプルコード（VB）

　　Private Sub RibbonButton1_MouseEnter(・・・
　　　　' 第1ボタンのツールチップに画像１を割り当てます。
　　　　Dim s As String = "<img src='res://image01.gif>"
　　　　C1SuperTooltip1.SetToolTip(C1Ribbon1, s)
　　End Sub

　　Private Sub RibbonButton2_MouseEnter(・・・
　　　　' 第2ボタンのツールチップに画像１を割り当てます。
　　　　Dim s As String = "<timg src='res://image02.gif'>"
　　　　C1SuperTooltip1.SetToolTip(C1Ribbon1, s)
　　End Sub

　　Private Sub C1Ribbon1_RibbonEvent(・・・
　　　　' マウスがアイテムを離れる時にツールチップをリセットします。
　　　　If e.EventType = C1.Win.C1Ribbon.RibbonEventType.MouseLeave Then
　　　　　　C1SuperTooltip1.SetToolTip(C1Ribbon1, String.Empty)
　　　　End If
　　End Sub

◎サンプルコード（C#）

　　　　private void ribbonButton1_MouseEnter(object sender, EventArgs e)
　　　　{
　　　　　　// 第1ボタンのツールチップに画像１を割り当てます。
　　　　　　string s = "<timg src='res://image01.gif'>";
　　　　　　c1SuperTooltip1.SetToolTip(c1Ribbon1, s);
　　　　}

　　　　private void ribbonButton2_MouseEnter(object sender, EventArgs e)
　　　　{
　　　　　　// 第2ボタンのツールチップに画像２を割り当てます。
　　　　　　string s = "<timg src='res://image02.gif'>";
　　　　　　c1SuperTooltip1.SetToolTip(c1Ribbon1, s);
　　　　}

　　　　private void c1Ribbon1_RibbonEvent(object sender, C1.Win.C1Ribbon.RibbonEventArgs e)
　　　　{
　　　　　　// マウスがアイテムを離れる時にツールチップをリセットします。
　　　　　　if (e.EventType == C1.Win.C1Ribbon.RibbonEventType.MouseLeave)
　　　　　　{
　　　　　　　　c1SuperTooltip1.SetToolTip(c1Ribbon1, String.Empty);
　　　　　　}
　　　　}

旧文書番号

69941