IVsUserContext 接口

管理特性和关键字 (上下文和 subcontext) 在上下文或 subcontext 包。

命名空间：  Microsoft.VisualStudio.Shell.Interop
程序集：  Microsoft.VisualStudio.Shell.Interop（在 Microsoft.VisualStudio.Shell.Interop.dll 中）

语法

声明
<GuidAttribute("761081DF-D45F-4683-9B9E-1B7241E56F5C")> _
<InterfaceTypeAttribute()> _
Public Interface IVsUserContext

[GuidAttribute("761081DF-D45F-4683-9B9E-1B7241E56F5C")]
[InterfaceTypeAttribute()]
public interface IVsUserContext

IVsUserContext 类型公开以下成员。

方法

	名称	说明
	AddAttribute	添加属性、查找关键字或关键字 F1 到上下文或 subcontext 包。
	AddSubcontext	与父上下文包链接 subcontext 包。
	AdviseUpdate	，更改时，使客户端接收通知用户上下文属性包。
	CountAttributes	返回属性或关键字数在当前上下文或 subcontext 包。
	CountSubcontexts	返回 subcontext 包的数量与上下文关联的包。
	GetAttribute	返回指定的属性或关键字根据索引位置或名称的上下文或 subcontext 包。
	GetAttributePri	返回指定的属性或关键字根据索引位置、名称或优先级别的上下文或 subcontext 包。
	GetAttrUsage	返回位于在上下文或 subcontext 包中的指定索引位置上下文 (属性、查找关键字或 F1 关键字) 的类型。
	GetPriority	确定一个属性或关键字的优先级在上下文或 subcontext 包。
	GetSubcontext	返回从父上下文包中的指定 subcontext 包。
	IsDirty	确定用户上下文是否在上下文或 subcontext 包已更改。
	RemoveAllSubcontext	移除所有 subcontext 包与上下文关联的包。
	RemoveAttribute	从上下文或 subcontext 包中移除特性或关键字。
	RemoveAttributeIncludeChildren	移除特性或关键字从上下文包和从任何关联的 subcontext 请求。
	RemoveSubcontext	移除指定的 subcontext 包。
	SetDirty	标记更新的上下文或 subcontext 包。
	UnadviseUpdate	禁用从接收更新的通知客户端到用户上下文。
	Update	更新用户上下文。

页首

备注

上下文和 subcontext 包括 F1 关键字、查找关键字和属性。 上下文和 subcontext 包是 COM 对象 (IVsUserContext 对象) 用于组关键字和属性与特定上下文提供程序。 上下文提供程序是在选择涉及，如工具窗口、编辑和语言服务的环境元素。 Subcontext 是一个选择在编辑器、工具窗口或语言服务 (iis)。 subcontext 元素的示例在语言服务或一个命令包括一个关键语言术语在工具窗口。

上下文提供程序关联上下文包与选定内容。 subcontext 包与上下文包链接到单独的 IVsUserContext 对象。 由于上下文包指向与之链接的所有 subcontext 包，关键字和属性在当前上下文和 subcontext 包包括元素的整个上下文。 上下文和 subcontext 包的联合每个上下文提供程序在活动中选择在环境在特定时间描述整个上下文。

在使用 IVsUserContext 方法管理上下文包之前，您首先需要设置环境元素作为上下文提供程序通过创建它的上下文包。 若要创建新的上下文包，调用在 SVsMonitorUserContext 服务访问的 QueryService 指向 IVsMonitorUserContext 接口。 只要有指向此接口，调用 CreateEmptyContext 创建一个新上下文包和接收指向 IVsUserContext。 然后可以调用 AddAttribute 方法将属性、查找关键字或关键字 F1 到上下文包。 使用这个过程中创建并填充 subcontext 包，然后调用 AddSubcontext 与上下文包链接 subcontext 包。

对调用者的说明

调用此接口添加，移除，枚举或标志上下文和 subcontext。

请参见

参考

Microsoft.VisualStudio.Shell.Interop 命名空间