RibbonDropDown 介面
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
代表使用者可以選擇的項目清單，以及使用者可以按一下的功能區按鈕清單。
public interface class RibbonDropDown : IDisposable, Microsoft::Office::Tools::Ribbon::RibbonControl, System::ComponentModel::IComponent[System.Runtime.InteropServices.Guid("dbee9dd2-d9b1-4d37-bb31-099fd6d64a68")]
public interface RibbonDropDown : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonControl, System.ComponentModel.IComponent[<System.Runtime.InteropServices.Guid("dbee9dd2-d9b1-4d37-bb31-099fd6d64a68")>]
type RibbonDropDown = interface
interface RibbonControl
interface RibbonComponent
interface IComponent
interface IDisposablePublic Interface RibbonDropDown
Implements IComponent, IDisposable, RibbonControl- 屬性
- 實作
備註
RibbonDropDown可以包含 RibbonDropDownItem 物件和RibbonButton控件。
您可以使用物件的 方法RibbonFactory，在執行時間CreateRibbonDropDown建立 RibbonDropDown 。
有兩種方法可以存取 RibbonFactory 物件：
使用功能區類別的
Factory屬性。 請從功能區類別中的程式碼使用此方法。使用
Globals.Factory.GetRibbonFactory方法。 請從功能區類別外的程式碼使用此方法。
在功能區載入 Office 之後，您無法在運行時間將按鈕新增至 Buttons 集合。
下列程式說明如何將物件和RibbonButton控制項新增RibbonDropDownItem至 RibbonDropDown。
在設計時間新增 RibbonDropDownItem 物件
按兩下 [屬性] 視窗中的 [專案] 屬性。
按一下省略符號 (...)。
在DropDown集合編輯器中，新增、排序及編輯新專案。
您可以在設計時間將控制項新增 RibbonButton 至 RibbonDropDown 。
在設計時間新增 RibbonButton 控制件
按兩下 [屬性] 視窗中的 [按鈕] 屬性。
按一下省略符號 (...)。
在 [按鈕集合] 編輯器，新增、排序和編輯新的按鈕控件。
只有在功能區載入 Office 應用程式之前，才能設定此類型的某些成員。 如需設定這些屬性的詳細資訊，請參閱 功能區物件模型概觀。
注意
這個介面是由 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。
屬性
| Buttons |
取得這個 RibbonDropDown 所屬 RibbonButton 物件的集合。 |
| Enabled |
取得或設定值，指出是否啟用這個 RibbonControl。 (繼承來源 RibbonControl) |
| Id |
取得字串，Microsoft Office 用來識別這個 RibbonControl 物件。 (繼承來源 RibbonControl) |
| Image |
取得或設定顯示在這個 RibbonDropDown 上的影像。 |
| ImageName |
取得或設定您在 LoadImage 事件處理常式中，用來識別控制項影像的名稱。 |
| Items |
取得這個 RibbonDropDown 中的項目集合。 |
| KeyTip |
取得或設定這個 RibbonDropDown 的鍵盤快速鍵。 |
| Label |
取得或設定顯示在這個 RibbonDropDown 上的文字。 |
| Name |
取得或設定這個 RibbonComponent 的名稱。 (繼承來源 RibbonComponent) |
| OfficeImageId |
取得或設定要顯示在 RibbonDropDown 上的影像 (如果想要使用內建的 Microsoft Office 圖示)。 |
| Parent |
取得 RibbonComponent，代表這個 RibbonComponent 的父代。 (繼承來源 RibbonComponent) |
| Ribbon |
取得包含控制項階層的最上層 Ribbon 物件。 (繼承來源 RibbonComponent) |
| RibbonUI |
取得 Microsoft Office 應用程式提供給功能區擴充性程式碼的 IRibbonUI 執行個體。 (繼承來源 RibbonComponent) |
| ScreenTip |
取得或設定當使用者將指標移至 RibbonDropDown 上方時所顯示的提示文字。 |
| SelectedItem |
取得或設定目前選取的 RibbonDropDownItem。 |
| SelectedItemIndex |
取得或設定目前已選取之 RibbonDropDownItem 的索引。 |
| ShowImage |
取得或設定值，指出與 RibbonDropDown 關聯的影像是否可見。 |
| ShowItemImage |
取得或設定值，表示是否顯示下拉式功能表中項目的影像。 |
| ShowItemLabel |
取得或設定值，表示是否顯示下拉式功能表中項目的標籤。 |
| ShowLabel |
取得或設定值，指出這個 RibbonDropDown 的標籤是否可見。 |
| SizeString |
取得或設定決定 RibbonDropDown 大小的字串。 |
| SuperTip |
取得或設定當使用者將游標移至 RibbonDropDown 上方時所顯示的多行提示文字。 |
| Tag |
取得或設定與這個 RibbonComponent 關聯的應用程式特定資料。 (繼承來源 RibbonComponent) |
| 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) |
事件
| ButtonClick |
發生在使用者按一下 RibbonDropDown 上的按鈕時。 |
| ItemsLoading |
會在控制項載入至 RibbonDropDown 時發生。 |
| SelectionChanged |
會在使用者從功能區下拉式控制項選取新項目時發生。 |