RibbonMenu – rozhraní

Článek
05/14/2013

Představuje nabídku na kartu na 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, který se zobrazí v aktuální nabídce.
	Dynamic	Získá nebo nastaví hodnotu, která označuje, zda lze v nabídce Upravit v době běhu.
	Enabled	Získá nebo nastaví hodnotu, která označuje, zda to RibbonControl je povoleno. (Zděděno z RibbonControl.)
	Id	Získá řetězec, který používá aplikaci Microsoft Office k identifikaci tohoto RibbonControl objektu. (Zděděno z RibbonControl.)
	Image	Získá nebo nastaví obrázek, který je zobrazen v nabídce.
	ImageName	Získá nebo nastaví název, který lze použít v LoadImage obslužnou rutinu události pro identifikaci obrazu pro nabídky.
	Items	Získá kolekci 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í přístupovou klávesu klávesnice 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, chcete-li 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šší Ribbon objekt, který obsahuje hierarchii ovládacích prvků. (Zděděno z RibbonComponent.)
	RibbonUI	Infrastruktura. Získá IRibbonUI instanci, která je součástí aplikace Microsoft Office kódu rozšiřitelnost pásu karet. (Zděděno z RibbonComponent.)
	ScreenTip	Získá nebo nastaví text popisu, který se zobrazí, když uživatel přesune ukazatel 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 popis 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, který je 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ídku, která je přidána do nabídky aplikace Microsoft Office.
	Visible	Získá nebo nastaví hodnotu, která označuje, zda to RibbonControl je zobrazen. (Zděděno z RibbonControl.)

Nahoru

Metody

	Název	Popis
	Dispose	Provádí úkoly definované aplikací spojených s uvolněním, uvolnění nebo obnovení nespravované prostředky. (Zděděno z IDisposable.)
	PerformDynamicLayout	Volání Microsoft.Office.Core.IRibbonUI.InvalidateControl metoda nadřazeného ovládacího prvku, pokud RibbonComponent s nadřízenou dynamická, jako jsou dynamické nabídky a rozložení není pozastavena. (Zděděno z RibbonComponent.)
	PerformLayout	Volání Microsoft.Office.Core.IRibbonUI.InvalidateControl -li RibbonComponent s nadřízenou a rozložení není pozastavena. (Zděděno z RibbonComponent.)
	ResumeLayout()	Účinek se obrátí SuspendLayout metoda. (Zděděno z RibbonComponent.)
	ResumeLayout(Boolean)	Účinek se obrátí SuspendLayout metoda. (Zděděno z RibbonComponent.)
	SuspendLayout	Zabrání aplikaci Microsoft Office, který brání v aktualizaci stavu ovládacích prvků na pásu karet. (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 objektu při přetažení nabídky ovládacího prvku Ovládací prvky pásu karet Office kartě nástrojů na Návrhář pásu karet.

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

Existují dva způsoby, jak získat přístup RibbonFactory objekt:

Při použití Factory vlastnost 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 metoda.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 užitečné 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 karet je načten do aplikace sady Office nebo předtím, než ovládací prvek je přidán do dynamické nabídky v době běhu.Další informace naleznete v tématu Přehled modelu objektu pásu karet.

Úloha	Člen
V nabídce zobrazte obrázek.	Použití Image nebo ImageName vlastnost. Můžete také znovu použít obrázky zobrazené v vestavěné ovládací prvky pásu karet.Chcete-li to provést, nastavte OfficeImageId ID předdefinovaný obrázkových Microsoft Office, který chcete zobrazit jako ikonu nabídky.
Změňte velikost nabídky.	Nastavit ControlSize vlastnost na hodnotu, kterou chcete.Například pro rozsáhlou nabídku, nastavte ji na Microsoft.Office.Core.RibbonControlSize.RibbonControlSizeLarge.
Změňte velikost položky 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 povolení ovládacích prvků, 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řidání ovládacích prvků 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 na Items vlastnost Microsoft Office nabídky, skupiny 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 Visual Studio Tools pro přehled Runtime sady Office.

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 v projektech cílených na rozhraní .NET Framework 3.5 naleznete v následující informační části dokumentace k aplikaci Visual Studio 2008: https://go.microsoft.com/fwlink/?LinkId=160658.

Příklady

Následující příklad ukazuje, jak přidat a naplnit podnabídky určený do existující nabídky v době běhu.

Bohatší příklad, který aktualizuje ovládací prvky za běhu, zahrnuje získávání dat z ukázkové databáze AdventureWorks pomocí Language-Integrated dotazy LINQ (Language), viz Názorný postup: Aktualizace ovládacích prvků na pásu karet v době spuštění.

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

Přidat pásu karet (vizuální návrhář) položky pro aplikaci Office project.
Přidání skupiny do vlastní kartu.
Do nabídky přidáte do skupiny.
Nastavit (název) vlastnost v nabídce CustomerMenu.
Nastavit Popis vlastnost 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 karet 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);
}