RibbonGroup.DialogLauncherClick イベント (2007 System)

2008-08-22

更新 : 2007 年 11 月

ユーザーがグループ内のリボンダイアログランチャーアイコンをクリックしたときに発生します。

名前空間 : Microsoft.Office.Tools.Ribbon
アセンブリ : Microsoft.Office.Tools.Common.v9.0 (Microsoft.Office.Tools.Common.v9.0.dll 内)

構文

'宣言
Public Event DialogLauncherClick As EventHandler(Of RibbonControlEventArgs)
'使用
Dim instance As RibbonGroup
Dim handler As EventHandler(Of RibbonControlEventArgs)

AddHandler instance.DialogLauncherClick, handler

public event EventHandler<RibbonControlEventArgs> DialogLauncherClick

解説

リボンダイアログランチャーは、グループ内に表示される小さいアイコンです。ユーザーがこのアイコンをクリックしたときは、DialogLauncherClick イベントを処理してカスタムダイアログボックスを開くことができます。既定では、グループにはリボンダイアログランチャーは関連付けられていません。詳細については、「方法 : リボングループにダイアログボックス起動ツールを追加する」を参照してください。

例

次の例では、ダイアログボックス起動ツールをリボングループに追加する方法と、ユーザーが RibbonGroup の右下隅にある RibbonDialogLauncher アイコンをクリックしたときにカスタムダイアログを起動して、詳細設定を選択できるようにする方法を示します。

このコード例を実行するには、最初に次の手順を実行する必要があります。

リボン (ビジュアルデザイナ) アイテムを Visual Studio Tools for Office プロジェクトに追加します。
「方法 : リボングループにダイアログボックス起動ツールを追加する」で説明されているように、RibbonDialogLauncher を既定のグループに追加します。
Visual Basic プロジェクトを使用している場合は、プロジェクトに新しい Windows フォーム Dialog アイテムを追加します。C# を使用している場合は、新しい Windows Form アイテムを追加し、フォームに [OK] ボタンと [Cancel] ボタンを追加してボタンのクリックイベントのイベントハンドラを作成することでダイアログに変えます。
ダイアログの (Name) プロパティを advancedSettingsDialog に設定します。コントロールを追加したり、プロパティを設定したりして、ダイアログをカスタマイズできます。
コードに DialogLauncherClick イベントハンドラを追加します。
DialogLauncherClick イベントハンドラに、次のメソッドの内容を設定します。

Private Sub Group1_DialogLauncherClick(ByVal sender As Object, ByVal e As Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs) Handles Group1.DialogLauncherClick
    Dim dlg As advancedSettingsDialog = New advancedSettingsDialog()
    dlg.ShowDialog()
End Sub

void group1_DialogLauncherClick(object sender, Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs e)
{
    advancedSettingsDialog dlg = new advancedSettingsDialog();
    dlg.ShowDialog();
}