RibbonOfficeMenu Interfejs

Odwołanie

Definicja

Przestrzeń nazw:: Microsoft.Office.Tools.Ribbon

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

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Zapewnia dostęp do kontrolek dodanych do menu pakietu 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

Atrybuty: GuidAttribute

Implementuje: RibbonComponent IComponent IDisposable

Przykłady

Poniższy przykład iteruje niestandardowe kontrolki w menu pakietu Office wstążki i wyświetla ich nazwę. Aby uruchomić ten przykład kodu, należy najpierw wykonać następujące czynności:

Dodaj element wstążki (Visual Projektant) do projektu pakietu Office.
Dodaj przycisk do przycisku pakietu Microsoft Office.
Ustaw właściwość (Name) przycisku na myOfficeMenuButton.
Ustaw właściwość PositionType na AfterOfficeID we właściwości Position .
Ustaw właściwość OfficeID na FilePrintMenu we właściwości Position .

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

Uwagi

Po dodaniu elementu wstążki (Visual Projektant) do projektu program Visual Studio automatycznie przypisuje nowy RibbonOfficeMenu obiekt do OfficeMenu właściwości wygenerowanego OfficeRibbon interfejsu. Ten obiekt służy do dodawania nowych kontrolek do menu pakietu Microsoft Office w czasie wykonywania lub kontroli dostępu dodanych do menu pakietu Microsoft Office.

Kontrolki można dodawać w czasie wykonywania, ale tylko przed załadowaniem wstążki. Utwórz wystąpienie kontrolki, a następnie dodaj nową kontrolkę do kolekcji Items . Aby uzyskać więcej informacji, zobacz Temat Omówienie modelu obiektów wstążki.

Uwaga

Ten interfejs jest wdrażany przy użyciu programu Visual Studio Tools for Office Runtime. Nie jest on przeznaczony do implementacji w kodzie. Aby uzyskać więcej informacji, zobacz omówienie środowiska uruchomieniowego Visual Studio Tools dla pakietu Office.

Użycie

W tej dokumentacji opisano wersję tego typu używaną tylko w projektach pakietu Office przeznaczonych dla platformy .NET Framework 4 i nowszych. W projektach przeznaczonych do pracy z programem .NET Framework 3.5 ten typ może mieć inne elementy członkowskie, a przykładowy kod podany dla tego typu może nie działać. Aby uzyskać dokumentację dotyczącą tego typu projektów przeznaczonych dla .NET Framework 3.5, zobacz następującą sekcję referencyjną w dokumentacji programu Visual Studio 2008: http://go.microsoft.com/fwlink/?LinkId=160658.

Właściwości

Items	Pobiera kontrolki wstążki dodane do menu pakietu Microsoft Office.
Name	Pobiera lub ustawia nazwę tego RibbonComponentelementu . (Odziedziczone po RibbonComponent)
Parent	Pobiera element RibbonComponent reprezentujący element nadrzędny tego RibbonComponentobiektu . (Odziedziczone po RibbonComponent)
Ribbon	Pobiera obiekt najwyższego poziomu Ribbon zawierający hierarchię sterowania. (Odziedziczone po RibbonComponent)
RibbonUI	Pobiera wystąpienie IRibbonUI udostępniane przez aplikację pakietu Microsoft Office do kodu rozszerzalności wstążki. (Odziedziczone po RibbonComponent)
Tag	Pobiera lub ustawia dane specyficzne dla aplikacji, które są skojarzone z tym RibbonComponent. (Odziedziczone po RibbonComponent)

Metody

PerformDynamicLayout()	Wywołuje metodę Microsoft.Office.Core.IRibbonUI.InvalidateControl kontrolki nadrzędnej, jeśli RibbonComponent obiekt ma dynamiczny element nadrzędny, taki jak menu dynamiczne, i układ nie jest zawieszony. (Odziedziczone po RibbonComponent)
PerformLayout()	Wywołuje element Microsoft.Office.Core.IRibbonUI.InvalidateControl, jeśli RibbonComponent obiekt ma element nadrzędny i układ nie jest zawieszony. (Odziedziczone po RibbonComponent)
ResumeLayout()	Odwraca efekt SuspendLayout() metody . (Odziedziczone po RibbonComponent)
ResumeLayout(Boolean)	Odwraca efekt SuspendLayout() metody . (Odziedziczone po RibbonComponent)
SuspendLayout()	Uniemożliwia aplikacji pakietu Microsoft Office odświeżanie stanu kontrolek na wstążce. (Odziedziczone po RibbonComponent)

Dotyczy

Udostępnij za pośrednictwem