更新 : 2007 年 11 月
グループに関連付けられたリボン ダイアログ ランチャーを取得または設定します。
名前空間 : Microsoft.Office.Tools.Ribbon
アセンブリ : Microsoft.Office.Tools.Common.v9.0 (Microsoft.Office.Tools.Common.v9.0.dll 内)
構文
'宣言
Public Property DialogLauncher As RibbonDialogLauncher
'使用
Dim instance As RibbonGroup
Dim value As RibbonDialogLauncher
value = instance.DialogLauncher
instance.DialogLauncher = value
public RibbonDialogLauncher DialogLauncher { get; set; }
プロパティ値
型 : Microsoft.Office.Tools.Ribbon.RibbonDialogLauncher
グループに関連付けられたリボン ダイアログ ランチャー。
解説
リボン ダイアログ ランチャーは、グループ内に表示される小さいアイコンです。ユーザーがこのアイコンをクリックしたときは、DialogLauncherClick イベントを処理してカスタム ダイアログ ボックスを開くことができます。既定では、グループにはリボン ダイアログ ランチャーは関連付けられていません。詳細については、「方法 : リボン グループにダイアログ ボックス起動ツールを追加する」を参照してください。
リボン ダイアログ ランチャーの動作は、RibbonDialogLauncher クラスのプロパティを使用してカスタマイズできます。たとえば、ユーザーがダイアログ ランチャー アイコンの上にポインタを移動すると表示される画面ヒントを設定するには、ScreenTip プロパティを使用します。
Image プロパティなど、RibbonDialogLauncher クラスの一部のプロパティは、エンド ユーザーがランチャーをクイック アクセス ツール バーに追加したときにのみ適用されます。
例
次の例では、既定のグループに追加された RibbonDialogLauncher の KeyTip プロパティと ScreenTip プロパティを設定する方法を示します。
このコード例を実行するには、最初に次の手順を実行する必要があります。
リボン (ビジュアル デザイナ) アイテムを Visual Studio Tools for Office プロジェクトに追加します。
「方法 : リボン グループにダイアログ ボックス起動ツールを追加する」で説明されているように、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";
}
アクセス許可
- 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。
参照
参照
Microsoft.Office.Tools.Ribbon 名前空間