共用方式為


RibbonDialogLauncher 類別 (2007 系統)

更新:2007 年 11 月

表示群組中可用來開啟對話方塊的小型標準化圖示。

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

語法

Public NotInheritable Class RibbonDialogLauncher _
    Implements IDisposable

Dim instance As RibbonDialogLauncher
public sealed class RibbonDialogLauncher : IDisposable

備註

RibbonDialogLauncher 預設會顯示在群組的右下角。

當 RibbonDialogLauncher 顯示在功能區的群組中時,ImageImageNameOfficeImageId 屬性沒有明顯可見的作用。不過,當使用者將 RibbonDialogLauncher 加入至 [快速存取工具列] 時,這些屬性就會控制所顯示之影像的行為。此外,當 RibbonDialogLauncher 顯示在 [快速存取工具列] 上時,Visible 屬性也無法將它隱藏。使用者可以透過 [功能區 (XML)] 項目,將 RibbonDialogLauncher 加入至 [快速存取工具列]。如需詳細資訊,請參閱功能區概觀

RibbonDialogLauncher 只適用於 RibbonGroupRibbonGroup 類別具有 RibbonDialogLauncher 型別的 DialogLauncher 成員。如需如何將 RibbonDialogLauncher 加入至 RibbonGroup 的詳細資訊,請參閱 HOW TO:在功能區群組中加入對話方塊啟動程式

這個控制項的某些屬性只能在功能區載入至 Office 應用程式前進行設定。如需這些屬性的設定資訊,請參閱功能區物件模型概觀

範例

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

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

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

  2. 請依照 HOW TO:在功能區群組中加入對話方塊啟動程式所述步驟,將 RibbonDialogLauncher 加入至預設群組 Group1。

  3. 如果您正在使用 Visual Basic,請將新的 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();
}

繼承階層架構

System.Object
  Microsoft.Office.Tools.Ribbon.RibbonDialogLauncher

執行緒安全

這個型別的任何 Public static (在 Visual Basic 中為 Shared) 成員都具備執行緒安全。並非所有的執行個體成員都是安全執行緒。

請參閱

參考

RibbonDialogLauncher 成員

Microsoft.Office.Tools.Ribbon 命名空間

其他資源

HOW TO:在 Visual Studio Tools for Office 中建立事件處理常式

功能區概觀

功能區設計工具

功能區物件模型概觀

HOW TO:開始自訂功能區