RibbonDialogLauncher 介面

發行項
05/07/2013

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

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

語法

'宣告
<GuidAttribute("e143d5e9-e844-4052-9793-2070185d351d")> _
Public Interface RibbonDialogLauncher _
    Inherits IDisposable

[GuidAttribute("e143d5e9-e844-4052-9793-2070185d351d")]
public interface RibbonDialogLauncher : IDisposable

RibbonDialogLauncher 型別會公開下列成員。

屬性

	名稱	說明
	Enabled	取得或設定值，這個值表示此 RibbonDialogLauncher 是否已啟用。
	Image	取得或設定當這個 RibbonDialogLauncher 加入至 [快速存取工具列] 時出現在其中的影像。
	ImageName	取得或設定當這個 RibbonDialogLauncher 加入至 [快速存取工具列] 時用來指派其影像的識別項。
	KeyTip	取得或設定這個 RibbonDialogLauncher 的鍵盤快速鍵。
	OfficeImageId	取得或設定要顯示在這個 RibbonDialogLauncher 控制項上的影像 (如果您想要使用內建 Microsoft Office 圖示的話)。
	Parent	取得這個 RibbonDialogLauncher 所屬的 RibbonGroup 物件。
	Ribbon	取得放置這個 RibbonDialogLauncher 所在的 OfficeRibbon。
	ScreenTip	取得或設定當使用者將游標移至 RibbonDialogLauncher 上方時所顯示的提示文字。
	SuperTip	取得或設定當使用者將游標移至 RibbonDialogLauncher 上方時所顯示的多行提示文字。
	Visible	取得或設定值，指出此 RibbonDialogLauncher 是否為可見的。

回頁首

方法

	名稱	說明
	Dispose	執行與釋放 (Free)、釋放 (Release) 或重設 Unmanaged 資源相關聯之應用程式定義的工作。 (繼承自 IDisposable)。
	ResumeLayout	回復 SuspendLayout 方法的效果。
	SuspendLayout	防止 Microsoft Office 應用程式重新整理 OfficeRibbon 中的控制項狀態。

回頁首

備註

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

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

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

您可以在執行階段中使用 RibbonFactory 物件的 CreateRibbonDialogLauncher 方法建立 RibbonDialogLauncher。

有兩種方法可以存取 RibbonFactory 物件：

使用功能區類別的 Factory 屬性。請從功能區類別中的程式碼使用此方法。
使用 Globals.Factory.GetRibbonFactory 方法。請從功能區類別外的程式碼使用此方法。

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

注意事項
這個界面是由 Visual Studio Tools for Office Runtime 實作，並不能實作於您的程式碼中。如需詳細資訊，請參閱 Visual Studio Tools for Office Runtime 概觀。

使用方式

本文件說明此型別用於以 .NET Framework 4 和 .NET Framework 4.5 為目標之 Office 專案的版本。在以 .NET Framework 3.5 為目標的專案中，此型別可能會有不同的成員，而為此型別提供的程式碼範例可能無法運作。如需此型別在以 .NET Framework 3.5 為目標之專案中的相關文件，請參閱下列 Visual Studio 2008 文件中的參考章節：https://go.microsoft.com/fwlink/?LinkId=160658 (英文)。

範例

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

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

將 功能區 (視覺化設計工具) 項目加入至 Office 專案。
請依照 HOW TO：在功能區群組中加入對話方塊啟動程式所述步驟，將 RibbonDialogLauncher 加入至預設群組 Group1。
如果您正在使用 Visual Basic，請將新的 Dialog 項目加入至專案。如果您正在使用 C#，請加入新的 Windows Form 項目，然後透過將 OK 和 Cancel 按鈕加入至表單，以及為按鈕的 Click 事件建立事件處理常式，使這個表單變成對話方塊。
將對話方塊的 [(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();
}