RibbonMenu Interfejs

Odwołanie

Definicja

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

Zestaw:: Microsoft.Office.Tools.Common.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.

Reprezentuje menu na karcie Wstążki lub w menu pakietu 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

Atrybuty: GuidAttribute

Implementuje: RibbonComponent RibbonControl IComponent IDisposable

Przykłady

W poniższym przykładzie pokazano, jak dodać i wypełnić podrzędne menu do istniejącego menu w czasie wykonywania.

Aby uzyskać bardziej rozbudowany przykład aktualizacji kontrolek w czasie wykonywania i obejmuje pobieranie danych z przykładowej bazy danych AdventureWorks przy użyciu zapytań Language-Integrated (LINQ), zobacz Przewodnik: aktualizowanie kontrolek na wstążce w czasie wykonywania.

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 grupę do niestandardowej karty.
Dodaj menu do grupy.
Ustaw właściwość (Name) menu na CustomerMenu.
Ustaw właściwość Label menu na Wartość Klienci.
Ustaw właściwość Dynamic menu na truewartość .

Dzięki temu można dodawać i usuwać kontrolki w menu w czasie wykonywania po załadowaniu wstążki do aplikacji pakietu 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

Uwagi

Program Visual Studio tworzy RibbonMenu obiekt podczas przeciągania kontrolki Menu z karty Kontrolki wstążki pakietu Office przybornika na Projektant wstążki.

Obiekt można utworzyć RibbonMenu w czasie wykonywania przy użyciu CreateRibbonMenu metody RibbonFactory obiektu .

Istnieją dwa sposoby uzyskiwania RibbonFactory dostępu do obiektu:

Za pomocą Factory właściwości klasy Wstążki. Użyj podejścia z kodu w klasie wstążki.
Przy użyciu Globals.Factory.GetRibbonFactory metody . Użyj podejścia do kodu spoza klasy wstążki.

Typowe zadania

W poniższej tabeli wymieniono elementy członkowskie, które są przydatne w przypadku typowych zadań. Wszystkie te zadania można wykonywać w czasie projektowania. Niektóre z tych zadań można wykonywać w czasie wykonywania tylko przed załadowaniem wstążki do aplikacji pakietu Office lub przed dodaniu kontrolki do menu dynamicznego w czasie wykonywania. Aby uzyskać więcej informacji, zobacz Temat Omówienie modelu obiektów wstążki.

Zadanie	Członek
Wyświetl obraz w menu.	Image Użyj właściwości orImageName. Można również ponownie używać obrazów wyświetlanych we wbudowanych kontrolkach wstążki. W tym celu ustaw OfficeImageId identyfikator wbudowanego obrazu pakietu Microsoft Office, który ma być wyświetlany jako ikona menu.
Zmień rozmiar menu.	ControlSize Ustaw właściwość na odpowiednią wartość. Na przykład w przypadku dużego menu ustaw dla niego wartość `Microsoft.Office.Core.RibbonControlSize.RibbonControlSizeLarge`.
Zmień rozmiar elementów w menu.	ItemSize Ustaw właściwość na odpowiednią wartość. Aby na przykład wyświetlić większe elementy, ustaw go na `Microsoft.Office.Core.RibbonControlSize.RibbonControlSizeLarge`wartość .
Włącz zmiany w menu w czasie wykonywania (na przykład, aby umożliwić dodawanie kontrolek do menu w czasie wykonywania).	Dynamic Ustaw właściwość na `true`wartość .
Uzyskaj dostęp do kontrolek w menu, dodaj kontrolki do menu lub usuń kontrolki z menu.	Items Użyj właściwości .
Dodaj menu do menu pakietu Microsoft Office, grupy lub innej kontrolki, która może zawierać menu.	Dodaj element RibbonMenu do `Items` właściwości menu pakietu Microsoft Office, grupy lub kontrolki.

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

ControlSize	Pobiera lub ustawia rozmiar menu.
Description	Pobiera lub ustawia tekst wyświetlany w bieżącym menu.
Dynamic	Pobiera lub ustawia wartość wskazującą, czy menu można modyfikować w czasie wykonywania.
Enabled	Pobiera lub ustawia wartość wskazującą, czy jest to RibbonControl włączone. (Odziedziczone po RibbonControl)
Id	Pobiera ciąg używany przez pakiet Microsoft Office do identyfikowania tego RibbonControl obiektu. (Odziedziczone po RibbonControl)
Image	Pobiera lub ustawia obraz wyświetlany w menu.
ImageName	Pobiera lub ustawia nazwę, której można użyć w procedurze LoadImage obsługi zdarzeń, aby zidentyfikować obraz menu.
Items	Pobiera kolekcję kontrolek, które znajdują się w menu.
ItemSize	Pobiera lub ustawia rozmiar kontrolek w menu.
KeyTip	Pobiera lub ustawia klawisz dostępu klawiatury w menu.
Label	Pobiera lub ustawia tekst wyświetlany w menu.
Name	Pobiera lub ustawia nazwę tego RibbonComponentelementu . (Odziedziczone po RibbonComponent)
OfficeImageId	Pobiera lub ustawia obraz do wyświetlenia w menu, jeśli chcesz użyć wbudowanej ikony pakietu Microsoft Office.
Parent	Pobiera element RibbonComponent reprezentujący element nadrzędny tego RibbonComponentobiektu . (Odziedziczone po RibbonComponent)
Position	Pobiera lub ustawia pozycję menu, jeśli menu znajduje się w menu pakietu Microsoft Office.
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)
ScreenTip	Pobiera lub ustawia tekst porad, który pojawia się, gdy użytkownik przesuwa wskaźnik nad menu.
ShowImage	Pobiera lub ustawia wartość wskazującą, czy obraz skojarzony z menu jest widoczny.
ShowLabel	Pobiera lub ustawia wartość wskazującą, czy etykieta menu jest widoczna.
SuperTip	Pobiera lub ustawia tekst wielowierszowej porady, który pojawia się, gdy użytkownik przesuwa wskaźnik nad menu.
Tag	Pobiera lub ustawia dane specyficzne dla aplikacji, które są skojarzone z tym RibbonComponent. (Odziedziczone po RibbonComponent)
Title	Pobiera lub ustawia tytuł wyświetlany, gdy użytkownik rozwija menu dodane do menu pakietu Microsoft Office.
Visible	Pobiera lub ustawia wartość wskazującą, czy jest ona RibbonControl widoczna. (Odziedziczone po RibbonControl)

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)

Zdarzenia

ItemsLoading

Występuje, gdy kontrolki lub menu zagnieżdżone są ładowane do bieżącego menu w czasie wykonywania.

Dotyczy

Udostępnij za pośrednictwem