RibbonMenu Rozhraní

Reference

Definice

Obor názvů:: Microsoft.Office.Tools.Ribbon

Sestavení:: Microsoft.Office.Tools.Common.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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

public interface class RibbonMenu : IDisposable, Microsoft::Office::Tools::Ribbon::RibbonControl, System::ComponentModel::IComponent

[System.Runtime.InteropServices.Guid("59dc7f42-aca2-484a-9622-1ee34a6cfd7d")]
public interface RibbonMenu : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonControl, System.ComponentModel.IComponent

[<System.Runtime.InteropServices.Guid("59dc7f42-aca2-484a-9622-1ee34a6cfd7d")>]
type RibbonMenu = interface
    interface RibbonControl
    interface RibbonComponent
    interface IComponent
    interface IDisposable

Public Interface RibbonMenu
Implements IComponent, IDisposable, RibbonControl

Atributy: GuidAttribute

Implementuje: RibbonComponent RibbonControl IComponent IDisposable

Příklady

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

Rozsáhlejší příklad, který aktualizuje ovládací prvky za běhu a zahrnuje získávání dat z ukázkové databáze AdventureWorks pomocí Language-Integrated Queries (LINQ), najdete v tématu Návod: Aktualizace ovládacích prvků na pásu karet za běhu.

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

Přidání položky na pásu karet (vizuální Designer) do projektu Office
Přidání skupiny na vlastní kartu
Přidejte do skupiny nabídku.
Vlastnost (Name) nabídky nastavte na CustomerMenu.
Vlastnost Popisek nabídky nastavte na Zákazníci.
Nastavte dynamickou vlastnost nabídky na true.

To vám umožní přidávat a odebírat ovládací prvky v nabídce za běhu po načtení pásu karet do aplikace Office.

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

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

Poznámky

Visual Studio vytvoří RibbonMenu objekt, když přetáhnete ovládací prvek Nabídka z karty Ovládací prvky pásu karet Office sady nástrojů na Designer pásu karet.

Za běhu můžete vytvořit RibbonMenu pomocí CreateRibbonMenu 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.

Obecné úlohy

V následující tabulce jsou uvedeny členy, které jsou užitečné pro běžné úlohy. Všechny tyto úlohy je možné provádět v době návrhu. Některé z těchto úloh lze provádět za běhu pouze před načtením pásu karet do aplikace Office nebo před přidání ovládacího prvku do dynamické nabídky za běhu. Další informace najdete v tématu Přehled objektového modelu pásu karet.

Úkol	Člen
Zobrazení obrázku v nabídce	Image Použijte vlastnost nebo ImageName . Můžete také opakovaně používat obrázky, které se zobrazují v předdefinovaných ovládacích prvcích pásu karet. Chcete-li to provést, nastavte OfficeImageId na ID integrovaného obrázku Microsoft Office, který chcete zobrazit jako ikonu nabídky.
Změňte velikost nabídky.	ControlSize Nastavte vlastnost na požadovanou hodnotu. Například u velké nabídky ji nastavte na `Microsoft.Office.Core.RibbonControlSize.RibbonControlSizeLarge`.
Změňte velikost položek v nabídce.	ItemSize Nastavte vlastnost na požadovanou hodnotu. Pokud chcete například zobrazit větší položky, nastavte ji na `Microsoft.Office.Core.RibbonControlSize.RibbonControlSizeLarge`.
Povolte změny nabídky za běhu (například pokud chcete povolit přidání ovládacích prvků do nabídky za běhu).	Nastavte Dynamic vlastnost 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	Items Použijte vlastnost .
Přidejte nabídku do nabídky Microsoft Office, do skupiny nebo do jiného ovládacího prvku, který může obsahovat nabídky.	RibbonMenu Přidejte do `Items` vlastnosti nabídky Microsoft Office, 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 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

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 nabídku změnit za běhu.
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ý je zobrazen v nabídce.
ImageName	Získá nebo nastaví název, který můžete použít v obslužné rutině LoadImage události k identifikaci obrázku pro nabídku.
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řístupová klávesa 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 od RibbonComponent)
OfficeImageId	Získá nebo nastaví obrázek k zobrazení v nabídce, 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)
Position	Získá nebo nastaví pozici nabídky, pokud je nabídka v nabídce Microsoft Office.
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 přes nabídku.
ShowImage	Získá nebo nastaví hodnotu, která označuje, zda je obrázek přidružený k nabídce je viditelný.
ShowLabel	Získá nebo nastaví hodnotu, která označuje, zda je popisek nabídky viditelný.
SuperTip	Získá nebo nastaví text víceřádkového tipu, který se zobrazí, když uživatel přesune ukazatel přes nabídku.
Tag	Získá nebo nastaví data specifická pro aplikaci, která je přidružena k tomuto RibbonComponent. (Zděděno od 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 Microsoft Office.
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

ItemsLoading

Vyvolá se při načtení ovládacích prvků nebo vnořených nabídek do aktuální nabídky za běhu.

Platí pro

Sdílet prostřednictvím