Interfejs RibbonDropDown

Artykuł
01/08/2014

Reprezentuje listę elementów, które użytkownik może wybierać i listę przycisków wstążki, które użytkownik może klikać.

Przestrzeń nazw: Microsoft.Office.Tools.Ribbon
Zestaw: Microsoft.Office.Tools.Common (w Microsoft.Office.Tools.Common.dll)

Składnia

'Deklaracja
<GuidAttribute("dbee9dd2-d9b1-4d37-bb31-099fd6d64a68")> _
Public Interface RibbonDropDown _
    Inherits RibbonControl, RibbonComponent, IComponent, IDisposable

[GuidAttribute("dbee9dd2-d9b1-4d37-bb31-099fd6d64a68")]
public interface RibbonDropDown : RibbonControl, 
    RibbonComponent, IComponent, IDisposable

Typ RibbonDropDown uwidacznia następujące elementy członkowskie.

Właściwości

	Nazwa	Opis
	Buttons	Pobiera Kolekcja RibbonButton obiektów, które należą do tego RibbonDropDown.
	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 wyświetlany jest komunikat w tej sprawie RibbonDropDown.
	ImageName	Pobiera lub ustawia nazwę używaną w LoadImage obsługi zdarzenia identyfikuje obraz do celów kontroli.
	Items	Pobiera zbiór elementów, w tym RibbonDropDown.
	KeyTip	Pobiera lub ustawia skrót klawiaturowy dla tej RibbonDropDown.
	Label	Zwraca lub ustawia tekst pojawiający się na to RibbonDropDown.
	Name	Pobiera lub ustawia nazwę tego RibbonComponent. (Odziedziczone z RibbonComponent).
	OfficeImageId	Pobiera lub ustawia obraz do wyświetlenia na RibbonDropDown, jeśli chcesz użyć wbudowanego ikonę programu Microsoft Office.
	Parent	Pobiera RibbonComponent reprezentująca nadrzędny to RibbonComponent. (Odziedziczone z RibbonComponent).
	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	Zwraca lub ustawia tekst porady, który pojawia się, gdy użytkownik przesuwa wskaźnik nad RibbonDropDown.
	SelectedItem	Pobiera lub ustawia RibbonDropDownItem zaznaczona w danej chwili.
	SelectedItemIndex	Pobiera lub ustawia indeks obecnie zaznaczonego RibbonDropDownItem.
	ShowImage	Pobiera lub ustawia wartość wskazującą, czy obraz skojarzony z RibbonDropDown jest widoczny.
	ShowItemImage	Pobiera lub ustawia wartość wskazującą, czy obrazy są wyświetlane dla elementów w menu rozwijanym.
	ShowItemLabel	Pobiera lub ustawia wartość wskazującą, czy etykiety są wyświetlane dla elementów w menu rozwijanym.
	ShowLabel	Pobiera lub ustawia wartość wskazującą, czy etykiety to RibbonDropDown jest widoczny.
	Site	Zwraca lub ustawia ISite związane z IComponent. (Odziedziczone z IComponent).
	SizeString	Pobiera lub ustawia ciąg, który określa rozmiar RibbonDropDown.
	SuperTip	Zwraca lub ustawia tekst wielowierszowy porady, który pojawia się, gdy użytkownik przesuwa wskaźnik nad RibbonDropDown.
	Tag	Pobiera lub ustawia dane specyficzne dla aplikacji, która jest skojarzona z tym RibbonComponent. (Odziedziczone z RibbonComponent).
	Visible	Pobiera lub ustawia wartość wskazującą, czy to RibbonControl jest widoczny. (Odziedziczone z RibbonControl).

Początek

Metody

	Nazwa	Opis
	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
	ButtonClick	Występuje, gdy użytkownik kliknie przycisk RibbonDropDown.
	Disposed	Metoda, która obsługuje reprezentuje Disposed zdarzeń składnika. (Odziedziczone z IComponent).
	ItemsLoading	Występuje, gdy formanty są ładowane do RibbonDropDown.
	SelectionChanged	Występuje, gdy użytkownik wybierze element na Wstążce formant listy rozwijanej.

Początek

Uwagi

A RibbonDropDown może zawierać RibbonDropDownItem obiekty i RibbonButton kontroli.

Można utworzyć RibbonDropDown w czasie wykonywania za pomocą CreateRibbonDropDown 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.

Nie można dodać przyciski do Buttons kolekcji w czasie wykonywania po wstążki został załadowany do pakietu Office.

W poniższej procedurze wyjaśniono sposób dodawania RibbonDropDownItem obiekty i RibbonButton kontroluje do RibbonDropDown.

Aby dodać obiekty RibbonDropDownItem w czasie projektowania

Kliknij przycisk elementy właściwość w Właściwości okna.
Kliknij przycisk wielokropka (...).
W Listy rozwijanej Collection Editor, dodać, zamówienia i edycja nowych elementów.

Można dodać RibbonButton kontroluje do RibbonDropDown w czasie projektowania.

Aby dodać formanty RibbonButton w czasie projektowania

Kliknij przycisk przyciski właściwość w Właściwości okna.
Kliknij przycisk wielokropka (...).
W Przycisk Edytor kolekcji, dodać, zamówienia i nowe formanty przycisk Edytuj.

Niektóre elementy tego typu można ustawić tylko przed Wstążka jest ładowany do aplikacji pakietu Office.Aby uzyskać informacje o ustawianiu tych właściwości, zobacz Model obiektu Wstążka ― Omówienie.

[!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.