RibbonMenu – rozhraní

Článek
08/11/2011

Představuje nabídka na Pás karet kartu nebo v nabídce systém 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ídka.
	Description	Získá nebo nastaví text zobrazený v aktuální nabídka.
	Dynamic	Získá nebo nastaví hodnotu, která označuje, zda lze upravit nabídka v době běhu.
	Enabled	Získá nebo nastaví hodnotu, která označuje, zda tento RibbonControl povolena. (Zděděno z RibbonControl.)
	Id	Načte řetězec, který se používá k identifikaci tohoto systém Microsoft Office RibbonControl objekt. (Zděděno z RibbonControl.)
	Image	Získá nebo nastaví bitová kopie zobrazený v nabídka.
	ImageName	Získá nebo nastaví název používaný v obslužné rutinyudálostLoadImagek identifikaci bitová kopie pro nabídka.
	Items	Získá kolekce ovládacích prvků, které jsou v nabídka.
	ItemSize	Získá nebo nastaví velikost ovládacích prvků v nabídka.
	KeyTip	Získá nebo nastaví klávesnici přístupový klíč nabídka.
	Label	Získá nebo nastaví text, zobrazí se v nabídka.
	Name	Získá nebo nastaví název tohoto RibbonComponent. (Zděděno z RibbonComponent.)
	OfficeImageId	Získá nebo nastaví bitová kopie zobrazit v nabídka, pokud chcete použít předdefinovaný ikonu systém Microsoft Office .
	Parent	Získává RibbonComponent , představuje to rodiče RibbonComponent. (Zděděno z RibbonComponent.)
	Position	Získá nebo nastaví pozice nabídka, pokud se nabídka v nabídce systém Microsoft Office .
	Ribbon	Získá nejvyšší Ribbon objekt , který obsahuje hierarchii řízení. (Zděděno z RibbonComponent.)
	RibbonUI	Infrastruktura. Získává IRibbonUI instance poskytovanéaplikace systém Microsoft Officekód rozšiřitelnosti Pás karet . (Zděděno z RibbonComponent.)
	ScreenTip	Získá nebo nastaví text tipu, který se zobrazí, když uživatel přesune ukazatel nabídka.
	ShowImage	Získá nebo nastaví hodnotu, která označuje, zda je zobrazen bitová kopie přidružený k nabídka .
	ShowLabel	Získá nebo nastaví hodnotu, která označuje, zda je zobrazen jmenovka nabídka .
	Site	Získá nebo nastaví ISite přidružené IComponent. (Zděděno z IComponent.)
	SuperTip	Získá nebo nastaví víceřádkové tip text, který se zobrazí, když uživatel přesune ukazatel nabídka.
	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 rozšíří nabídka přidány do nabídky systém Microsoft Office .
	Visible	Získá nebo nastaví hodnotu, která označuje, zda tento RibbonControl je viditelný. (Zděděno z RibbonControl.)

Na začátek

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é řízení, pokud RibbonComponent má dynamické nadřazené, například dynamické nabídkaa rozložení není pozastaven. (Zděděno z RibbonComponent.)
	PerformLayout	Volání Microsoft.Office.Core.IRibbonUI.InvalidateControl Pokud RibbonComponent s nadřízenou a rozložení není pozastaven. (Zděděno z RibbonComponent.)
	ResumeLayout()	Účinek obrátí SuspendLayout metody. (Zděděno z RibbonComponent.)
	ResumeLayout(Boolean)	Účinek obrátí SuspendLayout metody. (Zděděno z RibbonComponent.)
	SuspendLayout	Zabrání aktualizaci stavu ovládací prvky na Pás karetaplikace sady systém Microsoft Office. (Zděděno z RibbonComponent.)

Na začátek

Události

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

Na začátek

Poznámky

Visual Studio vytvoří RibbonMenu objekt při přetažení nabídky ovládací prvek z Office Pás karet prvky kartě nástrojů na Pás karet Designer.

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

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

Pomocí Factoryvlastnosttřída Pás karet. Použít tento přístup z Pás karet třídav kódu.
Pomocí Globals.Factory.GetRibbonFactory metoda. Použít tento přístup z kódu mimotřída Pás karet.

Běžné úkoly

Členy, které jsou užitečné pro běžné úkoly v následující tabulce. Vše tyto úkoly lze provést v době návrhu. Některé z těchto úkolů lze provádět v době spuštění pouze před načtením Pás karet do aplikace Office nebo před přidáním ovládacího prvku do dynamické nabídka za běhu. Další informace naleznete v tématu Ribbon Object Model Overview.

Úloha	Člen
V nabídkazobrazení bitová kopie .	Použít Image nebo ImageName vlastnost. Obrázky ovládacích prvků vestavěných Pás karet můžete také znovu použít. To provedete nastavení OfficeImageId ID vestavěné systém Microsoft Office bitová kopie , kterou chcete zobrazit jako ikonu nabídka.
Změnit velikost nabídka.	Nastavit ControlSize na hodnotu vlastnosti můžete chtít. Například pro rozsáhlé nabídkanastavte ji na Microsoft.Office.Core.RibbonControlSize.RibbonControlSizeLarge.
Změnit velikost položky v nabídka.	Nastavit ItemSize na hodnotu vlastnosti můžete chtít. Například chcete-li zobrazit položky větší, nastavte ji na Microsoft.Office.Core.RibbonControlSize.RibbonControlSizeLarge.
Povolit změny v nabídka v době spuštění (například povolit ovládací prvky, které mají být přidány do nabídka za běhu).	Nastavit Dynamic Vlastnost true.
Přístup v nabídkaovládacích prvků, přidání ovládacích prvků do nabídkanebo odeberte ovládací prvky z nabídka.	Použití Items vlastnost.
Přidat nabídka nabídky systém Microsoft Office skupiny, nebo na jiný ovládací prvek, který může obsahovat nabídky.	Přidat RibbonMenu se Items vlastnost systém Microsoft Office Menu, skupině nebo ovládací prvek.

Poznámka

Toto rozhraní je implementováno modulem runtime nástrojů Visual Studio Tools for Office. Rozhraní není určeno k implementaci do vašeho kódu. Další informace naleznete v tématu Visual Studio Tools for Office Runtime Overview.

Použití

Tato dokumentace popisuje verzi tohoto typu, který je používán v projektech systému Office cílených na rozhraní .NET Framework 4. V projektech cílených na rozhraní .NET Framework 3.5 může mít tento typ rozdílné členy a příklady kódů pro tento typ nemusí 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 sub -nabídka do existující nabídka v době běhu.

Bohatší příkladu aktualizuje při spuštění ovládacích prvků a zahrnuje získávání dat z AdventureWorks ukázkové databáze pomocí dotazů (LINQ) Language-Integrated, viz Walkthrough: Updating the Controls on a Ribbon at Run Time.

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

Přidat Pás karet (vizuální Návrhář) položka Office projekt.
Přidat na kartu vlastní skupinu.
Přidat do skupiny nabídka .
Nastavit (Název) vlastnost v nabídka CustomerMenu.
Nastavit štítek vlastnost nabídka zákazníkům.
Nastavit dynamické vlastnost v nabídka true.

Umožňuje přidat a odebrat běhu po načtení Pás karet do aplikacesady Office v nabídka ovládacích prvků.

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);
}