XML — Wstążka

Artykuł
06/10/2015

Element wstążki (XML) umożliwia Dostosowywanie Wstążki, za pomocą XML.Jeśli chcesz dostosować Wstążkę w sposób, który nie jest obsługiwany przez element wstążki (Visual Designer) przy użyciu wstążki (XML).Dla porównania tego, co można zrobić z każdym elementem, zobacz Wstążka ― Omówienie.

Zastosowanie: Informacje przedstawione w tym temacie mają zastosowanie do projektów na poziomie dokumentu i aplikacji dla następujących aplikacji: Excel 2013 i Excel 2010; InfoPath 2013 i InfoPath 2010; Outlook 2013 i Outlook 2010; PowerPoint 2013 i PowerPoint 2010; Project 2013 i Project 2010; Visio 2013 i Visio 2010; Word 2013 i Word 2010. Aby uzyskać więcej informacji, zobacz Funkcje dostępne w aplikacjach pakietu Office i typ projektu.

Dodając element wstążki (XML) do projektu

Można dodać Wstążki (XML) element do projektu dowolnego pakietu Office z Dodaj nowy element okno dialogowe.Visual Studio automatycznie dodaje następujące pliki do projektu:

Plik XML wstążki.Ten plik definiuje wstążce interfejsu użytkownika (UI).Użyj tego pliku, aby dodać elementy interfejsu użytkownika, takie jak tabulatory, grup i kontroli.Aby uzyskać szczegółowe informacje, zobacz Odwołanie do pliku XML wstążki później w tym temacie.
Plik kodu wstążki.Ten plik zawiera wstążki klasy.Ta klasa ma nazwę, która określona dla Wstążki (XML) pozycji w Dodaj nowy element okno dialogowe.Aplikacje Microsoft Office umożliwia załadowanie wstążki niestandardowej wystąpienie tej klasy.Aby uzyskać szczegółowe informacje, zobacz Wstążki odwołania klasy później w tym temacie.

Domyślnie te pliki, należy dodać grupę niestandardową, aby Dodatki karta na Wstążce.

Wyświetlanie wstążki niestandardowe w aplikacji pakietu Microsoft Office

Po dodaniu Wstążki (XML) element do projektu, należy dodać kod do ThisAddin, Ten skoroszyt, lub ThisDocument klasy, która zastępuje CreateRibbonExtensibilityObject metoda i zwraca wartość XML wstążki klasy do aplikacji pakietu Office.

Następujący kod dodaje nadpisania przykład CreateRibbonExtensibilityObject metoda i zwraca wartość XML wstążki klasy o nazwie 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();
}

Definiowanie zachowania Wstążka niestandardowa

Możesz odpowiadać na akcje użytkownika, takie jak kliknięcie przycisku na Wstążce, tworząc metod wywołania zwrotnego.Metody wywołania zwrotnego przypominają wydarzenia w Windows Forms formanty, ale są one identyfikowane przez atrybut XML element interfejsu użytkownika.Zapis metody w klasie Wstążki i formant wywołuje metodę, która ma taką samą nazwę jak wartość atrybutu.Na przykład można utworzyć metody wywołania zwrotnego, która jest wywoływana, gdy użytkownik kliknie przycisk na Wstążce.Dwa kroki są wymagane do utworzenia metody wywołania zwrotnego:

Atrybut przypisuje się do kontroli w pliku XML wstążki, który identyfikuje metody wywołania zwrotnego w kodzie.
Należy zdefiniować metodę wywołania zwrotnego w klasie wstążki.

[!UWAGA]

Program Outlook wymaga dodatkowych czynności.Aby uzyskać więcej informacji, zobacz Dostosowywanie Wstążki do programu Outlook.

Instruktaż, który pokazuje, jak do automatyzowania aplikacji ze Wstążki, zobacz Wskazówki: tworzenie kart niestandardowych za pomocą XML wstążki.

Przypisywanie metod wywołania zwrotnego do formantów

Aby przypisać metody wywołania zwrotnego do kontroli w pliku XML wstążki, należy dodać atrybut, który określa typ wywołania zwrotnego metody i nazwy metody.Na przykład, następujący element definiuje przycisk przełącznika, który ma onAction metody wywołania zwrotnego o nazwie OnToggleButton1.

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

onActionjest wywoływane, gdy użytkownik wykonuje główne zadania skojarzonego z określonego formantu.Na przykład onAction metody wywołania zwrotnego, przycisk przełącznika jest wywoływane, gdy użytkownik kliknie przycisk.

Metoda określona w atrybucie może mieć dowolną nazwę.Jednakże to musi odpowiadać nazwie metody zdefiniowane w pliku kodu wstążki.

Istnieje wiele różnych rodzajów metod wywołania zwrotnego, które można przypisać formanty wstążki.Pełną listę dostępnych metod wywołania zwrotnego dla każdego formantu, zobacz artykuł techniczny dostosowywania interfejsu użytkownika pakietu Office (2007) wstążki dla deweloperów (część 3 z 3).

