RibbonDropDown Rozhraní

Definice

Obor názvů:

Microsoft.Office.Tools.Ribbon

Sestavení:

Microsoft.Office.Tools.Common.dll

Představuje seznam položek, ze kterého si uživatel může vybrat, a seznam tlačítek na pásu karet, na které může uživatel kliknout.

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 IDisposable

Public Interface RibbonDropDown
Implements IComponent, IDisposable, RibbonControl

Atributy

GuidAttribute

Implementuje

RibbonComponent RibbonControl IComponent IDisposable

Poznámky

Objekt RibbonDropDown může obsahovat RibbonDropDownItem objekty a RibbonButton ovládací prvky.

Za běhu můžete vytvořit RibbonDropDown pomocí CreateRibbonDropDown metody objektu RibbonFactory .

Existují dva způsoby přístupu k objektu RibbonFactory :

• Pomocí Factory vlastnosti pásu karet třídy. Použijte tento přístup z kódu ve své třídě pásu karet.

• Pomocí Globals.Factory.GetRibbonFactory metody . Použijte tento přístup z kódu mimo svou třídu pásu karet.

Po načtení pásu Buttons karet do Office nelze do kolekce přidávat tlačítka za běhu.

Následující postupy vysvětlují, jak přidat RibbonDropDownItem objekty a RibbonButton ovládací prvky do objektu RibbonDropDown.

Přidání objektů RibbonDropDownItem v době návrhu

1. Klikněte na vlastnost Items v okně Vlastnosti .

2. Klikněte na tlačítko se třemi tečkami (...).

3. V rozevíracím seznamu kolekce Editor přidávat, řadit a upravovat nové položky.

Ovládací prvky můžete přidat RibbonButton do souboru v době návrhu RibbonDropDown .

Přidání ovládacích prvků RibbonButton v době návrhu

1. V okně Vlastnosti klikněte na vlastnost Tlačítka.

2. Klikněte na tlačítko se třemi tečkami (...).

3. V kolekci tlačítek Editor přidat, seřadit a upravit nové ovládací prvky tlačítka.

Některé členy tohoto typu je možné nastavit pouze před načtením pásu karet do aplikace Office. Informace o nastavení těchto vlastností najdete v tématu Přehled modelu objektu pásu karet.

Poznámka

Toto rozhraní je implementováno modulem Visual Studio Tools for Office Runtime. Rozhraní není určeno k implementaci do vašeho kódu. Další informace najdete v tématu přehled modulu Visual Studio Tools for Office Runtime.

Využití

Tato dokumentace popisuje verzi tohoto typu, který se používá v projektech Office cílených na rozhraní .NET Framework 4 nebo novější. V projektech cílených pro rozhraní .NET Framework 3.5 může mít tento typ jiné členy a ukázky kódu, poskytnuté pro tento typ, nemusejí fungovat. Dokumentaci k tomuto typu v projektech, které cílí na rozhraní .NET Framework 3.5, naleznete v následující referenční části v dokumentaci k sadě Visual Studio 2008: http://go.microsoft.com/fwlink/?LinkId=160658.

Vlastnosti

Buttons	Získá kolekci RibbonButton objektů, které patří k tomuto RibbonDropDown.
Enabled	Získá nebo nastaví hodnotu, která označuje, zda je povolena RibbonControl . (Zděděno od RibbonControl)
Id	Získá řetězec, který Microsoft Office používá k identifikaci tohoto RibbonControl objektu. (Zděděno od RibbonControl)
Image	Získá nebo nastaví obrázek, který se zobrazí na tomto RibbonDropDownobjektu .
ImageName	Získá nebo nastaví název, který můžete použít v obslužné rutině LoadImage události k identifikaci image pro ovládací prvek.
Items	Získá kolekci položek v tomto RibbonDropDownobjektu .
KeyTip	Získá nebo nastaví klávesovou zkratku pro tento RibbonDropDown.
Label	Získá nebo nastaví text, který se zobrazí na tomto RibbonDropDownobjektu .
Name	Získá nebo nastaví název tohoto RibbonComponent. (Zděděno od RibbonComponent)
OfficeImageId	Získá nebo nastaví obrázek, který se má zobrazit na RibbonDropDown, pokud chcete použít předdefinované ikony Microsoft Office.
Parent	Získá objekt RibbonComponent , který představuje nadřazený objekt tohoto RibbonComponentobjektu . (Zděděno od RibbonComponent)
Ribbon	Získá objekt nejvyšší úrovně Ribbon , který obsahuje hierarchii ovládacích prvků. (Zděděno od RibbonComponent)
RibbonUI	Získá IRibbonUI instance, která je poskytnuta microsoft office aplikace do kódu rozšiřitelnosti pásu karet. (Zděděno od RibbonComponent)
ScreenTip	Získá nebo nastaví text tipu, který se zobrazí, když uživatel přesune ukazatel na RibbonDropDown.
SelectedItem	Získá nebo nastaví aktuálně vybranou RibbonDropDownItem položku.
SelectedItemIndex	Získá nebo nastaví index aktuálně vybraného RibbonDropDownItemobjektu .
ShowImage	Získá nebo nastaví hodnotu, která označuje, zda je obrázek přidružený k objektu RibbonDropDown je viditelný.
ShowItemImage	Získá nebo nastaví hodnotu, která označuje, zda jsou zobrazeny obrázky pro položky v rozevírací nabídce.
ShowItemLabel	Získá nebo nastaví hodnotu, která označuje, zda jsou zobrazeny popisky pro položky v rozevírací nabídce.
ShowLabel	Získá nebo nastaví hodnotu, která označuje, zda je popisek pro tuto RibbonDropDown hodnotu viditelný.
SizeString	Získá nebo nastaví řetězec, který určuje velikost objektu RibbonDropDown.
SuperTip	Získá nebo nastaví víceřádkový text tipu, který se zobrazí, když uživatel přesune ukazatel přes RibbonDropDown.
Tag	Získá nebo nastaví data specifická pro aplikaci, která je přidružena k tomuto RibbonComponent. (Zděděno od RibbonComponent)
Visible	Získá nebo nastaví hodnotu, která označuje, zda je viditelný RibbonControl . (Zděděno od RibbonControl)

Metody

PerformDynamicLayout()	Volá Metodu Microsoft.Office.Core.IRibbonUI.InvalidateControl nadřazeného ovládacího prvku, pokud RibbonComponent má dynamický nadřazený prvek, například dynamickou nabídku, a rozložení není pozastaveno. (Zděděno od RibbonComponent)
PerformLayout()	Volání Microsoft.Office.Core.IRibbonUI.InvalidateControl pokud RibbonComponent má nadřazený a rozložení není pozastaveno. (Zděděno od RibbonComponent)
ResumeLayout()	Obrátí účinek SuspendLayout() metody . (Zděděno od RibbonComponent)
ResumeLayout(Boolean)	Obrátí účinek SuspendLayout() metody . (Zděděno od RibbonComponent)
SuspendLayout()	Zabrání aplikaci Microsoft Office v aktualizaci stavu ovládacích prvků na pásu karet. (Zděděno od RibbonComponent)

Událost

ButtonClick	Vyvolá se, když uživatel klikne na tlačítko na objektu RibbonDropDown.
ItemsLoading	Vyvolá se při načtení ovládacích prvků do .RibbonDropDown
SelectionChanged	Vyvolá se, když uživatel vybere novou položku v ovládacím prvku rozevíracího seznamu pásu karet.