Interfejs RibbonMenu
Reprezentuje menu na karcie wstążki lub w Menu programu Microsoft Office.
Przestrzeń nazw: Microsoft.Office.Tools.Ribbon
Zestaw: Microsoft.Office.Tools.Common (w Microsoft.Office.Tools.Common.dll)
Składnia
'Deklaracja
<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 uwidacznia następujące elementy członkowskie.
Właściwości
| Nazwa | Opis | |
|---|---|---|
.gif "Właściwość publiczna") |
ControlSize | Pobiera lub ustawia rozmiar menu. |
|
Description | Pobiera lub ustawia tekst pojawiający się w bieżącym menu. |
|
Dynamic | Pobiera lub ustawia wartość wskazującą, czy menu może być modyfikowana w czasie wykonywania. |
|
Enabled | Pobiera lub ustawia wartość wskazującą, czy to RibbonControl jest włączona. (Odziedziczone z RibbonControl). |
|
Id | Pobiera ciąg, program Microsoft Office używa się do identyfikacji, to RibbonControl obiektu. (Odziedziczone z RibbonControl). |
|
Image | Pobiera lub ustawia obraz, który jest wyświetlany w menu. |
|
ImageName | Pobiera lub ustawia nazwę używaną w LoadImage obsługi zdarzenia identyfikuje obraz menu. |
|
Items | Pobiera kolekcja formantów, które są w menu. |
|
ItemSize | Pobiera lub ustawia rozmiar elementów sterujących w menu. |
|
KeyTip | Pobiera lub ustawia klucz dostępu klawiatury z menu. |
|
Label | Pobiera lub ustawia tekst wyświetlany w menu. |
|
Name | Pobiera lub ustawia nazwę tego RibbonComponent. (Odziedziczone z RibbonComponent). |
|
OfficeImageId | Pobiera lub ustawia obraz do wyświetlenia w menu, jeżeli chcesz użyć wbudowanego ikonę programu Microsoft Office. |
|
Parent | Pobiera RibbonComponent reprezentująca nadrzędny to RibbonComponent. (Odziedziczone z RibbonComponent). |
|
Position | Pobiera lub ustawia pozycję menu, jeśli menu jest w Menu programu Microsoft Office. |
|
Ribbon | Pobiera najwyższego poziomu Ribbon obiekt, który zawiera hierarchię kontroli. (Odziedziczone z RibbonComponent). |
|
RibbonUI | Infrastruktura. Pobiera IRibbonUI instancji, która jest dostarczana przez aplikacji Microsoft Office do kodu rozszerzalność wstążki. (Odziedziczone z RibbonComponent). |
|
ScreenTip | Pobiera lub ustawia tekst porady, który pojawia się, gdy użytkownik przesuwa wskaźnik nad menu. |
|
ShowImage | Pobiera lub ustawia wartość wskazującą, czy jest widoczny obraz skojarzony z menu. |
|
ShowLabel | Pobiera lub ustawia wartość wskazującą, czy etykiety menu jest widoczny. |
|
Site | Zwraca lub ustawia ISite związane z IComponent. (Odziedziczone z IComponent). |
|
SuperTip | Pobiera lub ustawia tekst wielowierszowy porady, który pojawia się, gdy użytkownik przesuwa wskaźnik nad menu. |
|
Tag | Pobiera lub ustawia dane specyficzne dla aplikacji, która jest skojarzona z tym RibbonComponent. (Odziedziczone z RibbonComponent). |
|
Title | Pobiera lub ustawia tytuł, który jest wyświetlany, gdy użytkownik rozszerza się menu, które jest dodawane do Menu systemu Microsoft Office. |
|
Visible | Pobiera lub ustawia wartość wskazującą, czy to RibbonControl jest widoczny. (Odziedziczone z RibbonControl). |
Początek
Metody
| Nazwa | Opis | |
|---|---|---|
.gif "Metoda publiczna") |
Dispose | Wykonuje zadania zdefiniowane przez aplikację skojarzone z uwalnianiem, zwalnianiem lub resetowaniem niezarządzanych zasobów. (Odziedziczone z IDisposable). |
|
PerformDynamicLayout | Wywołania Microsoft.Office.Core.IRibbonUI.InvalidateControl metoda nadrzędnego kontroli, jeśli RibbonComponent ma element nadrzędny dynamicznych, takich jak menu dynamiczne i układ nie jest zawieszony. (Odziedziczone z RibbonComponent). |
|
PerformLayout | Wywołania Microsoft.Office.Core.IRibbonUI.InvalidateControl Jeśli RibbonComponent ma element nadrzędny i układ nie jest zawieszony. (Odziedziczone z RibbonComponent). |
|
ResumeLayout() | Cofa efekt SuspendLayout metody. (Odziedziczone z RibbonComponent). |
|
ResumeLayout(Boolean) | Cofa efekt SuspendLayout metody. (Odziedziczone z RibbonComponent). |
|
SuspendLayout | Zapobiega aplikacji Microsoft Office odświeżania stanu formantów na Wstążce. (Odziedziczone z RibbonComponent). |
Początek
Zdarzenia
| Nazwa | Opis | |
|---|---|---|
.gif "Zdarzenie publiczne") |
Disposed | Metoda, która obsługuje reprezentuje Disposed zdarzeń składnika. (Odziedziczone z IComponent). |
|
ItemsLoading | Występuje, gdy formanty lub zagnieżdżonych menu są ładowane do bieżącego menu w czasie wykonywania. |
Początek
Uwagi
Visual Studio utworzy RibbonMenu obiektu, podczas przeciągania Menu sterowania z Formanty wstążki Office na karcie Przybornik na projektanta wstążki.
Można utworzyć RibbonMenu w czasie wykonywania za pomocą CreateRibbonMenu metoda RibbonFactory obiektu.
Istnieją dwa sposoby dostępu do RibbonFactory obiekt:
Za pomocą Factory właściwość klasy wstążki.Użyj tego podejścia do kodu w klasie wstążki.
Za pomocą Globals.Factory.GetRibbonFactory metody.Użyj tego podejścia do kodu poza klasy wstążki.
Typowe zadania
Poniższa lista zawiera elementy członkowskie, które są przydatne do wykonywania typowych zadań.Wszystkie te zadania mogą być wykonywane w czasie projektowania.Niektóre z tych zadań można wykonać w czasie wykonywania tylko przed Wstążka jest ładowany do aplikacji pakietu Office lub zanim formant zostanie dodane do menu dynamiczne w czasie wykonywania.Aby uzyskać więcej informacji, zobacz Model obiektu Wstążka ― Omówienie.
Zadanie |
Członek |
|---|---|
Wyświetlanie obrazu w menu. |
Użycie Image lub ImageName właściwość. Można również ponownie użyć obrazów, które pojawiają się w wbudowane formanty wstążki.Aby to zrobić, należy ustawić OfficeImageId to identyfikator wbudowanego obrazu Microsoft Office, który chcesz wyświetlić jako ikonę menu. |
Zmień rozmiar menu. |
Ustaw ControlSize właściwość ma wartość.Na przykład, dla dużych menu, ustaw ją na Microsoft.Office.Core.RibbonControlSize.RibbonControlSizeLarge. |
Zmienianie rozmiaru elementów w menu. |
Ustaw ItemSize właściwość ma wartość.Na przykład, aby wyświetlić większe elementy, ustaw ją na Microsoft.Office.Core.RibbonControlSize.RibbonControlSizeLarge. |
Włącz zmiany do menu w czasie wykonywania (na przykład w celu umożliwienia kontroli, które mają zostać dodane do menu w czasie wykonywania). |
Ustaw Dynamic właściwość, aby true. |
Dostęp do formantów w menu, dodawanie formantów do menu lub usuwanie formantów z menu. |
Użyj właściwości Items. |
Dodawanie menu Microsoft Office menu, grupy, lub do innego formantu, który może zawierać menu. |
Dodaj RibbonMenu do Items Menu systemu Microsoft Office, grupy lub formantu. |
[!UWAGA]
Ten interfejs jest implementowany przez Visual Studio Tools for Office Runtime. Nie jest on przeznaczony do implementacji w kodzie. Aby uzyskać więcej informacji, zobacz Visual Studio Tools for Office Runtime ― Przegląd.
Użycie
W dokumentacji opisano wersję typu używanego w projektach dla pakietu Office przeznaczonych do pracy z programem .NET Framework 4 i .NET Framework 4.5. 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ę tego typu używanego w projektach przeznaczonych do działania z programem .NET Framework 3.5, zobacz następującą sekcję informacyjną w dokumentacji programu Visual Studio 2008: https://go.microsoft.com/fwlink/?LinkId=160658.
Przykłady
Poniższy przykład ilustruje sposób dodawania i wypełnić podmenu do istniejącego menu w czasie wykonywania.
Na przykład bogatsze, który aktualizuje formantów w czasie wykonywania i polega na pobieranie danych z bazy danych AdventureWorks próbki za pomocą kwerendy Language-Integrated (LINQ), zobacz Wskazówki: aktualizowanie formantów na wstążce w czasie wykonywania.
Aby uruchomić ten przykład kodu, należy najpierw wykonać następujące czynności:
Dodaj wstążki (wizualnego projektowania) element do projektu programu pakietu Office.
Dodaj grupę na karcie niestandardowe.
Dodawanie menu do grupy.
Ustaw (nazwa) właściwość menu, aby CustomerMenu.
Ustaw etykiety właściwość menu do klientów.
Ustaw dynamiczne właściwość menu, aby true.
Umożliwia dodawanie i usuwanie formantów menu w czasie wykonywania po załadowaniu wstążki do aplikacji pakietu Office.
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);
}
Zobacz też
Informacje
Przestrzeń nazw Microsoft.Office.Tools.Ribbon