RibbonMenu – rozhraní

Článek
01/03/2014

Představuje nabídku na kartě pásu karet nebo v nabídce Microsoft Office.

Obor názvů: Microsoft.Office.Tools.Ribbon
Sestavení: Microsoft.Office.Tools.Common (v Microsoft.Office.Tools.Common.dll)

Syntaxe

'Deklarace
<GuidAttribute("59dc7f42-aca2-484a-9622-1ee34a6cfd7d")> _
Public Interface RibbonMenu _
    Inherits RibbonControl, RibbonComponent, IComponent, IDisposable

[GuidAttribute("59dc7f42-aca2-484a-9622-1ee34a6cfd7d")]
public interface RibbonMenu : RibbonControl, 
    RibbonComponent, IComponent, IDisposable

Typ RibbonMenu zveřejňuje následující členy.

Vlastnosti

	Název	Popis
	ControlSize	Získá nebo nastaví velikost nabídky.
	Description	Získá nebo nastaví text zobrazený v aktuální nabídce.
	Dynamic	Získá nebo nastaví hodnotu, která označuje, zda lze upravit v nabídce za běhu.
	Enabled	Získá nebo nastaví hodnotu, která označuje, zda tento RibbonControl je povoleno. (Zděděno z RibbonControl.)
	Id	Získá řetězec, který aplikace Microsoft Office používá k identifikaci tohoto RibbonControl objektu. (Zděděno z RibbonControl.)
	Image	Získá nebo nastaví obrázek, který se zobrazí v nabídce.
	ImageName	Získá nebo nastaví název používaný v LoadImage obslužnou rutinu události pro identifikaci obrázku pro nabídku.
	Items	Získá kolekce ovládacích prvků, které jsou v nabídce.
	ItemSize	Získá nebo nastaví velikost ovládacích prvků v nabídce.
	KeyTip	Získá nebo nastaví klávesnici přístupová klávesa nabídky.
	Label	Získá nebo nastaví text, který je zobrazen v nabídce.
	Name	Získá nebo nastaví název tohoto RibbonComponent. (Zděděno z RibbonComponent.)
	OfficeImageId	Získá nebo nastaví obrázek zobrazit v nabídce, pokud chcete použít integrovanou ikonu Microsoft Office.
	Parent	Získá RibbonComponent , která představuje nadřazené tohoto RibbonComponent. (Zděděno z RibbonComponent.)
	Position	Získá nebo nastaví pozici v nabídce, je-li v nabídce v nabídce Microsoft Office.
	Ribbon	Získá nejvyšší úrovně Ribbon objekt, který obsahuje hierarchii ovládacích prvků. (Zděděno z RibbonComponent.)
	RibbonUI	Infrastruktura. Získá IRibbonUI instance, která je k dispozici kódu rozšiřitelnost pásu karet aplikace Microsoft Office. (Zděděno z RibbonComponent.)
	ScreenTip	Získá nebo nastaví text tipu, který se zobrazí, když uživatel přesune ukazatel myši nad nabídku.
	ShowImage	Získá nebo nastaví hodnotu, která označuje, zda je zobrazen obrázek, který je spojen s nabídkou.
	ShowLabel	Získá nebo nastaví hodnotu, která označuje, zda je zobrazen popisek z nabídky.
	Site	Získá nebo nastaví ISite přidružené IComponent. (Zděděno z IComponent.)
	SuperTip	Získá nebo nastaví text víceřádkové tip, který se zobrazí, když uživatel přesune ukazatel myši nad nabídku.
	Tag	Získá nebo nastaví specifická data spojená s tímto RibbonComponent. (Zděděno z RibbonComponent.)
	Title	Získá nebo nastaví název, který se zobrazí, když uživatel rozbalí nabídka, která je přidána do nabídky aplikace Microsoft Office.
	Visible	Získá nebo nastaví hodnotu, která označuje, zda tento RibbonControl je viditelná. (Zděděno z RibbonControl.)

