RibbonGallery – rozhraní

Článek
05/14/2013

Představuje ovládací prvek, který zobrazí nabídku RibbonDropDownItem objekty a RibbonButton ovládací prvky.

Obor názvů: Microsoft.Office.Tools.Ribbon
Sestavení: Microsoft.Office.Tools.Common (v Microsoft.Office.Tools.Common.dll)

Syntaxe

'Deklarace
<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 zveřejňuje následující členy.

Vlastnosti

	Název	Popis
	Buttons	Získá kolekci tlačítka v tomto RibbonGallery.
	ColumnCount	Získá nebo nastaví počet Item sloupce v tomto RibbonGallery.
	ControlSize	Získá nebo nastaví velikost RibbonGallery ovládacího prvku.
	Description	Získá nebo nastaví text, který se zobrazí v tomto RibbonGallery ovládací tlačítka, nabídky nebo rozdělit.
	Enabled	Získá nebo nastaví hodnotu, která označuje, zda to RibbonControl je povoleno. (Zděděno z RibbonControl.)
	Id	Získá řetězec, který používá aplikaci Microsoft Office k identifikaci tohoto RibbonControl objektu. (Zděděno z RibbonControl.)
	Image	Získá nebo nastaví obrázek, který je zobrazen na tlačítku.
	ImageName	Získá nebo nastaví název používaný k identifikaci RibbonGallery v LoadImage obslužnou rutinu události.
	ItemImageSize	Získá nebo nastaví Size , který určuje rozměry obrázků, které jsou zobrazeny položky v tomto RibbonGallery.
	Items	Získá kolekci RibbonDropDownItem součásti v tomto RibbonGallery.
	KeyTip	Získá nebo nastaví klávesová zkratka pro tuto RibbonGallery.
	Label	Získá nebo nastaví text, který se zobrazí v tomto RibbonGallery.
	Name	Získá nebo nastaví název tohoto RibbonComponent. (Zděděno z RibbonComponent.)
	OfficeImageId	Získá nebo nastaví obrázek zobrazit v ovládacím prvku, pokud chcete použít integrovanou ikonu Microsoft Office.
	Parent	Získá RibbonComponent , která představuje nadřazené tohoto RibbonComponent. (Zděděno z RibbonComponent.)
	Position	Získá nebo nastaví pozici v galerii, je-li v galerii v nabídce Microsoft Office.
	Ribbon	Získá nejvyšší Ribbon objekt, který obsahuje hierarchii ovládacích prvků. (Zděděno z RibbonComponent.)
	RibbonUI	Infrastruktura. Získá IRibbonUI instanci, která je součástí aplikace Microsoft Office kódu rozšiřitelnost pásu karet. (Zděděno z RibbonComponent.)
	RowCount	Získá nebo nastaví počet řádků RibbonDropDownItem součásti touto RibbonGallery zobrazí.
	ScreenTip	Získá nebo nastaví text popisu, který se zobrazí, když uživatel přesune ukazatel nad to RibbonGallery.
	SelectedItem	Získá nebo nastaví aktuálně vybranou položku.
	SelectedItemIndex	Získá nebo nastaví aktuálně vybraný index RibbonDropDownItem.
	ShowImage	Získá nebo nastaví hodnotu, která označuje, zda obraz přiřazenou RibbonGallery je zobrazen.
	ShowItemImage	Získá nebo nastaví hodnotu, která označuje, zda jsou obrázky zobrazeny u položek v galerii.
	ShowItemLabel	Získá nebo nastaví hodnotu, která označuje, zda jsou popisky zobrazeny pro položky v tomto RibbonGallery.
	ShowItemSelection	Získá nebo nastaví hodnotu, která označuje, zda aktuálně vybrané RibbonDropDownItem je vizuálně odlišeny od ostatních nezaškrtnutými položkami.
	ShowLabel	Získá nebo nastaví hodnotu, která označuje, zda tento popisek RibbonGallery je zobrazen.
	Site	Získá nebo nastaví ISite přidružené IComponent. (Zděděno z IComponent.)
	SuperTip	Získá nebo nastaví text víceřádkové tip, který se zobrazí, když uživatel přesune ukazatel RibbonGallery.
	Tag	Získá nebo nastaví specifická data, který je spojen s tímto RibbonComponent. (Zděděno z RibbonComponent.)
	Visible	Získá nebo nastaví hodnotu, která označuje, zda to RibbonControl je zobrazen. (Zděděno z RibbonControl.)

Nahoru

