Přehled modelu objektu pásu karet

Článek
03/04/2013

Visual Studio Tools for Office runtime Poskytuje model silně typový objekt, můžete získat a nastavit vlastnosti pro ovládací prvky pásu karet v době běhu.Například můžete dynamicky naplnění ovládacích prvků menu nebo zobrazit a skrýt ovládací prvky kontextově.Také můžete přidat karet, skupin a ovládací prvky pásu karet, ale pouze před pásu karet je načten v aplikaci sady Office.Informace naleznete v Nastavení vlastnosti, že se stanou jen.

Platí pro: Informace v tomto tématu se vztahují na projekty na úrovni dokumentu i na úrovni aplikace v následujících aplikacích: Excel 2013 a Excel 2010, InfoPath 2013 a InfoPath 2010, Outlook 2013 a Outlook 2010, PowerPoint 2013 a PowerPoint 2010, Project 2013 a Project 2010, Visio 2013 a Visio 2010, Word 2013 a Word 2010. Další informace naleznete v tématu Funkce aplikace Office a typ projektu.

Tento objektový model pásu se skládá převážně z Pásu třídy, Pásu události, a Tříd ovládacích prvků pásu.

Třída pásu karet

Při přidání nového pásu karet (vizuální návrhář) položky do projektu Visual Studio přidá Ribbon třídy do projektu.Ribbon Třída dědí z RibbonBase třídy.

Tato třída se zobrazí jako částečné třídy, která je rozdělena mezi pásu soubor kódu a soubor kódu Návrhář pásu karet.

Události na pásu karet

Ribbon Třída obsahuje tři následující události:

Událost	Description
RibbonBase.Load	Je aktivována při načtení přizpůsobení pásu karet aplikace sady Office.Load Obslužná rutina události je automaticky přidán do souboru kódu pásu karet.Pomocí této obslužné rutiny události spustit vlastní kód, který načte pásu karet.
RibbonBase.LoadImage	Umožňuje obrázky mezipaměti vlastního pásu při načtení pásu karet.Lehké výkon můžete získat, pokud píšete kód mezipaměti pásu obrázky v této obslužné rutiny.Další informace naleznete v tématu LoadImage.
RibbonBase.Close	Vyvolána, když ukončí instanci pásu karet.

Ovládací prvky pásu karet

Microsoft.Office.Tools.Ribbon Obor názvů obsahuje typ pro každý ovládací prvek, který se v Ovládací prvky pásu karet Office skupinu nástrojů.

Následující tabulka zobrazuje pro každý typ Ribbon řízení.Popis každého ovládacího prvku naleznete v tématu Přehled pásu karet.

Název ovládacího prvku	Název třídy
Pole	RibbonBox
Tlačítko	RibbonButton
Skupina tlačítek	RibbonButtonGroup
CheckBox	RibbonCheckBox
ComboBox	RibbonComboBox
Rozevírací seznam	RibbonDropDown
Textové pole	RibbonEditBox
Galerie	RibbonGallery
Skupiny	RibbonGroup
Popisek	RibbonLabel
Nabídka	RibbonMenu
Oddělovač	RibbonSeparator
Tlačítko Rozdělit	RibbonSplitButton
TAB	RibbonTab
Přepínací tlačítko	RibbonToggleButton

Microsoft.Office.Tools.Ribbon Oboru názvů používá předponu "Pásu" pro tyto typy pro zamezení kolize názvů s názvy tříd ovládacího prvku v System.Windows.Forms oboru názvů.

Při přidání ovládacího prvku v Návrháři pásu Návrhář pásu karet deklaruje třídy pro ovládací prvek jako pole v souboru kódu Návrhář pásu karet.

Běžné úkoly pomocí vlastností ovládacích prvků na pásu karet

Každý Ribbon ovládací prvek obsahuje vlastnosti, které můžete provádět různé úkoly, například přiřadíte ovládací prvek popisek nebo skrytí a zobrazení ovládacích prvků.