Definiowanie metod wywołania zwrotnego

Definiowanie metod wywołania zwrotnego w klasie wstążki w pliku kodu wstążki.Metody wywołania zwrotnego ma kilka wymagań:

Musi być zadeklarowany jako publiczny.
Jego nazwa musi odpowiadać nazwie metody wywołania zwrotnego, który został przypisany do kontroli w pliku XML wstążki.
Jego podpis musi odpowiadać podpis typu metody wywołania zwrotnego, która jest dostępna dla formantu skojarzonego wstążki.

Pełną listę podpisów metody wywołania zwrotnego dla formanty wstążki, zobacz artykuł techniczny dostosowywania interfejsu użytkownika pakietu Office (2007) wstążki dla deweloperów (część 3 z 3).Visual Studio nie zapewnia obsługę technologii IntelliSense dla metod wywołania zwrotnego, które trzeba utworzyć w pliku kod wstążki.Tworzenie metody wywołania zwrotnego niezgodny prawidłowy podpis, kod zostanie skompilowany, ale nic nie nastąpi, gdy użytkownik kliknie formant.

Wszystkie metody wywołania zwrotnego mają IRibbonControl parametr, który reprezentuje formantu, który wywołał metodę.Ten parametr służy do ponownego użycia tej samej metody wywołania zwrotnego dla kilku formantów.Poniższy przykład kodu pokazuje onAction metody wywołania zwrotnego, który wykonuje różne zadania, w zależności od tego, które kliknie formant użytkownika.

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.");
    }
}

Odwołanie do pliku XML wstążki

Można zdefiniować niestandardowe wstążki przez dodawanie elementów i atrybutów do pliku XML wstążki.Domyślnie plik XML wstążki zawiera następujące XML.

<?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>

W poniższej tabeli opisano elementy domyślne w pliku XML wstążki.

Element	Opis
customUI	Reprezentuje wstążki niestandardowej w projektu Dodaj.
ribbon	Reprezentuje wstążki.
tabs	Reprezentuje zestaw karty wstążki.
tab	Reprezentuje pojedynczy karty wstążki.
group	Reprezentuje grupę formantów na karcie wstążki.

Elementy te mają atrybuty, które określają wygląd i zachowanie wstążki niestandardowej.W poniższej tabeli opisano domyślne atrybuty pliku XML wstążki.

Atrybut	Element nadrzędny	Opis
onLoad	customUI	Określa metodę, która jest wywoływana po załadowaniu aplikacji wstążki.
idMso	tab	Identyfikuje wbudowane karty do wyświetlania na Wstążce.
id	group	Identyfikuje grupę.
label	group	Określa tekst, który pojawia się w grupie.

Domyślne elementy i atrybuty w pliku XML wstążki są niewielki podzbiór elementów i atrybutów, które są dostępne.Pełną listę dostępnych elementów i atrybutów, zobacz artykuł techniczny dostosowywania interfejsu użytkownika pakietu Office (2007) wstążki dla deweloperów (część 2 z 3).

Odwołania klasy wstążki

Visual Studio generuje klasy wstążki w pliku kodu wstążki.Dodawanie metod wywołania zwrotnego dla formantów na Wstążce do tej klasy.Ta klasa implementuje IRibbonExtensibility interfejsu.

W poniższej tabeli opisano domyślnych metod tej klasy.

Metoda	Opis
GetCustomUI	Zwraca zawartość pliku XML wstążki.Aplikacje Microsoft Office wywołanie tej metody, aby uzyskać ciąg XML definiujący interfejs użytkownika wstążki niestandardowej.Ta metoda implementuje IRibbonExtensibility.GetCustomUI metoda. [!UWAGA] GetCustomUIpowinny zostać wprowadzone tylko zwraca zawartość pliku XML wstążki; to nie stosuje się do inicjowania dodatku.W szczególności, nie należy próbować do wyświetlania okien dialogowych lub inne okna w swojej GetCustomUI realizacji.W przeciwnym razie wstążki niestandardowej może nie zachowywać się poprawnie.Jeśli musisz uruchomić kod, który inicjuje dodatku, należy dodać kod do ThisAddIn_Startup programu obsługi zdarzeń.
OnLoad	Przypisuje IRibbonControl parametru do ribbon pole.Aplikacje Microsoft Office wywołanie tej metody, gdy są one ładowane wstążki niestandardowej.To pole umożliwia dynamiczne aktualizowanie wstążki niestandardowej.Aby uzyskać więcej informacji, zobacz artykuł techniczny dostosowywania interfejsu użytkownika pakietu Office (2007) wstążki dla deweloperów (część 1 z 3).
GetResourceText	Wywołana GetCustomUI metoda uzyskania zawartość pliku XML wstążki.

Zobacz też

Zadania

Wskazówki: tworzenie kart niestandardowych za pomocą XML wstążki

Inne zasoby

Wstążka ― Omówienie

Dostosowywanie interfejsu użytkownika pakietu Office

Udostępnij za pośrednictwem