RibbonOfficeMenu Rozhraní

Definice

Obor názvů:

Microsoft.Office.Tools.Ribbon

Sestavení:

Microsoft.Office.Tools.Common.dll, Microsoft.Office.Tools.Common.v4.0.Utilities.dll

Poskytuje přístup k ovládacím prvkům, které přidáte do nabídky Microsoft Office.

public interface class RibbonOfficeMenu : IDisposable, Microsoft::Office::Tools::Ribbon::RibbonComponent, System::ComponentModel::IComponent

[System.Runtime.InteropServices.Guid("49cea6a9-3670-4ae0-9a36-9305e27f302b")]
public interface RibbonOfficeMenu : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonComponent, System.ComponentModel.IComponent

[<System.Runtime.InteropServices.Guid("49cea6a9-3670-4ae0-9a36-9305e27f302b")>]
type RibbonOfficeMenu = interface
    interface RibbonComponent
    interface IComponent
    interface IDisposable

Public Interface RibbonOfficeMenu
Implements IComponent, IDisposable, RibbonComponent

Atributy

GuidAttribute

Implementuje

RibbonComponent IComponent IDisposable

Příklady

Následující příklad prochází vlastní ovládací prvky v nabídce Office pásu karet a zobrazí jejich název. Chcete-li spustit tento příklad kódu, musíte nejprve provést následující kroky:

1. Přidání položky na pásu karet (vizuální Designer) do projektu Office

2. Přidejte tlačítko na tlačítko Microsoft Office.

3. Nastavte vlastnost (Name) tlačítka na myOfficeMenuButton.

4. Vlastnost PositionType nastavte na AfterOfficeID pod vlastností Position .

5. Ve vlastnosti Position nastavte vlastnost OfficeID na FilePrintMenu.

private void ListOfficeRibbonCustomControls()
{
    System.Windows.Forms.MessageBox.Show(
        "Listing all Office Menu custom controls...");
    foreach (RibbonComponent control in Globals.Ribbons.Ribbon1.OfficeMenu.Items)
    {
        System.Windows.Forms.MessageBox.Show("Control name: " + control.Name);
    }
}

Private Sub ListOfficeRibbonCustomControls()
    System.Windows.Forms.MessageBox.Show( _
            "Listing all Office Menu custom controls...")
    For Each control As RibbonComponent In Globals.Ribbons.Ribbon1.OfficeMenu.Items
        System.Windows.Forms.MessageBox.Show("Control name: " + control.Name)
    Next
End Sub

Poznámky

Když do projektu přidáte položku pásu karet (Visual Designer), sada Visual Studio automaticky přiřadí nový RibbonOfficeMenu objekt vlastnosti OfficeMenu vygenerovaného OfficeRibbon rozhraní. Tento objekt slouží k přidání nových ovládacích prvků do nabídky Microsoft Office za běhu nebo k získání přístupu k ovládacím prvkům, které jste přidali do nabídky Microsoft Office.

Ovládací prvky můžete přidávat za běhu, ale jenom před načtením pásu karet. Vytvořte instanci ovládacího prvku a pak přidejte nový ovládací prvek do Items kolekce. Další informace najdete v tématu Přehled objektového modelu 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

Items	Získá pás karet ovládací prvky, které jste přidali do nabídky Microsoft Office.
Name	Získá nebo nastaví název tohoto RibbonComponent. (Zděděno od RibbonComponent)
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)
Tag	Získá nebo nastaví data specifická pro aplikaci, která je přidružena k tomuto RibbonComponent. (Zděděno od RibbonComponent)

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)