Метод IRibbonUI.Invalidate (Office)

Статья
04/07/2023

Делает недействительными кэшированные значения для всех элементов управления пользовательского интерфейса ленты.

Синтаксис

expression. Недействительным

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

Замечания

Вы можете настроить пользовательский интерфейс ленты с помощью процедур обратного вызова в надстройках COM. Для каждого из обратных вызовов, которые реализует надстройка, ответы кэшируются.

Например, если модуль записи надстроек реализует процедуру обратного вызова getImage для кнопки, функция вызывается один раз, образ загружается, а затем, если образ требуется обновить, кэшированное изображение используется вместо отзыва процедуры. Этот процесс продолжается до тех пор, пока надстройка не поверит, что кэшированные значения недопустимы с помощью метода Invalidate . В этот момент снова вызывается процедура обратного вызова и кэшируется возвращаемый ответ. Затем надстройка может принудительно обновить пользовательский интерфейс, вызвав метод Refresh .

Пример

В следующем примере при запуске ведущего приложения запускается процедура события onLoad , которая затем вызывает процедуру, которая создает объект, представляющий пользовательский интерфейс ленты. Далее определяется процедура обратного вызова, которая делает недействительными все элементы управления в пользовательском интерфейсе, а затем обновляет пользовательский интерфейс.

<customUI … OnLoad="MyAddinInitialize" …>

Dim MyRibbon As IRibbonUI 
 
Sub MyAddInInitialize(Ribbon As IRibbonUI) 
 Set MyRibbon = Ribbon 
End Sub 
 
Sub myFunction() 
 MyRibbon.Invalidate() ' Invalidates the caches of all of this add-in's controls 
End Sub

См. также

Элементы объекта IRibbonUI

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

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

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