RibbonGallery – rozhraní

Článek
01/03/2014

Představuje ovládací prvek, který zobrazuje nabídku RibbonDropDownItem objekty a RibbonButton 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á kolekce tlačítek na 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 zobrazený na tomto RibbonGallery ovládací tlačítka, nabídky nebo rozdělit.
	Enabled	Získá nebo nastaví hodnotu, která označuje, zda tento RibbonControl je povoleno. (Zděděno z RibbonControl.)
	Id	Získá řetězec, který aplikace Microsoft Office používá k identifikaci tohoto RibbonControl objektu. (Zděděno z RibbonControl.)
	Image	Získá nebo nastaví bitová kopie 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 tento RibbonGallery.
	Label	Získá nebo nastaví text zobrazený na 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í umístění galerie, je-li v galerii v nabídce Microsoft Office.
	Ribbon	Získá nejvyšší úrovně Ribbon objekt, který obsahuje hierarchii ovládacích prvků. (Zděděno z RibbonComponent.)
	RibbonUI	Infrastruktura. Získá IRibbonUI instance, která je k dispozici kódu rozšiřitelnost pásu karet aplikace Microsoft Office. (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 tipu, který se zobrazí, když uživatel přesune ukazatel nad to RibbonGallery.
	SelectedItem	Získá nebo nastaví aktuálně vybrané položky.
	SelectedItemIndex	Získá nebo nastaví index aktuálně vybrané RibbonDropDownItem.
	ShowImage	Získá nebo nastaví hodnotu, která označuje, zda obrázek přiřazený RibbonGallery je viditelná.
	ShowItemImage	Získá nebo nastaví hodnotu, která označuje, zda jsou obrázky zobrazeny pro položky 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 zbytku nevybrané položky.
	ShowLabel	Získá nebo nastaví hodnotu, která označuje, zda tento popisek RibbonGallery je viditelná.
	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 spojená s tímto RibbonComponent. (Zděděno z RibbonComponent.)
	Visible	Získá nebo nastaví hodnotu, která označuje, zda tento RibbonControl je viditelná. (Zděděno z RibbonControl.)

Nahoru

Metody

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

Nahoru

Události

	Název	Popis
	ButtonClick	Dochází, když uživatel klepne na tlačítko na to RibbonGallery.
	Click	Vyvolá se v případě, že uživatel klepne 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í při této RibbonGallery je otevřen.

Nahoru

Poznámky

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

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

ShowItemSelection Prvky vlastnost zda aktuálně vybrané RibbonDropDownItem je vizuálně odlišeny od nevybrané položky.Lze vybrat pouze jednu položku najednou v RibbonGallery.

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

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

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

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

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

Klepněte tlačítka vlastnost v Vlastnosti okno.
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 za běhu pomocí CreateRibbonGallery metoda RibbonFactory objektu.

Existují dva způsoby přístupu RibbonFactory objekt:

Při použití Factory vlastnosti 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 metody.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 je načten do aplikace Office nebo před přidáním do dynamické nabídky ovládacího prvku v době běhu.Informace o nastavení těchto vlastností naleznete v tématu Přehled modelu objektů 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 Přehled nástrojů Visual Studio Tools for Office runtime.

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 projektů cílených na rozhraní .NET Framework 3.5 naleznete v následující informační části dokumentace k sadě Visual Studio 2008: https://go.microsoft.com/fwlink/?LinkId=160658.