Metody

	Název	Popis
	Dispose	Provádí úkoly definované aplikací spojených s uvolněním, uvolnění nebo obnovení nespravované prostředky. (Zděděno z IDisposable.)
	PerformDynamicLayout	Volání Microsoft.Office.Core.IRibbonUI.InvalidateControl metoda nadřazeného ovládacího prvku, pokud RibbonComponent s nadřízenou dynamická, jako jsou dynamické nabídky a rozložení není pozastavena. (Zděděno z RibbonComponent.)
	PerformLayout	Volání Microsoft.Office.Core.IRibbonUI.InvalidateControl -li RibbonComponent s nadřízenou a rozložení není pozastavena. (Zděděno z RibbonComponent.)
	ResumeLayout()	Účinek se obrátí SuspendLayout metoda. (Zděděno z RibbonComponent.)
	ResumeLayout(Boolean)	Účinek se obrátí SuspendLayout metoda. (Zděděno z RibbonComponent.)
	SuspendLayout	Zabrání aplikaci Microsoft Office, který brání v aktualizaci stavu ovládacích prvků na pásu karet. (Zděděno z RibbonComponent.)

Nahoru

Události

	Název	Popis
	ButtonClick	Nastane, když uživatel klikne na tlačítko v tomto RibbonGallery.
	Click	Nastane, když uživatel klikne na položku v tomto RibbonGallery.
	Disposed	Představuje metodu, která zpracovává Disposed události komponenty. (Zděděno z IComponent.)
	ItemsLoading	Dochází, když to RibbonGallery je otevřen.

Nahoru

Poznámky

Podobně jako RibbonDropDown rozhraní, RibbonGallery zobrazí nabídku RibbonDropDownItem objekty a RibbonButton ovládací prvky.

Na rozdíl od RibbonDropDown rozhraní, RibbonGallery rozhraní vyvolá Click události, spíše než SelectionChanged události, jakmile uživatel klikne RibbonDropDownItem.To například znamená, že Click událost je vyvolána dvakrát, když uživatel klikne na stejné RibbonDropDownItem dvakrát.( SelectionChanged By být vyvolána událost maximálně jednou při počáteční výběr byl proveden stejný scénář na RibbonDropDownv závislosti na výběru byla před prvním klepnutím.)

ShowItemSelection Ovládací prvky vlastností zda aktuálně vybrané RibbonDropDownItem je vizuálně odlišeny od nezaškrtnutými položkami.Lze vybrat pouze jednu položku najednou v RibbonGallery.

ItemImageSize Vlastnost lze použít k určení velikosti obrazu, než 16 x 16 a 32 x 32.

Chcete-li přidat objekty RibbonDropDownItem v době návrhu

Klepněte položky vlastnost v Vlastnosti okna.
Klepněte na tlačítko se třemi tečkami (...).
V Editor kolekce rozevírací seznam, objednávky a přidejte nové položky upravit.

Můžete přidat RibbonButton ovládací prvky RibbonGallery v době návrhu.

Chcete-li přidat RibbonButton ovládací prvky v době návrhu

Klepněte tlačítka vlastnost v Vlastnosti okna.
Klepněte na tlačítko se třemi tečkami (...).
V Tlačítko Editor kolekce, objednávky a přidejte nové ovládací prvky tlačítko Upravit.

Můžete vytvořit RibbonGallery v době běhu pomocí CreateRibbonGallery metoda RibbonFactory objektu.

Existují dva způsoby, jak získat přístup RibbonFactory objekt:

Při použití Factory vlastnost třídy pásu karet.Použijte tento přístup z kódu ve vaší třídě pásu karet.
Při použití Globals.Factory.GetRibbonFactory metoda.Použijte tento přístup z kódu mimo danou třídu pásu karet.

Některé vlastnosti tohoto ovládacího prvku lze nastavit pouze před pásu karet je načten do aplikace sady Office nebo předtím, než ovládací prvek je přidán do dynamické nabídky v době běhu.Informace o nastavení těchto vlastností naleznete v tématu Přehled modelu objektu pásu karet.

[!POZNÁMKA]

Toto rozhraní je implementováno modulem Visual Studio Tools for Office Runtime. Rozhraní není určeno k implementaci do vašeho kódu. Další informace naleznete v tématu Visual Studio Tools pro přehled Runtime sady Office.

Použití

Tato dokumentace popisuje verzi tohoto typu, který je používán v projektech systému Office cílených pro rozhraní .NET Framework 4 a .NET Framework 4.5. V projektech cílených pro rozhraní .NET Framework 3.5 může mít tento typ jiné členy a ukázky kódu, poskytnuté pro tento typ, nemusejí fungovat. Dokumentaci k tomuto typu v projektech cílených na rozhraní .NET Framework 3.5 naleznete v následující informační části dokumentace k aplikaci Visual Studio 2008: https://go.microsoft.com/fwlink/?LinkId=160658.