Nahoru

Metody

	Název	Popis
	Dispose	Provádí úkoly definované aplikací, které jsou spojeny s uvolněním nebo obnovením nespravovaných prostředků. (Zděděno z IDisposable.)
	PerformDynamicLayout	Volání Microsoft.Office.Core.IRibbonUI.InvalidateControl metoda nadřazené řízení, pokud RibbonComponent má dynamické nadřazené, například dynamické nabídky a rozložení není pozastaven. (Zděděno z RibbonComponent.)
	PerformLayout	Volání Microsoft.Office.Core.IRibbonUI.InvalidateControl -li RibbonComponent s nadřízenou a rozložení není pozastaven. (Zděděno z RibbonComponent.)
	ResumeLayout()	Účinek se obrátí SuspendLayout metody. (Zděděno z RibbonComponent.)
	ResumeLayout(Boolean)	Účinek se obrátí SuspendLayout metody. (Zděděno z RibbonComponent.)
	SuspendLayout	Zabrání aktualizaci stavu ovládací prvky na pásu karet aplikace Microsoft Office. (Zděděno z RibbonComponent.)

Nahoru

Události

	Název	Popis
	Disposed	Představuje metodu, která zpracovává Disposed události komponenty. (Zděděno z IComponent.)
	ItemsLoading	Vyvolá se v případě ovládacích prvků vnořených nabídek jsou načteny do aktuální nabídky v době běhu.

Nahoru

Poznámky

Visual Studio vytvoří RibbonMenu objekt při přetažení nabídky ovládacího prvku Office pás karet prvky karty nástrojů na pás karet Designer.

Můžete vytvořit RibbonMenu za běhu pomocí CreateRibbonMenu metoda RibbonFactory objektu.

Existují dva způsoby přístupu RibbonFactory objekt:

Při použití Factory vlastnosti třídy pásu karet.Použijte tento přístup z kódu ve vaší třídě pásu karet.
Při použití Globals.Factory.GetRibbonFactory metody.Použijte tento přístup z kódu mimo danou třídu pásu karet.

Obecné úlohy

Následující tabulka uvádí členy, které jsou vhodné pro běžné úkoly.Všechny tyto úkoly lze provést v době návrhu.Některé z těchto úkolů lze provádět v době běhu, pouze před pásu je načten do aplikace Office nebo před přidáním do dynamické nabídky ovládacího prvku v době běhu.Další informace naleznete v tématu Přehled modelu objektů pásu karet.

Úloha	Člen
V nabídce zobrazte obrázek.	Použití Image nebo ImageName vlastnost. Můžete také použít obrázky zobrazené v předdefinované ovládací prvky pásu karet.Chcete-li to provést, nastavte OfficeImageId na ID předdefinovaný obrázkových Microsoft Office, který chcete zobrazit jako ikonu nabídky.
Změna velikosti v nabídce.	Nastavit ControlSize vlastnost na hodnotu, kterou chcete.Například pro rozsáhlou nabídku, nastavte ji na Microsoft.Office.Core.RibbonControlSize.RibbonControlSizeLarge.
Změna velikosti položek v nabídce.	Nastavit ItemSize vlastnost na hodnotu, kterou chcete.Například chcete-li zobrazit větší položky, nastavte ji na Microsoft.Office.Core.RibbonControlSize.RibbonControlSizeLarge.
Povolte změny v nabídce za běhu (například povolit ovládací prvky, které mají být přidány do nabídky v době běhu).	Nastavte vlastnost Dynamic na true.
Přístup k ovládacím prvkům v nabídce, přidejte ovládací prvky do nabídky nebo odebrání ovládacích prvků z nabídky.	Použijte vlastnost Items.
V nabídce Microsoft Office, skupiny, nebo na jiný ovládací prvek, který obsahuje nabídky, přidání nabídky.	Přidat RibbonMenu k Items vlastnosti Microsoft Office nabídky, skupinu nebo ovládacího prvku.

