Настройка ленты для Outlook
Обновлен: Ноябрь 2007
Применение |
|---|
Сведения в данном разделе относятся только к указанным проектам Visual Studio Tools for Office и версиям приложений Microsoft Office. Тип проекта
Версия Microsoft Office
Дополнительные сведения см. в разделе Доступность функций по типам приложений и проектов. |
При настройке ленты в Microsoft Office Outlook 2007 необходимо учитывать, где в приложении отображаются пользовательские ленты. Outlook не отображает ленту в основном интерфейсе пользователя приложения. Outlook отображает ленту в окнах, открывающихся при выполнении пользователем определенных действий, например при создании сообщений электронной почты. Эти окна приложения называются Инспекторы.
Назначение ленте инспектора
Следует указать инспектор, который необходимо настроить, путем выбора типа ленты, соответствующего классу сообщений для этого инспектора. Действия для указания типа ленты зависят от того, используется ли конструктор лент или XML-лента.
При использовании конструктора ленты
При использовании элемента Лента (визуальный конструктор) щелкните свойство RibbonType ленты в окне Свойства и затем выберите из списка один или несколько идентификаторов ленты.
При необходимости в проект можно добавить дополнительные ленты. Если у нескольких лент одинаковый идентификатор, следует перегрузить метод CreateRibbonExtensibilityObject класса ThisAddin вашего проекта, чтобы указать, какую ленту следует отображать во время выполнения.
Дополнительные сведения см. в разделе Обзор ленты.
Дополнительные сведения о типах ленты Office Open XML см. в статье Настройки ленты в Outlook 2007.
При использовании XML-ленты
При использовании элемента Лента (XML) следует проверить значение параметра ribbonID в методе Microsoft.Office.Core.IRibbonExtensibility.GetCustomUI и вернуть нужную ленту.
Метод Microsoft.Office.Core.IRibbonExtensibility.GetCustomUI создается автоматически Visual Studio Tools for Office в файле кода ленты. Параметр ribbonID — это строка, идентифицирующая отдельный тип инспектора. Полный список возможных значений параметра ribbonID см. в технической статье Customizing the Ribbon in Outlook 2007.
В следующем фрагменте кода показано, как отображать пользовательскую ленту только в инспекторе Microsoft.Outlook.Mail.Compose. Этот инспектор открывается, когда пользователь создает новое сообщение электронной почты. Отображаемая лента указывается в методе GetResourceText(), который создается в классе ленты. Дополнительные сведения о классе ленты см. в разделе XML-ленты.
Public Function GetCustomUI(ByVal ribbonID As String) As String _
Implements Office.IRibbonExtensibility.GetCustomUI
Dim ribbonXML As String = String.Empty
If ribbonID = "Microsoft.Outlook.Mail.Compose" Then
ribbonXML = GetResourceText("Trin_RibbonOutlookBasic.Ribbon1.xml")
End If
Return ribbonXML
End Function
public string GetCustomUI(string ribbonID)
{
string ribbonXML = String.Empty;
if (ribbonID == "Microsoft.Outlook.Mail.Compose")
{
ribbonXML = GetResourceText("Trin_RibbonOutlookBasic.Ribbon1.xml");
}
return ribbonXML;
}