Interfejs RibbonGallery

Artykuł
05/08/2013

Reprezentuje formant, który wyświetla menu z RibbonDropDownItem obiekty i RibbonButton kontroli.

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

Składnia

'Deklaracja
<GuidAttribute("c1cff037-81e7-44a0-8f9d-150237dfd312")> _
Public Interface RibbonGallery _
    Inherits RibbonControl, RibbonComponent, IComponent, IDisposable

[GuidAttribute("c1cff037-81e7-44a0-8f9d-150237dfd312")]
public interface RibbonGallery : RibbonControl, 
    RibbonComponent, IComponent, IDisposable

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

Właściwości

	Nazwa	Opis
	Buttons	Pobiera kolekcja przyciski w tej sprawie RibbonGallery.
	ColumnCount	Pobiera lub ustawia liczbę Item kolumny, w tym RibbonGallery.
	ControlSize	Pobiera lub ustawia rozmiar RibbonGallery kontroli.
	Description	Pobiera lub ustawia tekst pojawiający się na tym RibbonGallery formantu na przycisku menu lub Podziel.
	Enabled	Zwraca lub ustawia wartość, która wskazuje, czy to RibbonControl jest włączone. (Odziedziczone z RibbonControl).
	Id	Pobiera ciąg, który używa programu Microsoft Office, aby określić to RibbonControl obiektu. (Odziedziczone z RibbonControl).
	Image	Pobiera lub ustawia obraz, który jest wyświetlany na przycisku.
	ImageName	Pobiera lub ustawia nazwę, która służy do identyfikowania RibbonGallery w LoadImage programu obsługi zdarzeń.
	ItemImageSize	Pobiera lub ustawia Size , który daje wymiary obrazów, które są wyświetlane według elementów w tym RibbonGallery.
	Items	Pobiera kolekcja z RibbonDropDownItem składników, w tym RibbonGallery.
	KeyTip	Pobiera lub ustawia skrót klawiaturowy do tego RibbonGallery.
	Label	Pobiera lub ustawia tekst pojawiający się na tym RibbonGallery.
	Name	Pobiera lub ustawia nazwę tego RibbonComponent. (Odziedziczone z RibbonComponent).
	OfficeImageId	Pobiera lub ustawia obraz wyświetlany na temat formantu, aby użyć wbudowanego ikony programu Microsoft Office.
	Parent	Pobiera RibbonComponent , oznaczającą nadrzędny to RibbonComponent. (Odziedziczone z RibbonComponent).
	Position	Pobiera lub ustawia pozycję galerii, jeśli galerii znajduje się w Menu programu Microsoft Office.
	Ribbon	Pobiera najwyższego poziomu Ribbon obiekt, który zawiera hierarchii kontrolek. (Odziedziczone z RibbonComponent).
	RibbonUI	Infrastruktura. Pobiera IRibbonUI instancji, która jest dostarczonej wraz z aplikacją Microsoft Office do kodu rozszerzalność wstążki. (Odziedziczone z RibbonComponent).
	RowCount	Pobiera lub ustawia liczbę wierszy RibbonDropDownItem składniki tego RibbonGallery wyświetla.
	ScreenTip	Pobiera lub ustawia tekst porady, który pojawia się, gdy użytkownik przesuwa wskaźnik myszy nad tym RibbonGallery.
	SelectedItem	Pobiera lub ustawia aktualnie zaznaczonego elementu.
	SelectedItemIndex	Pobiera lub ustawia indeks aktualnie zaznaczonego RibbonDropDownItem.
	ShowImage	Zwraca lub ustawia wartość, która wskazuje, czy obrazu skojarzonego z RibbonGallery jest widoczny.
	ShowItemImage	Pobiera lub ustawia wartość, która wskazuje, czy obrazy są wyświetlane dla elementów w galerii.
	ShowItemLabel	Pobiera lub ustawia wartość, która wskazuje, czy etykiety mają być wyświetlane dla elementów w tej sprawie RibbonGallery.
	ShowItemSelection	Zwraca lub ustawia wartość, która wskazuje, czy aktualnie zaznaczonego RibbonDropDownItem różni się wizualnie od reszty niezaznaczone elementy.
	ShowLabel	Zwraca lub ustawia wartość, która wskazuje, czy etykieta to RibbonGallery 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 myszy nad RibbonGallery.
	Tag	Pobiera lub ustawia dane specyficzne dla aplikacji, która jest skojarzona z tym RibbonComponent. (Odziedziczone z RibbonComponent).
	Visible	Zwraca lub ustawia wartość, która wskazuje, czy to RibbonControl jest widoczny. (Odziedziczone z RibbonControl).

