IRibbonUI Интерфейс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Объект, возвращаемый процедурой onLoad , указанной в теге customUI . Объект содержит методы для отмены свойств элемента управления и обновления пользовательского интерфейса.
public interface class IRibbonUI
[System.Runtime.InteropServices.Guid("000C03A7-0000-0000-C000-000000000046")]
public interface IRibbonUI
[<System.Runtime.InteropServices.Guid("000C03A7-0000-0000-C000-000000000046")>]
type IRibbonUI = interface
Public Interface IRibbonUI
- Атрибуты
Примеры
В следующем примере при запуске ведущего приложения запускается процедура события onLoad , которая затем вызывает процедуру, которая создает объект IRibbonUI , представляющий пользовательский интерфейс ленты. Далее определяется процедура обратного вызова, которая делает недействительными все кэшированные элементы управления, а затем обновляет пользовательский интерфейс.
Ниже приведена XML-разметка для Office для загрузки пользовательской ленты:
<customUI … onLoad=”MyAddInInitialize” …>
Ниже приведен метод обратного вызова для события onLoad .
Dim MyRibbon As IRibbonUI
Sub MyAddInInitialize(Ribbon As IRibbonUI)
Set MyRibbon = Ribbon
End Sub
Sub myFunction()
‘ Invalidates the caches of all of this add-in’s controls
MyRibbon.Invalidate()
End Sub
Комментарии
Пользовательский интерфейс ленты можно настроить с помощью процедур обратного вызова в надстройках COM. При запуске ведущего приложения вызывается процедура обратного вызова onLoad . Затем процедура обратного вызова возвращает объект IRibbonUI , указывающий на пользовательский интерфейс. YOu может использовать этот объект для вызова методов Invalidate, InvalidateControl и Refresh .
Методы
ActivateTab(String) |
Активирует указанную настраиваемую вкладку. |
ActivateTabMso(String) |
Активирует указанную встроенную вкладку. |
ActivateTabQ(String, String) |
Активирует указанную пользовательскую вкладку в пользовательском интерфейсе ленты Microsoft Office Fluent. Использует полное имя вкладки, включающее идентификатор и пространство имен вкладки. |
Invalidate() |
Делает недействительными кэшированные значения для всех элементов управления пользовательского интерфейса ленты. |
InvalidateControl(String) |
Делает недействительным кэшированное значение для одного элемента управления в пользовательском интерфейсе ленты. |
InvalidateControlMso(String) |
Используется для отмены встроенного элемента управления. |