IRibbonUI.Invalidate 方法 (Office)

使功能区用户界面所有控件的缓存值失效。

语法

表达式无效

表达 返回 IRibbonUI 对象的表达式。

备注

可以使用 COM 加载项中的回调过程自定义功能区 UI。对于加载项实现的每个回调,将缓存响应。

例如,如果外接程序编写器为按钮实现 getImage 回调过程,则调用函数一次,加载图像,然后如果需要更新映像,则使用缓存映像,而不是召回该过程。 此过程将一直保留到外接程序使用 Invalidate 方法发出缓存值无效的信号之前,此时再次调用回调过程并缓存返回响应。 加载项随后可以通过调用 Refresh 方法强制立即更新 UI。

示例

在以下示例中,启动主机应用程序会触发 onLoad 事件过程,该过程随后调用创建表示功能区 UI 的 对象的过程。 接下来,将定义一个回调过程,该过程将使 UI 上的所有控件失效,并随后刷新 UI。

<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

另请参阅

支持和反馈

有关于 Office VBA 或本文档的疑问或反馈? 请参阅 Office VBA 支持和反馈,获取有关如何接收支持和提供反馈的指南。