共用方式為

RibbonGroup.DialogLauncherClick 事件

  • 發行項

會在使用者按一下群組中的功能區對話方塊啟動程式圖示時發生。

命名空間：  Microsoft.Office.Tools.Ribbon
組件：  Microsoft.Office.Tools.Common (在 Microsoft.Office.Tools.Common.dll 中)

語法

'宣告
Event DialogLauncherClick As RibbonControlEventHandler

event RibbonControlEventHandler DialogLauncherClick

備註

功能區對話方塊啟動程式是出現在群組中的小型圖示。 當使用者按一下這個圖示時，您可以讓 DialogLauncherClick 事件開啟自訂對話方塊。 根據預設，群組沒有功能區對話方塊啟動程式。 如需詳細資訊，請參閱如何：在功能區群組中加入對話方塊啟動程式。

範例

下列程式碼範例示範如何將對話方塊啟動程式加入至功能區群組，以及如何啟動自訂對話方塊，讓使用者可在按一下 RibbonGroup 右下角的 RibbonDialogLauncher 圖示時選擇進階設定。

若要執行這個程式碼範例，您必須先執行下列步驟：

  1. 將 功能區 (視覺化設計工具) 項目加入至 Office 專案。

  2. 請依照 如何：在功能區群組中加入對話方塊啟動程式所述步驟，將 RibbonDialogLauncher 加入至預設群組。

  3. 如果您正在使用 Visual Basic，請將新的 Windows Form Dialog 項目加入至專案。 如果您正在使用 C#，請加入新的 Windows Form 項目，然後透過將 OK 和 Cancel 按鈕加入至表單，以及為按鈕的 Click 事件建立事件處理常式，使這個表單變成對話方塊。

  4. 將對話方塊的 [(Name)] 屬性設定為 advancedSettingsDialog。 您可以透過加入控制項和設定更多屬性，自訂對話方塊。

  5. 將 DialogLauncherClick 事件處理常式加入至程式碼。

  6. 將下列方法的內容放入 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();
}

.NET Framework 安全性

請參閱

參考

RibbonGroup 介面

Microsoft.Office.Tools.Ribbon 命名空間

其他資源

如何：在功能區群組中加入對話方塊啟動程式