V některých případech stát vlastnosti jen pro čtení po načtení pásu karet nebo ovládací prvek je přidán do dynamické nabídky.Další informace naleznete v Se stát jen pro čtení nastavení vlastnosti.

Následující tabulka popisuje některé úkoly, které lze provést pomocí Ribbon vlastnosti ovládacího prvku.

Pro tento úkol:	Postupujte takto:
Zobrazení nebo skrytí ovládacího prvku.	Použijte vlastnost Visible.
Povolit nebo zakázat ovládací prvek.	Použijte vlastnost Enabled.
Nastavte velikost ovládacího prvku.	Použijte vlastnost ControlSize.
Získáte obraz, který se zobrazí v ovládacím prvku.	Použijte vlastnost Image.
Změňte popisek ovládacího prvku.	Použijte vlastnost Label.
Přidáte ovládací prvek dat definované uživatelem.	Použijte vlastnost Tag.
Get the items in a RibbonBox, RibbonDropDown, RibbonGallery, or Ovládací prvek RibbonSplitButton.	Použijte vlastnost Items.
Add items to a RibbonComboBox, RibbonDropDown, or RibbonGallery control.	Použijte vlastnost Items.
Přidat ovládací prvky a RibbonMenu.	Použijte vlastnost Items. Přidání ovládacích prvků RibbonMenu po pásu karet je načten do aplikace sady Office, je nutné nastavit Dynamic vlastnost true před načtením do aplikace Office pásu karet.Informace naleznete v Nastavení vlastnosti, že se stanou jen.
Získat vybrané položky RibbonComboBox, RibbonDropDown, or RibbonGallery.	Použijte vlastnost SelectedItem.Pro RibbonComboBox, použít Text vlastnost.
Získat skupiny RibbonTab.	Použijte vlastnost Groups.
Zadejte počet řádků a sloupců zobrazených v RibbonGallery.	Použití RowCount a ColumnCount vlastnosti.

Nastavení vlastností, které jsou jen pro čtení

Některé vlastnosti lze nastavit pouze před pásu karet.Existují tři místa nastavit tyto vlastnosti:

V aplikaci Visual Studio Vlastnosti okna.
V konstruktoru Ribbon třídy.
V CreateRibbonExtensibilityObject metoda ThisAddin, ThisWorkbook, nebo ThisDocument třídy do projektu.

Dynamické nabídky poskytují některé výjimky.Vytvořit nové ovládací prvky, nastavte jejich vlastnosti a přidat je do dynamické nabídky za běhu i po načtení pásu, který obsahuje nabídku.

Kdykoli můžete nastavit vlastnosti ovládacích prvků, které přidáte do dynamické nabídky.

Další informace naleznete v se stát jen pro čtení vlastnosti.

Nastavení vlastností v konstruktoru pásu karet

Můžete nastavit vlastnosti Ribbon konstruktoru ovládacího prvku Ribbon třídy.Tento kód musí být po volání InitializeComponent metoda.Následující příklad přidá nové tlačítko skupiny, pokud je aktuální čas: 17: 00 tichomořského času (UTC-8) nebo novější.

Přidejte následující kód.

<System.Diagnostics.DebuggerNonUserCode()> _
Public Sub New()
    MyBase.New(Globals.Factory.GetRibbonFactory())

    'This call is required by the Component Designer.
    InitializeComponent()
    Dim MyButton As Microsoft.Office.Tools.Ribbon.RibbonButton = _
        Me.Factory.CreateRibbonButton()
    MyButton.Label = "New Button"
    If System.DateTime.Now.Hour > 16 Then
        Group1.Items.Add(MyButton)
    End If

End Sub