Początek

Metody

	Nazwa	Opis
	Dispose	Wykonuje zadania zdefiniowane aplikacji skojarzonej z zwalniania, zwalnianie lub resetowanie 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()	Odwraca efekt SuspendLayout metoda. (Odziedziczone z RibbonComponent).
	ResumeLayout(Boolean)	Odwraca efekt SuspendLayout metoda. (Odziedziczone z RibbonComponent).
	SuspendLayout	Zapobiega zastosowaniu programu Microsoft Office z odświeżanie stan formantów na Wstążce. (Odziedziczone z RibbonComponent).

Początek

Zdarzenia

	Nazwa	Opis
	ButtonClick	Występuje, gdy użytkownik kliknie przycisk w tej sprawie RibbonGallery.
	Click	Występuje, gdy użytkownik kliknie pozycję w tej sprawie RibbonGallery.
	Disposed	Metoda, która obsługuje reprezentuje Disposed zdarzeń składnika. (Odziedziczone z IComponent).
	ItemsLoading	Występuje, gdy to RibbonGallery jest otwarty.

Początek

Uwagi

Jak RibbonDropDown interfejsu, RibbonGallery , pojawi się menu z RibbonDropDownItem obiekty i RibbonButton kontroli.

W przeciwieństwie do RibbonDropDown interfejsu, RibbonGallery interfejs podnosi Click zdarzenia, a nie SelectionChanged zdarzenia, gdy użytkownik kliknie RibbonDropDownItem.Oznacza to, na przykład, że Click zdarzenie jest wywoływane dwa razy w przypadku, gdy użytkownik kliknie takie same RibbonDropDownItem dwa razy.( SelectionChanged Zdarzenie zostanie zwiększona co najwyżej raz podczas początkowej selekcji dokonano dla tego samego scenariusza na RibbonDropDown, w zależności od wybór był przed pierwszym kliknięciu.)

ShowItemSelection Formantów właściwości czy aktualnie zaznaczonego RibbonDropDownItem różni się wizualnie od niezaznaczone elementy.Można wybrać tylko jeden element naraz w RibbonGallery.

ItemImageSize Właściwość może służyć do określenia rozmiarów obrazu inne niż 16 x 16 i 32 x 32.

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 edytować nowych elementów.

Można dodać RibbonButton kontroluje, aby RibbonGallery 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.

Można utworzyć RibbonGallery w czasie wykonywania za pomocą CreateRibbonGallery metoda RibbonFactory obiektu.

Istnieją dwa sposoby dostępu do RibbonFactory obiekt:

Za pomocą Factory właściwość klasy wstążki.Użyć tej metody z kodu w klasie wstążki.
Za pomocą Globals.Factory.GetRibbonFactory metoda.Użyj tego podejścia od kodu poza klasy wstążki.

Niektóre właściwości tego formantu można ustawić, tylko w przypadku, przed załadowaniem wstążki do aplikacji pakietu Office lub zanim formant zostanie dodane do menu dynamiczne w czasie wykonywania.Aby uzyskać informacje o ustawianiu tych właściwości, zobacz Omówienie modelu obiektu wstążki.

[!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 dla pakietu Office, omówienie Runtime.

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.