本文為機器翻譯文章。如需檢視英文版,請選取 [原文] 核取方塊。您也可以將滑鼠指標移到文字上,即可在快顯視窗顯示英文原文。
譯文
原文

RibbonGallery 介面

 

表示控制項顯示的功能表RibbonDropDownItem物件和RibbonButton控制項。

命名空間:   Microsoft.Office.Tools.Ribbon
組件:  Microsoft.Office.Tools.Common (於 Microsoft.Office.Tools.Common.dll)

[GuidAttribute("c1cff037-81e7-44a0-8f9d-150237dfd312")]
public interface RibbonGallery : RibbonControl, RibbonComponent, 
	IComponent, IDisposable

名稱描述
System_CAPS_pubpropertyButtons

取得這個 RibbonGallery 上的按鈕集合。

System_CAPS_pubpropertyColumnCount

取得或設定這個 RibbonGallery 中的 Item 資料行數目。

System_CAPS_pubpropertyControlSize

取得或設定 RibbonGallery 控制項的大小。

System_CAPS_pubpropertyDescription

取得或設定會在功能表或分割按鈕上顯示於這個 RibbonGallery 控制項上的文字。

System_CAPS_pubpropertyEnabled

取得或設定值,指出是否啟用這個 RibbonControl(繼承自 RibbonControl。)

System_CAPS_pubpropertyId

取得字串,Microsoft Office 用來識別這個 RibbonControl 物件。(繼承自 RibbonControl。)

System_CAPS_pubpropertyImage

取得或設定顯示在按鈕上的影像。

System_CAPS_pubpropertyImageName

取得或設定可在 RibbonGallery 事件處理常式中用來識別 LoadImage 的名稱。

System_CAPS_pubpropertyItemImageSize

取得或設定 Size,提供這個 RibbonGallery 中的項目所顯示影像的維度。

System_CAPS_pubpropertyItems

取得這個 RibbonGallery 中的 RibbonDropDownItem 文件集合。

System_CAPS_pubpropertyKeyTip

取得或設定這個 RibbonGallery 的鍵盤快速鍵。

System_CAPS_pubpropertyLabel

取得或設定顯示在這個 RibbonGallery 上的文字。

System_CAPS_pubpropertyName

取得或設定這個名稱RibbonComponent(繼承自 RibbonComponent。)

System_CAPS_pubpropertyOfficeImageId

取得或設定要顯示在控制項上的影像 (如果想要使用內建的 Microsoft Office 圖示)。

System_CAPS_pubpropertyParent

取得 RibbonComponent,代表這個 RibbonComponent 的父代。(繼承自 RibbonComponent。)

System_CAPS_pubpropertyPosition

取得或設定圖庫] 中的位置,如果是 Microsoft Office 功能表上的組件庫。

System_CAPS_pubpropertyRibbon

取得包含控制項階層的最上層 Ribbon 物件。(繼承自 RibbonComponent。)

System_CAPS_pubpropertyRibbonUI

此 API 支援 產品 基礎結構,而且不適合直接從程式碼使用。 取得 Microsoft Office 應用程式提供給功能區擴充性程式碼的 IRibbonUI 執行個體。(繼承自 RibbonComponent。)

System_CAPS_pubpropertyRowCount

取得或設定資料列的數目RibbonDropDownItem元件這個RibbonGallery會顯示。

System_CAPS_pubpropertyScreenTip

取得或設定當使用者將指標移至這個 RibbonGallery 上方時所顯示的提示文字。

System_CAPS_pubpropertySelectedItem

取得或設定目前選取的項目。

System_CAPS_pubpropertySelectedItemIndex

取得或設定目前已選取之 RibbonDropDownItem 的索引。

System_CAPS_pubpropertyShowImage

取得或設定值,表示與 RibbonGallery 相關聯的影像是否可見。

System_CAPS_pubpropertyShowItemImage

取得或設定值,指出是否顯示組件庫項目的影像。

System_CAPS_pubpropertyShowItemLabel

取得或設定值,指出標籤是否會顯示此項目RibbonGallery

