RibbonGallery Rozhraní

Definice

Obor názvů:

Microsoft.Office.Tools.Ribbon

Sestavení:

Microsoft.Office.Tools.Common.dll

Představuje ovládací prvek, který zobrazuje nabídku RibbonDropDownItem objektů a RibbonButton ovládacích prvků.

public interface class RibbonGallery : IDisposable, Microsoft::Office::Tools::Ribbon::RibbonControl, System::ComponentModel::IComponent

[System.Runtime.InteropServices.Guid("c1cff037-81e7-44a0-8f9d-150237dfd312")]
public interface RibbonGallery : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonControl, System.ComponentModel.IComponent

[<System.Runtime.InteropServices.Guid("c1cff037-81e7-44a0-8f9d-150237dfd312")>]
type RibbonGallery = interface
    interface RibbonControl
    interface RibbonComponent
    interface IComponent
    interface IDisposable

Public Interface RibbonGallery
Implements IComponent, IDisposable, RibbonControl

Atributy

GuidAttribute

Implementuje

RibbonComponent RibbonControl IComponent IDisposable

Poznámky

Podobně jako rozhraní RibbonDropDownRibbonGallery zobrazuje i nabídka RibbonDropDownItem objektů a RibbonButton ovládacích prvků.

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

Vlastnost ShowItemSelection určuje, jestli se aktuálně vybraná RibbonDropDownItem položka vizuálně odlišuje od nevybraných položek. V jednom okamžiku lze vybrat pouze jednu položku v objektu RibbonGallery.

Vlastnost ItemImageSize se dá použít k určení jiných velikostí obrázků než 16 × 16 a 32 × 32.

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

1. Klikněte na vlastnost Items v okně Vlastnosti .

2. Klikněte na tlačítko se třemi tečkami (...).

3. V rozevíracím seznamu kolekce Editor přidávat, řadit a upravovat nové položky.

Ovládací prvky můžete přidat RibbonButton do souboru v době návrhu RibbonGallery .

Přidání ovládacích prvků RibbonButton v době návrhu

1. V okně Vlastnosti klikněte na vlastnost Tlačítka.

2. Klikněte na tlačítko se třemi tečkami (...).

3. V kolekci tlačítek Editor přidat, seřadit a upravit nové ovládací prvky tlačítka.

Za běhu můžete vytvořit RibbonGallery pomocí CreateRibbonGallery metody objektu RibbonFactory .

Existují dva způsoby přístupu k objektu RibbonFactory :

• Pomocí Factory vlastnosti pásu karet třídy. Použijte tento přístup z kódu ve své třídě pásu karet.

• Pomocí Globals.Factory.GetRibbonFactory metody . Použijte tento přístup z kódu mimo svou třídu pásu karet.

Některé vlastnosti tohoto ovládacího prvku lze nastavit pouze před načtením pásu karet do aplikace Office nebo před jeho přidání do dynamické nabídky za běhu. Informace o nastavení těchto vlastností najdete 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 najdete v tématu přehled modulu Visual Studio Tools for Office Runtime.

Využití

Tato dokumentace popisuje verzi tohoto typu, který se používá v projektech Office cílených na rozhraní .NET Framework 4 nebo novější. 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, které cílí na rozhraní .NET Framework 3.5, naleznete v následující referenční části v dokumentaci k sadě Visual Studio 2008: http://go.microsoft.com/fwlink/?LinkId=160658.

Vlastnosti

