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 支持和反馈,获取有关如何接收支持和提供反馈的指南。