RibbonGroup.DialogLauncher プロパティ

グループに関連付けられたリボン ダイアログ ランチャーを取得または設定します。

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

構文

'宣言
Property DialogLauncher As RibbonDialogLauncher

RibbonDialogLauncher DialogLauncher { get; set; }

プロパティ値

型 : Microsoft.Office.Tools.Ribbon.RibbonDialogLauncher
グループに関連付けられたリボン ダイアログ ランチャー。

解説

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

リボン ダイアログ ランチャーの動作は、RibbonDialogLauncher インターフェイスのプロパティを使用してカスタマイズできます。たとえば、ユーザーがダイアログ ランチャー アイコンの上にポインターを移動すると表示される画面ヒントを設定するには、ScreenTip プロパティを使用します。

Image プロパティなど、RibbonDialogLauncher インターフェイスの一部のプロパティは、エンド ユーザーがランチャーをクイック アクセス ツール バーに追加したときにのみ適用されます。

例

次の例では、既定のグループに追加された RibbonDialogLauncher の KeyTip プロパティと ScreenTip プロパティを設定する方法を示します。

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

1. [リボン (ビジュアル デザイナー)] アイテムを Office プロジェクトに追加します。

2. 「方法 : リボン グループにダイアログ ボックス起動ツールを追加する」で説明されているように、RibbonDialogLauncher を既定のグループ Group1 に追加します。

Private Sub SetDialogLauncherProperties()
    Group1.DialogLauncher.KeyTip = "A"
    Group1.DialogLauncher.ScreenTip = "Advanced Settings"
End Sub

private void SetDialogLauncherProperties()
{
    group1.DialogLauncher.KeyTip = "A";
    group1.DialogLauncher.ScreenTip = "Advanced Settings";
}

.NET Framework セキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。

参照

関連項目

RibbonGroup インターフェイス

Microsoft.Office.Tools.Ribbon 名前空間

その他の技術情報

方法 : リボン グループにダイアログ ボックス起動ツールを追加する