IRibbonUI.Invalidate Метод

Определение

Пространство имен:

Microsoft.Office.Core

Сборка:

office.dll

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

public:
 void Invalidate();

public void Invalidate ();

abstract member Invalidate : unit -> unit

Public Sub Invalidate ()

Примеры

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

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