RibbonBase 类
作为 Microsoft Office 功能区自定义项的基类。
继承层次结构
System.Object
System.MarshalByRefObject
System.ComponentModel.Component
Microsoft.Office.Tools.Ribbon.RibbonBase
命名空间: Microsoft.Office.Tools.Ribbon
程序集: Microsoft.Office.Tools.Common.v4.0.Utilities(在 Microsoft.Office.Tools.Common.v4.0.Utilities.dll 中)
语法
声明
Public MustInherit Class RibbonBase _
Inherits Component _
Implements IRibbonExtension, IExtension, IDisposable
public abstract class RibbonBase : Component,
IRibbonExtension, IExtension, IDisposable
RibbonBase 类型公开以下成员。
构造函数
名称 | 说明 | |
---|---|---|
RibbonBase | 基础结构。初始化 RibbonBase 类的新实例。 |
页首
属性
名称 | 说明 | |
---|---|---|
Base | 获取此 RibbonBase 对象扩展的 RibbonBase 对象。 | |
CanRaiseEvents | 获取一个指示组件是否可以引发事件的值。 (继承自 Component。) | |
Container | 获取 IContainer,它包含 Component。 (继承自 Component。) | |
Context | 获取 Outlook 中与此功能区关联的检查器窗口或资源管理器窗口。 | |
DesignMode | 获取一个值,用以指示 Component 当前是否处于设计模式。 (继承自 Component。) | |
Events | 获取附加到此 Component 的事件处理程序的列表。 (继承自 Component。) | |
Factory | 获取或设置与此 RibbonBase 关联的功能区工厂。 | |
Global | 获取或设置一个值,该值确定此 RibbonBase 是否可以同时在多个上下文中使用。 | |
Name | 获取或设置此 RibbonBase 的名称。 | |
OfficeMenu | 获取一个表示 Microsoft Office 菜单自定义项的 RibbonOfficeMenu。 | |
Parent | 获取一个表示此 RibbonBase 的 RibbonComponent 的父级的 RibbonComponent。 | |
RibbonId | 获取用于创建 RibbonBase 类的此实例的功能区 ID。 | |
RibbonType | 获取功能区 ID 的逗号分隔的列表,这些功能区 ID 与此 RibbonBase 实例相关联。 | |
RibbonUI | 基础结构。获取 Microsoft Office 应用程序提供给功能区扩展性代码的 IRibbonUI 实例。 | |
Site | 获取或设置 Component 的 ISite。 (继承自 Component。) | |
StartFromScratch | 获取或设置一个值,该值指示是否隐藏功能区上的所有内置选项卡和 Microsoft Office 菜单上的大部分命令,并仅显示在此功能区项中定义的自定义项。 | |
Tabs | 获取 RibbonOfficeMenu 中 RibbonTab 对象的集合。 | |
Tag | 获取或设置与此 RibbonBase 关联的特定于应用程序的数据。 |
页首
方法
名称 | 说明 | |
---|---|---|
CreateObjRef | 安全关键。创建一个对象,该对象包含生成用于与远程对象进行通信的代理所需的全部相关信息。 (继承自 MarshalByRefObject。) | |
Dispose() | 释放由 Component 使用的所有资源。 (继承自 Component。) | |
Dispose(Boolean) | 释放 RibbonBase 类使用的非托管资源,并可以选择释放托管资源。 (重写 Component.Dispose(Boolean)。) | |
Equals | 确定指定的对象是否等于当前对象。 (继承自 Object。) | |
Finalize | 在通过垃圾回收将 Component 回收之前,释放非托管资源并执行其他清理操作。 (继承自 Component。) | |
GetHashCode | 用作特定类型的哈希函数。 (继承自 Object。) | |
GetLifetimeService | 安全关键。检索控制此实例的生存期策略的当前生存期服务对象。 (继承自 MarshalByRefObject。) | |
GetService | 返回一个对象,该对象表示由 Component 或它的 Container 提供的服务。 (继承自 Component。) | |
GetType | 获取当前实例的 Type。 (继承自 Object。) | |
InitializeLifetimeService | 安全关键。获取控制此实例的生存期策略的生存期服务对象。 (继承自 MarshalByRefObject。) | |
MemberwiseClone() | 创建当前 Object 的浅表副本。 (继承自 Object。) | |
MemberwiseClone(Boolean) | 创建当前 MarshalByRefObject 对象的浅表副本。 (继承自 MarshalByRefObject。) | |
PerformDynamicLayout | 如果 RibbonBase 的 RibbonComponent 有一个动态父级(如动态菜单)且布局未挂起,则调用父控件的 Microsoft.Office.Core.IRibbonUI.InvalidateControl 方法。 | |
PerformLayout | 刷新功能区用户界面。 | |
ResumeLayout() | 取消 SuspendLayout 方法的效果。 | |
ResumeLayout(Boolean) | 取消 SuspendLayout 方法的效果。 | |
SuspendLayout | 阻止 Microsoft Office 应用程序刷新功能区上的控件的状态。 | |
ToString | 返回包含 Component 的名称的 String(如果有)。不应重写此方法。 (继承自 Component。) |
页首
事件
名称 | 说明 | |
---|---|---|
Close | 关闭此 RibbonBase 实例时发生。 | |
Disposed | 当通过调用 Dispose 方法释放组件时发生。 (继承自 Component。) | |
Load | 当 RibbonBase 加载到 Microsoft Office 应用程序时发生。 | |
LoadImage | 如果为一个或多个控件设置 ImageName 属性,则在 RibbonBase 加载时发生。 |
页首
显式接口实现
名称 | 说明 | |
---|---|---|
IExtension.ExtensionBase | 基础结构。 |
页首
备注
在 Office 项目中添加新的**“功能区(可视化设计器)”**项时,Visual Studio 会添加一个继承自 RibbonBase 的功能区类到该项目。 RibbonBase 包含由所有功能区类公用的方法和属性。 有关更多信息,请参见功能区设计器。
RibbonBase 的某些属性只能在功能区加载到 Office 应用程序之前设置。 有关如何设置这些属性的信息,请参见功能区对象模型概述。
用法
此类型仅用于面向 .NET Framework 4 和 .NET Framework 4.5 的 Office 项目。定义此类型的程序集不是 Visual Studio Tools for Office Runtime 的一部分。您必须与解决方案一起部署此程序集。有关更多信息,请参见 Visual Studio Tools for Office Runtime 中的程序集。
线程安全
此类型的任何公共 static(在 Visual Basic 中为 Shared) 成员都是线程安全的。但不保证所有实例成员都是线程安全的。