public Ribbon1()
    : base(Globals.Factory.GetRibbonFactory())
{
    InitializeComponent();
    if (System.DateTime.Now.Hour > 16)
    {
        Microsoft.Office.Tools.Ribbon.RibbonButton button =
            this.Factory.CreateRibbonButton();
        button.Label = "New Button";
        group1.Items.Add(button);
    }
}

V Visual C# projekty, které jste provedli upgrade ze sady Visual Studio 2008 soubor kódu pás karet zobrazí konstruktoru.

Projekty jazyka Visual Basic nebo Visual C# projekty vytvořené v Visual Studio 2012, konstruktoru, zobrazí se v souboru kódu Návrhář pásu karet.Název tohoto souboru je YourRibbonItem.Designer.cs nebo YourRibbonItem.Designer.vb.Pokud chcete zobrazit tento soubor v projekty Visual Basic, musíte nejprve klepněte Zobrazit všechny soubory tlačítka v Průzkumníku řešení.

Nastavení vlastností v metodě CreateRibbonExtensibilityObject

Můžete nastavit vlastnosti Ribbon řízení při přepsání CreateRibbonExtensibilityObject metoda ThisAddin, ThisWorkbook, nebo ThisDocument třídy do projektu.Další informace o metodě CreateRibbonExtensibilityObject naleznete v tématu Přehled pásu karet.

Následující příklad nastaví vlastnosti pásu karet CreateRibbonExtensibilityObject metoda ThisWorkbook třídy projektu sešitu aplikace Excel.

Přidejte následující kód.

Protected Overrides Function CreateRibbonExtensibilityObject() _
    As Microsoft.Office.Core.IRibbonExtensibility
    Dim myCondition As Boolean = True
    If myCondition = True Then
        Dim tempRibbon As New Ribbon1()
        tempRibbon.Tab1.ControlId.ControlIdType = _
            Microsoft.Office.Tools.Ribbon.RibbonControlIdType.Office
        tempRibbon.Tab1.ControlId.OfficeId = "TabHome"
        Return Globals.Factory.GetRibbonFactory.CreateRibbonManager _
            (New Microsoft.Office.Tools.Ribbon.IRibbonExtension() {tempRibbon})
    Else
        Dim tempRibbon As New Ribbon2()
        tempRibbon.Tab1.ControlId.ControlIdType = _
            Microsoft.Office.Tools.Ribbon.RibbonControlIdType.Office
        tempRibbon.Tab1.ControlId.OfficeId = "TabInsert"
        Return Globals.Factory.GetRibbonFactory.CreateRibbonManager _
            (New Microsoft.Office.Tools.Ribbon.IRibbonExtension() {tempRibbon})
    End If
End Function

protected override Microsoft.Office.Core.IRibbonExtensibility
    CreateRibbonExtensibilityObject()
{
    bool myCondition = false;
    if (myCondition == true)
    {
        Ribbon1 tempRibbon = new Ribbon1();
        tempRibbon.tab1.ControlId.ControlIdType =
            Microsoft.Office.Tools.Ribbon.RibbonControlIdType.Office;
        tempRibbon.tab1.ControlId.OfficeId = "TabHome";
        return Globals.Factory.GetRibbonFactory().CreateRibbonManager( 
            new Microsoft.Office.Tools.Ribbon.IRibbonExtension[]
             { tempRibbon });
    }
    else
    {
        Ribbon2 tempRibbon = new Ribbon2();
        tempRibbon.tab1.ControlId.ControlIdType =
            Microsoft.Office.Tools.Ribbon.RibbonControlIdType.Office;
        tempRibbon.tab1.ControlId.OfficeId = "TabInsert";
        return Globals.Factory.GetRibbonFactory().CreateRibbonManager(
                            new Microsoft.Office.Tools.Ribbon.IRibbonExtension[] { tempRibbon });
    }
}

Vlastnosti, které jsou jen pro čtení

Následující tabulka obsahuje vlastnosti, které lze nastavit pouze před pásu karet.

[!POZNÁMKA]

