Sdílet prostřednictvím


RibbonGallery Rozhraní

Definice

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
Implementuje

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í.

Platí pro