RibbonSplitButton 介面

發行項
05/07/2013

功能區控制項，它結合了按鈕或切換按鈕與下拉式功能表。

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

語法

'宣告
<GuidAttribute("9d4c5611-01e0-4ad2-9614-8b9edaf6fe2c")> _
Public Interface RibbonSplitButton _
    Inherits RibbonControl, RibbonComponent, IComponent, IDisposable

[GuidAttribute("9d4c5611-01e0-4ad2-9614-8b9edaf6fe2c")]
public interface RibbonSplitButton : RibbonControl, 
    RibbonComponent, IComponent, IDisposable

RibbonSplitButton 型別會公開下列成員。

屬性

	名稱	說明
	ButtonEnabled	取得或設定值，這個值表示 RibbonSplitButton 上的按鈕是否已啟用。
	ButtonType	取得或設定 RibbonSplitButton 上的按鈕類型。
	Checked	取得或設定值，指出 RibbonSplitButton 已按下還是未按下。
	ControlSize	取得或設定 RibbonSplitButton 控制項的大小。
	Description	取得或設定會在下拉式功能表中顯示於這個 RibbonSplitButton 控制項的文字。
	Enabled	取得或設定值，指出此 RibbonControl 是否已啟用。 (繼承自 RibbonControl)。
	Id	取得 Microsoft Office 用來識別這個 RibbonControl 物件的字串。 (繼承自 RibbonControl)。
	Image	取得或設定顯示在控制項上的影像。
	ImageName	取得或設定您在 E:Microsoft.Office.Tools.Ribbon.LoadImage 事件處理常式中，用來識別控制項影像的名稱。
	Items	取得這個 RibbonSplitButton 上的控制項集合。
	ItemSize	取得或設定 RibbonSplitButton 下拉式功能表上的控制項大小。
	KeyTip	取得或設定 RibbonSplitButton 控制項的鍵盤快速鍵。
	Label	取得或設定 RibbonSplitButton 控制項上的文字。
	Name	取得或設定這個 RibbonComponent 的名稱。 (繼承自 RibbonComponent)。
	OfficeImageId	取得或設定要顯示在 RibbonSplitButton 控制項上的影像 (如果您想要使用內建 Microsoft Office 圖示的話)。
	Parent	取得 RibbonComponent，表示這個 RibbonComponent 的父代 (Parent)。 (繼承自 RibbonComponent)。
	Position	取得或設定 RibbonSplitButton 控制項的位置 (如果控制項在 Microsoft Office 功能表上的話)。
	Ribbon	取得包含控制項階層架構的最上層 Ribbon 物件。 (繼承自 RibbonComponent)。
	RibbonUI	基礎架構。取得 Microsoft Office 應用程式提供給功能區擴充性程式碼的 IRibbonUI 執行個體。 (繼承自 RibbonComponent)。
	ScreenTip	取得或設定當使用者將游標移至 RibbonSplitButton 控制項上方時所顯示的工具提示文字。
	ShowLabel	取得或設定值，指出 RibbonSplitButton 控制項的標籤是否可見。
	Site	取得或設定與 IComponent 相關聯的 ISite。 (繼承自 IComponent)。
	SuperTip	取得或設定當使用者將游標移至 RibbonSplitButton 控制項上方時所顯示的多行工具提示文字。
	Tag	取得或設定與這個 RibbonComponent 關聯的應用程式特定資料。 (繼承自 RibbonComponent)。
	Title	取得或設定顯示在 RibbonSplitButton 控制項上面的標題 (如果控制項在 Microsoft Office 功能表上的話)。
	Visible	取得或設定值，指出此 RibbonControl 是否為可見的。 (繼承自 RibbonControl)。

回頁首

方法

	名稱	說明
	Dispose	執行與釋放 (Free)、釋放 (Release) 或重設 Unmanaged 資源相關聯之應用程式定義的工作。 (繼承自 IDisposable)。
	PerformDynamicLayout	如果 RibbonComponent 具有像是動態功能表的動態父代 (Parent)，而且配置未暫止，請呼叫父控制項的 Microsoft.Office.Core.IRibbonUI.InvalidateControl 方法。 (繼承自 RibbonComponent)。
	PerformLayout	如果 RibbonComponent 具有父代且配置未暫止，則會呼叫 Microsoft.Office.Core.IRibbonUI.InvalidateControl。 (繼承自 RibbonComponent)。
	ResumeLayout()	回復 SuspendLayout 方法的效果。 (繼承自 RibbonComponent)。
	ResumeLayout(Boolean)	回復 SuspendLayout 方法的效果。 (繼承自 RibbonComponent)。
	SuspendLayout	防止 Microsoft Office 應用程式重新整理功能區上控制項的狀態。 (繼承自 RibbonComponent)。

回頁首

事件

	名稱	說明
	Click	會在使用者按一下 RibbonSplitButton 控制項時發生。
	Disposed	表示處理元件的 Disposed 事件的方法。 (繼承自 IComponent)。

回頁首

備註

RibbonSplitButton 控制項結合了按鈕或切換按鈕與下拉式功能表。若要在按鈕和切換按鈕之間選擇，請使用 ButtonType 屬性。

RibbonSplitButton 控制項與 RibbonMenu 控制項不同，它沒有 Dynamic 屬性，所以無法在執行階段變更 Items 集合的內容。

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

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

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

注意事項
這個界面是由 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 (英文)。