[!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 naleznete v tématu Přehled nástrojů Visual Studio Tools for Office runtime.

Použití

Tato dokumentace popisuje verzi tohoto typu, který je používán v projektech systému Office cílených pro rozhraní .NET Framework 4 a .NET Framework 4.5. 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 projektů cílených na rozhraní .NET Framework 3.5 naleznete v následující informační části dokumentace k sadě Visual Studio 2008: https://go.microsoft.com/fwlink/?LinkId=160658.

Příklady

Následující příklad ukazuje, jak přidat a naplnit dílčí nabídku do existující nabídky v době běhu.

Lepší příklad, který aktualizuje ovládací prvky za běhu a zahrnuje získávání dat z ukázkové databáze AdventureWorks pomocí dotazy integrované do jazyka (LINQ), viz Návod: Aktualizace ovládacích prvků na pásu karet za běhu.

Chcete-li spustit příklad kódu, musíte nejprve provést následující kroky:

Přidat pásu karet (vizuální návrhář) položku Office project.
Přidání skupiny do vlastní karty.
Přidání do skupiny nabídky.
Nastavit (název) vlastnost v nabídce CustomerMenu.
Nastavit Popis vlastnosti nabídky zákazníkům.
Nastavit dynamický vlastnost v nabídce true.

To vám umožňuje přidávat a odebírat ovládací prvky v nabídce v době spuštění po pásu je načten do aplikace sady Office.

Private Sub PopulateCustomerMenu()
    ' Add two sub-menus to EmployeeMenu and populate each sub-menu
    ' First sub-menu
    Dim subMenu1 As RibbonMenu = Me.Factory.CreateRibbonMenu()
    subMenu1.Dynamic = True
    subMenu1.Label = "A - M"
    subMenu1.Items.Add(Me.Factory.CreateRibbonToggleButton())
    CType(subMenu1.Items.Last(), RibbonToggleButton).Label = "Hall, Don"
    subMenu1.Items.Add(Me.Factory.CreateRibbonToggleButton())
    CType(subMenu1.Items.Last(), RibbonToggleButton).Label = "Valdez, Rachel"
    CustomerMenu.Items.Add(subMenu1)

    ' Second sub-menu
    Dim subMenu2 As RibbonMenu = Me.Factory.CreateRibbonMenu()
    subMenu2.Dynamic = True
    subMenu2.Label = "N - Z"
    subMenu2.Items.Add(Me.Factory.CreateRibbonToggleButton())
    CType(subMenu2.Items.Last(), RibbonToggleButton).Label = "Robinson, Alex"
    CustomerMenu.Items.Add(subMenu2)

End Sub

private void PopulateCustomerMenu()
{
    // Add two sub-menus to EmployeeMenu and populate each sub-menu
    // First sub-menu
    RibbonMenu subMenu1 = this.Factory.CreateRibbonMenu();
    subMenu1.Dynamic = true;
    subMenu1.Label = "A - M";
    subMenu1.Items.Add(this.Factory.CreateRibbonToggleButton());
    ((RibbonToggleButton)subMenu1.Items.Last()).Label = "Hall, Don";
    subMenu1.Items.Add(this.Factory.CreateRibbonToggleButton());
    ((RibbonToggleButton)subMenu1.Items.Last()).Label = "Valdez, Rachel";
    CustomerMenu.Items.Add(subMenu1);

    // Second sub-menu
    RibbonMenu subMenu2 = this.Factory.CreateRibbonMenu();
    subMenu2.Dynamic = true;
    subMenu2.Label = "N - Z";
    subMenu2.Items.Add(this.Factory.CreateRibbonToggleButton());
    ((RibbonToggleButton)subMenu2.Items.Last()).Label = "Robinson, Alex";
    CustomerMenu.Items.Add(subMenu2);
}