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


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 для загрузки пользовательской ленты:

&lt;customUI … onLoad=”MyAddInInitialize” …&gt;

Ниже приведен метод обратного вызова для события 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)

Используется для отмены встроенного элемента управления.

Применяется к