System_CAPS_pubpropertyShowItemSelection

取得或設定值,指出是否目前所選RibbonDropDownItem與其餘的未選取的項目以視覺化方式區分。

System_CAPS_pubpropertyShowLabel

取得或設定值,指出這個 RibbonGallery 的標籤是否可見。

System_CAPS_pubpropertySite

(繼承自 IComponent。)

System_CAPS_pubpropertySuperTip

取得或設定當使用者將游標移至 RibbonGallery 上方時所顯示的多行提示文字。

System_CAPS_pubpropertyTag

取得或設定與這個 RibbonComponent 相關聯的應用程式特定資料。(繼承自 RibbonComponent。)

System_CAPS_pubpropertyVisible

取得或設定值,指出這個 RibbonControl 是否可見。(繼承自 RibbonControl。)

名稱描述
System_CAPS_pubmethodDispose()

(繼承自 IDisposable。)

System_CAPS_pubmethodPerformDynamicLayout()

如果 RibbonComponent 具有動態功能表這類的動態父代,而且未暫停配置,請呼叫父控制項的 Microsoft.Office.Core.IRibbonUI.InvalidateControl 方法。(繼承自 RibbonComponent。)

System_CAPS_pubmethodPerformLayout()

如果 RibbonComponent 具有父系而未暫停配置即呼叫 Microsoft.Office.Core.IRibbonUI.InvalidateControl(繼承自 RibbonComponent。)

System_CAPS_pubmethodResumeLayout()

回復 SuspendLayout 方法的效果。(繼承自 RibbonComponent。)

System_CAPS_pubmethodResumeLayout(Boolean)

回復 SuspendLayout 方法的效果。(繼承自 RibbonComponent。)

System_CAPS_pubmethodSuspendLayout()

防止 Microsoft Office 應用程式重新整理功能區上控制項的狀態。(繼承自 RibbonComponent。)

名稱描述
System_CAPS_pubeventButtonClick

發生在使用者按一下這個 RibbonGallery 上的按鈕時。

System_CAPS_pubeventClick

發生在使用者按一下這個 RibbonGallery 上的項目時。

System_CAPS_pubeventDisposed

(繼承自 IComponent。)

System_CAPS_pubeventItemsLoading

發生於開啟這個 RibbonGallery 時。

RibbonDropDown介面,RibbonGallery顯示的功能表RibbonDropDownItem物件和RibbonButton控制項。

不同於RibbonDropDown介面,RibbonGallery介面會引發Click事件,而非SelectionChanged事件,當使用者按一下RibbonDropDownItem 這表示,例如Click兩次使用者按一下相同時,才會引發事件RibbonDropDownItem兩次。 (SelectionChanged事件就會引發一次初始的選取項目上進行相同的案例時RibbonDropDown,取決於選取範圍的第一次之前。)

ShowItemSelection屬性會控制是否目前所選RibbonDropDownItem與未選取的項目以視覺化方式區分。 一次只能有一個項目中可選取RibbonGallery

ItemImageSize屬性可以用來指定映像大小不是 16 x 16 和 32 x 32。

若要在設計階段加入 RibbonDropDownItem 物件

  1. 按一下 [項目屬性屬性視窗。

  2. 按一下省略符號 (...).

  3. 下拉式清單中的集合編輯器、 新增、 排序和編輯新的項目。

您可以加入RibbonButton控制項加入至RibbonGallery在設計階段。

若要在設計階段加入 RibbonButton 控制項

  1. 按一下 [按鈕屬性屬性視窗。

  2. 按一下省略符號 (...).

  3. 按鈕集合編輯器、 新增、 排序和編輯新的按鈕控制項。

您可以建立RibbonGallery在執行階段使用CreateRibbonGallery方法RibbonFactory物件。

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

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

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

只在功能區載入至 Office 應用程式或控制項加入至動態功能表在執行階段之前,可以設定此控制項的某些屬性。 如需設定這些屬性的資訊,請參閱功能區物件模型概觀

System_CAPS_note注意

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

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

回到頁首
顯示: