Pás karet – XML

Článek
05/16/2015

Položka pásu karet (XML) umožňuje přizpůsobit pás karet pomocí XML.Pokud chcete přizpůsobit pás karet způsobem, který není podporován, Položka pásu karet (vizuální Designer), pomocí položky pásu karet (XML).Porovnání můžete provést s každou položkou, viz Přehled pásu karet.

Platí pro: Informace v tomto tématu se vztahují na projekty na úrovni dokumentu i na úrovni aplikace v těchto 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 najdete v tématu Dostupné funkce podle aplikací systému Office a typů projektu.

Přidání položky pásu karet (XML) do projektu

Můžete přidat Pásu karet (XML) všechny aplikace Office Project z položky Přidat novou položku dialogové okno.Visual Studio automaticky přidá do projektu následující soubory:

Soubor XML pásu karet.Tento soubor definuje uživatelské rozhraní (UI) pásu karet.Tento soubor slouží k přidání prvků uživatelského rozhraní, například karet, skupin a ovládací prvky.Podrobnosti naleznete v tématu Odkaz na soubor XML pásu karet dále v tomto tématu.
Soubor kódu pásu karet.Tento soubor obsahuje pásu třídy.Tato třída má název zadaný pro Pásu karet (XML) v položce Přidat novou položku dialogové okno.Aplikace Microsoft Office pomocí instance této třídy načíst vlastní pásu karet.Podrobnosti naleznete v tématu Referenční třídy pásu dále v tomto tématu.

Ve výchozím nastavení tyto soubory přidat vlastní skupiny Doplňky kartu na pásu karet.

Zobrazení vlastního pásu karet v aplikaci Microsoft Office

Po přidání Pásu karet (XML) položku projektu, je nutné přidat kód ThisAddin, ThisWorkbook, nebo ThisDocument třída, která přepíše CreateRibbonExtensibilityObject třídy metoda a vrátí XML pásu karet aplikace Office.

Následující kód například přepíše CreateRibbonExtensibilityObject metoda a vrátí XML pásu karet třídy s názvem MyRibbon.

Protected Overrides Function CreateRibbonExtensibilityObject() As  _
Microsoft.Office.Core.IRibbonExtensibility
    Return New MyRibbon()
End Function

protected override Microsoft.Office.Core.IRibbonExtensibility CreateRibbonExtensibilityObject()
{
    return new MyRibbon();
}

Definování chování vlastního pásu karet

Můžete reagovat na akce uživatele, například klepnutím na tlačítko na pásu karet, vytvořením zpětného volání metody.Zpětné volání metody podobné události ovládacích prvků model Windows Forms, ale jsou označeny atributem XML prvek uživatelského rozhraní.Zapsat metody ve třídě pásu a ovládací prvek volá metodu, která má stejný název jako hodnotu atributu.Můžete například vytvořit metodu zpětného volání je volána, když uživatel klikne na tlačítko na pásu karet.Dva kroky jsou požadovány k vytvoření metody zpětného volání:

Přiřadíte atribut ovládacího prvku v souboru XML pásu karet, který identifikuje metodu zpětného volání v kódu.
Definujte metodu zpětného volání ve třídě pásu karet.

[!POZNÁMKA]

Aplikace Outlook vyžaduje další krok.Další informace naleznete v tématu Přizpůsobení pásu karet pro aplikaci Outlook.

Návod, který ukazuje, jak automatizovat aplikaci z pásu karet, viz Návod: Vytvoření vlastní karty pomocí kódu XML pásu karet.

Přiřazení zpětného volání metody kontroly

Ovládací prvek v souboru XML pásu karet přiřadit metodu zpětného volání, přidáte atribut, který určuje typ metody zpětného volání a název metody.Například následující element definuje přepínací tlačítko, které má onAction metoda zpětného volání s názvem OnToggleButton1.

<toggleButton id="toggleButton1" onAction="OnToggleButton1" />

onActionje volána, když uživatel provede hlavní úlohy spojené s konkrétní ovládací prvek.Například onAction přepínací tlačítko metodu zpětného volání je volána, když uživatel klikne na tlačítko.

Metoda, která určíte v atributu může mít libovolný název.Však musí odpovídat názvu metody definované v souboru kódu pásu karet.

Existuje mnoho různých typů zpětného volání metod, které můžete přiřadit ovládací prvky pásu karet.Úplný seznam metod zpětného volání k dispozici pro každý ovládací prvek, naleznete v článku technické přizpůsobení uživatelského rozhraní pásu karet Office (2007) pro vývojáře (část 3 ze 3).

Definování metod zpětného volání

Definujte volané metody pásu třídy v souboru kódu pásu karet.Metoda zpětného volání má několik požadavků:

Musí deklarovat jako public.
Název musí odpovídat názvu metody zpětného volání přiřazená ovládacímu prvku v souboru XML pásu karet.
Jeho podpis musí odpovídat podpis typu metody zpětného volání pro přidružený ovládací prvek pásu karet.