Kdykoli můžete nastavit vlastnosti ovládacích prvků na dynamické nabídky.Tato tabulka v tomto případě neplatí.

Property	Třídy ovládacího prvku pásu karet
BoxStyle	RibbonBox
ButtonType	RibbonSplitButton
Počet sloupců	RibbonGallery
ControlId	RibbonTab
DialogLauncher	RibbonGroup
Dynamické	RibbonMenu
Globální	OfficeRibbon
Skupiny	RibbonTab
ImageName	RibbonButton RibbonComboBox RibbonDialogLauncher RibbonDropDown RibbonEditBox RibbonGallery RibbonMenu RibbonSplitButton RibbonToggleButton
ItemSize	RibbonMenu RibbonSplitButton
Hodnota MaxLength	RibbonComboBox RibbonEditBox
Název	RibbonComponent
Pozice	RibbonButton RibbonCheckBox RibbonGallery RibbonGroup RibbonMenu RibbonSeparator RibbonSplitButton RibbonTab RibbonToggleButton
RibbonType	OfficeRibbon
RowCount	RibbonGallery
ShowItemImage	RibbonComboBox RibbonDropDown RibbonGallery
ShowItemLabel	RibbonDropDown RibbonGallery
ShowItemSelection	RibbonGallery
SizeString	RibbonComboBox RibbonDropDown RibbonEditBox
StartFromScratch	OfficeRibbon
Karty	OfficeRibbon
Title	RibbonSeparator

Nastavení vlastností pro pásy karet, které se zobrazí v aplikaci Outlook inspektoři

Pokaždé, když uživatel otevře inspektor se zobrazí na pásu karet je vytvořena nová instance pásu karet.Můžete však nastavit vlastnosti uvedené v tabulce výše pouze před první instance pásu karet je vytvořena.Po první instance je vytvořena, tyto vlastnosti se změní pouze pro čtení, protože definuje první instance XML souboru, který aplikace Outlook používá k načtení pásu karet.

Máte-li podmíněné logiky, která nastaví všechny tyto vlastnosti na jinou hodnotu při vytváření dalších instancí pásu karet, tento kód bude mít žádný vliv.

[!POZNÁMKA]

Zajistit, aby název vlastnost pro každý ovládací prvek, který přidáte do pásu karet aplikace Outlook.Pokud přidáte ovládací prvek pásu karet aplikace Outlook v době spuštění, musíte tuto vlastnost nastavit v kódu.Pokud přidáte ovládací prvek pásu karet aplikace Outlook v době návrhu Name vlastnost je nastavena automaticky.

Události ovládacího prvku pásu karet

Každá třída ovládací prvek obsahuje jeden nebo více událostí.Následující tabulka popisuje tyto události.

Událost	Description
Click	Dochází při kliknutí na ovládací prvek.
TextChanged	Dochází při změně textu textového pole nebo pole se seznamem.
ItemsLoading	Dochází, když Items Office požaduje kolekce ovládacího prvku.Mezipaměti Office Items kolekce dokud kód změní vlastnosti ovládacího prvku nebo zavolejte IRibbonUI.InvalidateControl metoda.
ButtonClick	Při použití tlačítka RibbonGallery nebo RibbonDropDown klepnutí.
SelectionChanged	Dochází při výběru v RibbonDropDown nebo RibbonGallery změny.
DialogLauncherClick	Vyvolá se při klepnutí na ikonu spouštěč dialogového okna v pravém dolním rohu skupiny.

Obslužné rutiny událostí pro tyto události mají následující dva parametry.

Parametr	Description
sender	Object , Která představuje ovládací prvek, který událost vyvolal.
e	A RibbonControlEventArgs that contains a Microsoft.Office.Core.IRibbonControl.Tento ovládací prvek použít libovolnou vlastnost, která je k dispozici v objektovém modelu pásu podle přístup Visual Studio Tools for Office runtime.

Viz také

Sdílet prostřednictvím