RibbonSplitButton 介面

定義

命名空間:

Microsoft.Office.Tools.Ribbon

組件:

Microsoft.Office.Tools.Common.dll

結合按鈕或切換按鈕和下拉式功能表的功能區控制項。

public interface class RibbonSplitButton : IDisposable, Microsoft::Office::Tools::Ribbon::RibbonControl, System::ComponentModel::IComponent

[System.Runtime.InteropServices.Guid("9d4c5611-01e0-4ad2-9614-8b9edaf6fe2c")]
public interface RibbonSplitButton : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonControl, System.ComponentModel.IComponent

[<System.Runtime.InteropServices.Guid("9d4c5611-01e0-4ad2-9614-8b9edaf6fe2c")>]
type RibbonSplitButton = interface
    interface RibbonControl
    interface RibbonComponent
    interface IComponent
    interface IDisposable

Public Interface RibbonSplitButton
Implements IComponent, IDisposable, RibbonControl

屬性

GuidAttribute

實作

RibbonComponent RibbonControl IComponent IDisposable

備註

RibbonSplitButton控件結合了按鈕或切換按鈕和下拉功能表。 若要選擇按鈕和切換按鈕，請使用 ButtonType 屬性。

RibbonMenu不同於控件，RibbonSplitButton控件沒有 Dynamic 屬性，因此集合的內容Items無法在運行時間變更。

您可以使用物件的 方法RibbonFactory，CreateRibbonSplitButton在執行時間建立 RibbonSplitButton 。

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

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

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

注意

這個介面是由 Visual Studio Tools for Office Runtime 實作， 並不能實作於您的程式碼中。 如需詳細資訊，請參閱 Visual Studio Tools for Office Runtime Overview。

使用方式

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

屬性

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 的父代。 (繼承來源 RibbonComponent)
Position	取得或設定 RibbonSplitButton 控制項的位置 (如果 Microsoft Office 功能表上有此控制項)。
Ribbon	取得包含控制項階層的最上層 Ribbon 物件。 (繼承來源 RibbonComponent)
RibbonUI	取得 Microsoft Office 應用程式提供給功能區擴充性程式碼的 IRibbonUI 執行個體。 (繼承來源 RibbonComponent)
ScreenTip	取得或設定當使用者將游標移至 RibbonSplitButton 控制項上方時所顯示的工具提示文字。
ShowLabel	取得或設定值，指出 RibbonSplitButton 控制項按鈕的標籤是否可見。
SuperTip	取得或設定當使用者將游標移至 RibbonSplitButton 控制項上方時所顯示的多行工具提示文字。
Tag	取得或設定與這個 RibbonComponent 關聯的應用程式特定資料。 (繼承來源 RibbonComponent)
Title	取得或設定顯示在 RibbonSplitButton 控制項頂端上的標題 (如果 Microsoft Office 功能表上有此控制項)。
Visible	取得或設定值，指出這個 RibbonControl 是否可見。 (繼承來源 RibbonControl)

方法

PerformDynamicLayout()	如果 RibbonComponent 具有動態功能表這類動態父代，而且未暫止配置，請呼叫父控制項的 Microsoft.Office.Core.IRibbonUI.InvalidateControl 方法。 (繼承來源 RibbonComponent)
PerformLayout()	如果 具有父代，而且未暫止配置，請呼叫 RibbonComponentMicrosoft.Office.Core.IRibbonUI.InvalidateControl。 (繼承來源 RibbonComponent)
ResumeLayout()	回復 SuspendLayout() 方法的效果。 (繼承來源 RibbonComponent)
ResumeLayout(Boolean)	回復 SuspendLayout() 方法的效果。 (繼承來源 RibbonComponent)
SuspendLayout()	防止 Microsoft Office 應用程式重新整理功能區上控制項的狀態。 (繼承來源 RibbonComponent)

事件

Click

發生於使用者按一下 RibbonSplitButton 控制項時。