IRibbonUI 接口

定义

命名空间:

Microsoft.Office.Core

程序集:

office.dll

由 onLoad 过程（在 customUI 标记上指定）返回的对象。 该对象包含用于使控件属性失效的方法，以及用于刷新用户界面的方法。

public interface class IRibbonUI

[System.Runtime.InteropServices.Guid("000C03A7-0000-0000-C000-000000000046")]
public interface IRibbonUI

[<System.Runtime.InteropServices.Guid("000C03A7-0000-0000-C000-000000000046")>]
type IRibbonUI = interface

Public Interface IRibbonUI

属性

GuidAttribute

示例

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

下面是 Office 用于加载自定义功能区的 XML 标记：

<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 外接程序中的回调过程自定义功能区用户界面 (UI) 。当主机应用程序启动时，将调用 onLoad 回调过程。 该回调过程随后将返回指向用户界面 (UI) 的 IRibbonUI 对象。 您可以使用该对象来调用 Invalidate、InvalidateControl 和 Refresh 方法。

方法

ActivateTab(String)	激活指定的自定义选项卡。
ActivateTabMso(String)	激活指定的内置选项卡。
ActivateTabQ(String, String)	激活 Microsoft Office Fluent 功能区用户界面上指定的自定义选项卡。 使用选项卡的完全限定名称，其中包括选项卡的标识符和命名空间。
Invalidate()	使功能区用户界面所有控件的缓存值失效。
InvalidateControl(String)	使功能区用户界面上单个控件的缓存值失效。
InvalidateControlMso(String)	用于使内置控件失效。