通过

IRibbonUI.InvalidateControl 方法 (Office)

  • 项目

使功能区用户界面上单个控件的缓存值失效。

语法

表达式。InvalidateControl (bstrControlID)

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

参数

名称 必需/可选 数据类型 说明
bstrControlID 必需 字符串 指定将失效的控件的 ID。

备注

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

例如，如果外接程序编写器为按钮实现 getImage 回调过程，则调用函数一次，加载图像，然后如果需要更新映像，则使用缓存映像，而不是召回该过程。 此过程将保留给 控件，直到加载项使用 InvalidateControl 方法发出缓存值无效的信号，此时，再次调用回调过程并缓存返回响应。

示例

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

<customUI … OnLoad="MyAddInInitialize" …>

Dim MyRibbon As IRibbonUI 
 
Sub MyAddInInitialize(Ribbon As IRibbonUI) 
 Set MyRibbon = Ribbon 
End Sub 
 
Sub myFunction() 
 MyRibbon.InvalidateControl("control1") ' Invalidates the cache of a single control 
End Sub

另请参阅

支持和反馈

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