Úplný seznam podpisů metodu zpětného volání pro ovládací prvky pásu karet naleznete v článku technické přizpůsobení uživatelského rozhraní pásu karet Office (2007) pro vývojáře (část 3 ze 3).Visual Studio neposkytuje podporu technologie IntelliSense pro zpětné volání metody, které vytvoříte v souboru kódu pásu karet.Pokud vytvoříte metodu zpětného volání neodpovídá platný podpis, bude kompilovat kód, ale nic dojde, když uživatel klikne ovládací prvek.

Všechny metody zpětného volání IRibbonControl parametr, který představuje ovládací prvek, který se nazývá metoda.Tento parametr můžete znovu použít stejnou metodu zpětného volání pro více ovládacích prvků.Následující příklad kódu ukazuje onAction metodu zpětného volání, která provádí různé úkoly, podle které ovládací prvek uživatel klikne.

Public Sub OnActionCallback(ByVal control As Office.IRibbonControl, _
    ByVal isPressed As Boolean)

    If (control.Id = "checkBox1") Then
        MessageBox.Show("You clicked " + control.Id)
    Else
        MessageBox.Show("You clicked a different control.")
    End If 

End Sub

public void OnActionCallback(Office.IRibbonControl control, bool isPressed)
{
    if (control.Id == "checkBox1")
    {
        MessageBox.Show("You clicked " + control.Id);
    }
    else
    {
        MessageBox.Show("You clicked a different control.");
    }
}

Odkaz na soubor XML pásu karet

Soubor XML pásu karet můžete definovat své vlastní pásu přidávání prvků a atributů.Ve výchozím nastavení obsahuje následující XML souboru XML pásu karet.

<?xml version="1.0" encoding="UTF-8"?>
<customUI xmlns="https://schemas.microsoft.com/office/2006/01/customui" onLoad="OnLoad">
  <ribbon>
    <tabs>
      <tab idMso="TabAddIns">
        <group id="MyGroup"
               label="My Group">
        </group>
      </tab>
    </tabs>
  </ribbon>
</customUI>

Následující tabulka popisuje výchozí elementy v souboru XML pásu karet.

Element	Description
customUI	Představuje vlastní pásu karet v projektu doplňku.
ribbon	Představuje pásu karet.
tabs	Představuje sadu karty pásu karet.
tab	Představuje jednu kartu pásu karet.
group	Představuje skupinu ovládacích prvků na kartě pásu karet.

Tyto prvky mají atributy, které určují vzhled a chování vlastního pásu karet.Následující tabulka popisuje výchozí atributy v pásu karet XML souboru.

Atribut	Nadřazený prvek	Description
onLoad	customUI	Určuje metodu, která je volána při načtení aplikace pásu karet.
idMso	tab	Identifikuje předdefinovanou kartu zobrazit na pásu karet.
id	group	Identifikuje skupinu.
label	group	Určuje text, který se zobrazí ve skupině.

Výchozí elementy a atributy v pásu karet XML souboru jsou malou podmnožinu elementy a atributy, které jsou k dispozici.Úplný seznam dostupných prvků a atributů naleznete v článku technické přizpůsobení uživatelského rozhraní pásu karet Office (2007) pro vývojáře (část 2 ze 3).

Odkaz na třídu pásu karet

Visual Studio generuje pásu třídy v souboru kódu pásu karet.Tato třída přidáte metody zpětného volání pro ovládací prvky na pásu karet.Tato třída implementuje IRibbonExtensibility rozhraní.

Následující tabulka popisuje výchozí metody této třídy.

Metoda	Description
GetCustomUI	Vrátí obsah soubor XML pásu karet.Aplikace Microsoft Office volání této metody získat řetězec XML, která definuje uživatelské rozhraní vlastního pásu.Tato metoda implementuje IRibbonExtensibility.GetCustomUI metoda. [!POZNÁMKA] GetCustomUIby měla být provedena pouze na vrácení obsahu souboru XML pásu; není vhodné používat k inicializaci doplňku.Zejména by se neměl pokoušet zobrazení dialogových oken nebo jiných windows ve vaší GetCustomUI implementace.V opačném případě nemusí vlastní pásu chovat správně.Pokud máte spustit kód, který inicializuje doplněk, přidejte kód k ThisAddIn_Startup obslužné rutiny události.
OnLoad	Přiřadí IRibbonControl parametr ribbon pole.Aplikace Microsoft Office tuto metodu volat po jejich načtení vlastního pásu karet.Toto pole můžete dynamicky aktualizovat vlastní pásu karet.Další informace naleznete v článku technické přizpůsobení uživatelského rozhraní pásu karet Office (2007) pro vývojáře (část 1 ze 3).
GetResourceText	Volat GetCustomUI metoda získat obsah souboru XML pásu karet.

Viz také

Úkoly

Návod: Vytvoření vlastní karty pomocí kódu XML pásu karet

Další zdroje

Přehled pásu karet

Přizpůsobení uživatelského rozhraní systému Office

Sdílet prostřednictvím