Buttons	Získá kolekci tlačítek na tomto RibbonGallery.
ColumnCount	Získá nebo nastaví počet sloupců Item v tomto RibbonGalleryobjektu .
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ím prvku v nabídce nebo rozdělené tlačítko.
Enabled	Získá nebo nastaví hodnotu, která označuje, zda je povolena RibbonControl . (Zděděno od RibbonControl)
Id	Získá řetězec, který Microsoft Office používá k identifikaci tohoto RibbonControl objektu. (Zděděno od RibbonControl)
Image	Získá nebo nastaví obrázek, který se zobrazí na tlačítku.
ImageName	Získá nebo nastaví název, který můžete použít k identifikaci RibbonGallery v obslužné rutině LoadImage události.
ItemImageSize	Získá nebo nastaví , Size která dává rozměry obrázků, které jsou zobrazeny položky v tomto RibbonGallery.
Items	Získá kolekci komponent v tomto RibbonGalleryobjektu RibbonDropDownItem .
KeyTip	Získá nebo nastaví klávesovou zkratku pro tento RibbonGallery.
Label	Získá nebo nastaví text, který se zobrazí na tomto RibbonGalleryobjektu .
Name	Získá nebo nastaví název tohoto RibbonComponent. (Zděděno od RibbonComponent)
OfficeImageId	Získá nebo nastaví obrázek, který se zobrazí v ovládacím prvku, pokud chcete použít předdefinované ikony Microsoft Office.
Parent	Získá objekt RibbonComponent , který představuje nadřazený objekt tohoto RibbonComponentobjektu . (Zděděno od RibbonComponent)
Position	Získá nebo nastaví umístění galerie, pokud je galerie v nabídce Microsoft Office.
Ribbon	Získá objekt nejvyšší úrovně Ribbon , který obsahuje hierarchii ovládacích prvků. (Zděděno od RibbonComponent)
RibbonUI	Získá IRibbonUI instance, která je poskytnuta microsoft office aplikace do kódu rozšiřitelnosti pásu karet. (Zděděno od RibbonComponent)
RowCount	Získá nebo nastaví počet řádků RibbonDropDownItem součástí, které se zobrazí RibbonGallery .
ScreenTip	Získá nebo nastaví text tipu, který se zobrazí, když uživatel přesune ukazatel myši na tento RibbonGallery.
SelectedItem	Získá nebo nastaví aktuálně vybranou položku.
SelectedItemIndex	Získá nebo nastaví index aktuálně vybraného RibbonDropDownItemobjektu .
ShowImage	Získá nebo nastaví hodnotu, která označuje, zda je obrázek přidružený k objektu RibbonGallery je viditelný.
ShowItemImage	Získá nebo nastaví hodnotu, která označuje, zda jsou zobrazeny obrázky pro položky v galerii.
ShowItemLabel	Získá nebo nastaví hodnotu, která označuje, zda jsou zobrazeny popisky pro položky na tomto RibbonGallery.
ShowItemSelection	Získá nebo nastaví hodnotu, která označuje, zda je aktuálně vybraný RibbonDropDownItem vizuálně odlišný od ostatních nevybraných položek.
ShowLabel	Získá nebo nastaví hodnotu, která označuje, zda je popisek pro tuto RibbonGallery hodnotu viditelný.
SuperTip	Získá nebo nastaví víceřádkový text tipu, který se zobrazí, když uživatel přesune ukazatel přes RibbonGallery.
Tag	Získá nebo nastaví data specifická pro aplikaci, která je přidružena k tomuto RibbonComponent. (Zděděno od RibbonComponent)
Visible	Získá nebo nastaví hodnotu, která označuje, zda je viditelný RibbonControl . (Zděděno od RibbonControl)

Metody

PerformDynamicLayout()	Volá Metodu Microsoft.Office.Core.IRibbonUI.InvalidateControl nadřazeného ovládacího prvku, pokud RibbonComponent má dynamický nadřazený prvek, například dynamickou nabídku, a rozložení není pozastaveno. (Zděděno od RibbonComponent)
PerformLayout()	Volání Microsoft.Office.Core.IRibbonUI.InvalidateControl pokud RibbonComponent má nadřazený a rozložení není pozastaveno. (Zděděno od RibbonComponent)
ResumeLayout()	Obrátí účinek SuspendLayout() metody . (Zděděno od RibbonComponent)
ResumeLayout(Boolean)	Obrátí účinek SuspendLayout() metody . (Zděděno od RibbonComponent)
SuspendLayout()	Zabrání aplikaci Microsoft Office v aktualizaci stavu ovládacích prvků na pásu karet. (Zděděno od RibbonComponent)

Událost

ButtonClick	Vyvolá se, když uživatel klikne na tlačítko na tomto RibbonGallery.
Click	Vyvolá se, když uživatel klikne na položku na tomto RibbonGallery.
ItemsLoading	Vyvolá se při RibbonGallery otevření.