RibbonGallery – rozhraní

Článek
08/11/2011

Představuje ovládací prvek zobrazí nabídka 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á 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 řízení.
	Description	Získá nebo nastaví text, který se na tomto RibbonGallery řízení v nabídka nebo na tlačítko rozdělení.
	Enabled	Získá nebo nastaví hodnotu, která označuje, zda tento RibbonControl povolena. (Zděděno z RibbonControl.)
	Id	Načte řetězec, který se používá k identifikaci tohoto systém Microsoft Office RibbonControl objekt. (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 LoadImageobslužnou rutinuudálost .
	ItemImageSize	Získá nebo nastaví Size , dává rozměry obrázků, které jsou zobrazeny položky na této RibbonGallery.
	Items	kolekce získává RibbonDropDownItem součásti v tomto RibbonGallery.
	KeyTip	Získá nebo nastaví tuto klávesovou zkratku RibbonGallery.
	Label	Získá nebo nastaví text, který se na tomto RibbonGallery.
	Name	Získá nebo nastaví název tohoto RibbonComponent. (Zděděno z RibbonComponent.)
	OfficeImageId	Získá nebo nastaví bitová kopie zobrazit na ovládacím prvku, pokud chcete použít předdefinovaný ikonu systém Microsoft Office .
	Parent	Získává RibbonComponent , představuje to rodiče RibbonComponent. (Zděděno z RibbonComponent.)
	Position	Získá nebo nastaví pozici galerie, pokud je Galerie systém Microsoft Office nabídce.
	Ribbon	Získá nejvyšší Ribbon objekt , který obsahuje hierarchii řízení. (Zděděno z RibbonComponent.)
	RibbonUI	Infrastruktura. Získává IRibbonUI instance poskytovanéaplikace systém Microsoft Officekód rozšiřitelnosti Pás 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 tipu, který se zobrazí, když uživatel přesune ukazatel to RibbonGallery.
	SelectedItem	Získá nebo nastaví aktuálně vybrané položka.
	SelectedItemIndex	Získá nebo nastaví index aktuálně vybrané RibbonDropDownItem.
	ShowImage	Získá nebo nastaví hodnotu, která označuje, zda obrázek přidružený RibbonGallery je viditelný.
	ShowItemImage	Získá nebo nastaví hodnotu, která určuje, zda jsou obrázky zobrazeny položek v galerii.
	ShowItemLabel	Získá nebo nastaví hodnotu, která označuje, zda jsou zobrazeny popisky položek na tomto RibbonGallery.
	ShowItemSelection	Získá nebo nastaví hodnotu, která označuje, zda aktuálně vybrané RibbonDropDownItem 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.)

Na začátek

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é řízení, pokud RibbonComponent má dynamické nadřazené, například dynamické nabídkaa rozložení není pozastaven. (Zděděno z RibbonComponent.)
	PerformLayout	Volání Microsoft.Office.Core.IRibbonUI.InvalidateControl Pokud RibbonComponent s nadřízenou a rozložení není pozastaven. (Zděděno z RibbonComponent.)
	ResumeLayout()	Účinek obrátí SuspendLayout metody. (Zděděno z RibbonComponent.)
	ResumeLayout(Boolean)	Účinek obrátí SuspendLayout metody. (Zděděno z RibbonComponent.)
	SuspendLayout	Zabrání aktualizaci stavu ovládací prvky na Pás karetaplikace sady systém Microsoft Office. (Zděděno z RibbonComponent.)

Na začátek

Události

	Název	Popis
	ButtonClick	Dochází, když uživatel klepne na toto tlačítko RibbonGallery.
	Click	Dochází, když uživatel klepne na tlačítko položka na 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.

Na začátek

Poznámky

Stejně jako RibbonDropDown rozhraní RibbonGallery zobrazí nabídka RibbonDropDownItem objekty a RibbonButton ovládací prvky.

Na rozdíl od RibbonDropDown rozhraní, RibbonGalleryvyvolávározhraní Click události, nikoli SelectionChanged události, když uživatel klepne RibbonDropDownItem. To například znamená, že Click událost je aktivována dvakrát, když uživatel klepne na stejné RibbonDropDownItem dvakrát. ( SelectionChanged událost by maximálně jednou aktivována při výběr počáteční stejný scénář na RibbonDropDownv závislosti na výběr byl před prvním klepnutím.)

ShowItemSelectionvlastnost řídí zda aktuálně vybrané RibbonDropDownItem vizuálně odlišeny od nevybrané položky. Lze vybrat pouze jednu položka v RibbonGallery.

ItemImageSizevlastnost lze zadat velikost bitová kopie než 32 x 32 a 16 x 16.

Přidání objektů RibbonDropDownItem v době návrhu

Klepněte položky vlastnost v Vlastnosti okno.
Klepněte na tlačítko se třemi tečkami (...).
V Editor kolekce rozevírací, přidat, objednat a úprava nové položky.

Můžete přidat RibbonButton , aby RibbonGallery v čase návrhu.

Přidání ovládacích prvků RibbonButton 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, přidání objednávky, a úprava tlačítko nové ovládací prvky.

Můžete vytvořit RibbonGallery za běhu pomocí CreateRibbonGallery metodu RibbonFactory objektu.

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

Pomocí Factoryvlastnosttřída Pás karet. Použít tento přístup z Pás karet třídav kódu.
Pomocí Globals.Factory.GetRibbonFactory metoda. Použít tento přístup z kódu mimotřída Pás karet.

Některé vlastnosti tohoto ovládacího prvku lze nastavit pouze před načtením Pás karet do aplikace Office nebo před přidáním ovládacího prvku do dynamické nabídka v době běhu. Informace o nastavení těchto vlastností v Ribbon Object Model Overview.

Poznámka

Toto rozhraní je implementováno modulem runtime nástrojů Visual Studio Tools for Office. Rozhraní není určeno k implementaci do vašeho kódu. Další informace naleznete v tématu Visual Studio Tools for Office Runtime Overview.

Použití

Tato dokumentace popisuje verzi tohoto typu, který je používán v projektech systému Office cílených na rozhraní .NET Framework 4. V projektech cílených na rozhraní .NET Framework 3.5 může mít tento typ rozdílné členy a příklady kódů pro tento typ nemusí 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.