Udostępnij za pośrednictwem


Dostosowywanie wstążki dla programu Outlook

Podczas dostosowywania wstążki w programie Microsoft Office Outlook należy rozważyć, gdzie w aplikacji będzie wyświetlana niestandardowa wstążka. Program Outlook wyświetla wstążkę w głównym interfejsie użytkownika aplikacji i w oknach, które są otwierane, gdy użytkownicy wykonują określone zadania, takie jak tworzenie wiadomości e-mail. Te okna aplikacji są nazwane inspektorami.

Dotyczy: informacje w tym temacie dotyczą projektów dodatków VSTO dla programu Outlook. Aby uzyskać więcej informacji, zobacz Funkcje dostępne przez aplikacja pakietu Office lication i typ projektu.

Dodawanie niestandardowej wstążki do głównego interfejsu użytkownika aplikacji

Główny interfejs użytkownika aplikacji w programie Outlook jest nazywany Eksploratorem. Jeśli używasz elementu wstążki (Visual Projektant), możesz dodać wstążkę do Eksploratora, klikając właściwość RibbonType wstążki w oknie Właściwości, a następnie wybierając pozycję Microsoft.Outlook.Explorer.

Przypisywanie wstążki do inspektora

Zidentyfikuj inspektora, który chcesz dostosować, określając typ wstążki odpowiadający klasie komunikatów inspektora.

Jeśli używasz elementu wstążki (Visual Projektant), kliknij właściwość RibbonType wstążki w oknie Właściwości, a następnie wybierz co najmniej jeden identyfikator wstążki z listy wartości.

Do projektu można dodać więcej niż jedną wstążkę. Jeśli więcej niż jedna wstążka udostępnia identyfikator wstążki, przesłoń CreateRibbonExtensibilityObject metodę w ThisAddin klasie projektu, aby określić, która wstążka ma być wyświetlana w czasie wykonywania. Aby uzyskać więcej informacji, zobacz Omówienie wstążki. Aby uzyskać więcej informacji na temat każdego typu wstążki, zobacz artykuł techniczny Dostosowywanie wstążki w programie Outlook 2007.

Określanie typu wstążki przy użyciu kodu XML wstążki

Jeśli używasz elementu wstążki (XML), sprawdź wartość parametru ribbonID w metodzie GetCustomUI i zwróć odpowiednią wstążkę.

Metoda GetCustomUI jest generowana automatycznie przez program Visual Studio w pliku kodu wstążki. Parametr ribbonID to ciąg, który identyfikuje Eksploratora lub określony typ inspektora. Aby uzyskać pełną listę możliwych wartości parametru ribbonID , zobacz artykuł techniczny Dostosowywanie wstążki w programie Outlook 2007.

W poniższym przykładzie kodu pokazano, jak wyświetlić niestandardową wstążkę tylko w inspektorze Microsoft.Outlook.Mail.Compose . Jest to inspektor otwierany po utworzeniu nowej wiadomości e-mail przez użytkownika. Wstążka do wyświetlenia jest określona w metodzie GetResourceText() , która jest generowana w klasie Wstążki . Aby uzyskać więcej informacji na temat klasy wstążki , zobacz Plik XML wstążki.

public string GetCustomUI(string ribbonID)
{
    string ribbonXML = String.Empty;

    if (ribbonID == "Microsoft.Outlook.Mail.Compose")
    {
        ribbonXML = GetResourceText("Trin_RibbonOutlookBasic.Ribbon1.xml");
    }

    return ribbonXML;
}