Метод IRibbonExtensibility.GetCustomUI (Office)

Статья
04/07/2023

Загружает разметку XML из XML-файла настройки или из xml-разметки, встроенной в процедуру, которая настраивает пользовательский интерфейс ленты.

Синтаксис

expression. GetCustomUI (RibbonID)

Выражение Выражение, возвращающее объект IRibbonExtensibility .

Параметры

Имя	Обязательный или необязательный	Тип данных	Описание
RibbonID	Обязательный	String	Идентификатор пользовательского интерфейса RibbonX.

Возвращаемое значение

Строка

Замечания

Для Word, Excel, PowerPoint и Access существует только один идентификатор для каждого приложения. Outlook использует расширяемость ленты для настройки не только ленты в инспекторе, но и ленты в обозревателе, в различных контекстных меню, на контекстных вкладках на ленте и в представлении Microsoft Office Backstage. В каждом из этих сценариев разработчик указывает пользовательский интерфейс в XML-файле, который загружается, когда Office вызывает GetCustomUI с определенным идентификатором ленты.

Пример

В следующем примере, написанном на языке C#, интерфейс IRibbonExtensibility указан в определении класса . Затем в примере реализуется единственный метод интерфейсов GetCustomUI. Метод создает экземпляр объекта StreamReader , который считывает в разметке настройки во внешнем XML-файле.

public class Connect : Object, Extensibility.IDTExtensibility2, IRibbonExtensibility 
... 
public string GetCustomUI(string RibbonID) 
{ 
 StreamReader customUIReader = new System.IO.StreamReader("C:\\RibbonXSampleCS\\customUI.xml"); 
 string customUIData = customUIReader.ReadToEnd(); 
 return customUIData; 
}

См. также

Члены объекта IRibbonExtensibility

Поддержка и обратная связь

Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.

Поделиться через