IVsUserContext.AddSubcontext 方法

与父上下文包链接 subcontext 包。

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

语法

声明
Function AddSubcontext ( _
    pSubCtx As IVsUserContext, _
    lPriority As Integer, _
    <OutAttribute> ByRef pdwCookie As UInteger _
) As Integer

int AddSubcontext(
    IVsUserContext pSubCtx,
    int lPriority,
    out uint pdwCookie
)

参数

• pSubCtx
  类型：Microsoft.VisualStudio.Shell.Interop.IVsUserContext
  [in] 为 IVsUserContext 接口 (subcontext 包) 的指针。

• lPriority
  类型：System.Int32
  [in] subcontext 的优先级。有关 lPriority 值列表，请参见 VSUSERCONTEXTPRIORITY。

• pdwCookie
  类型：System.UInt32%
  [out, retval] 为唯一标识符的指针 subcontext 的。

返回值

类型：System.Int32
如果方法成功，则返回 S_OK。如果失败，它会返回一个错误代码。

备注

COM 签名

从 context.idl:

HRESULT IVsUserContext::AddSubcontext(
   [in] IVsUserContext * pSubCtx,
   [in] int lPriority,
   [out, retval] VSCOOKIE * pdwCookie
);

上下文提供程序可以包含特定 subcontext 所需的在运行时的项目。例如，命令窗口可以为命令窗口需要上下文和 subcontext 为在命令窗口中选择。若要将某个选定的 subcontext 在上下文提供程序中，需要先创建 subcontext 包保留 subcontext。有关更多信息，请参见 Creating a Context or Subcontext Bag。在 subcontext 包创建，请调用 AddAttribute 添加特性，查找关键字，或将 subcontext 的 F1 关键字请求。然后可以调用 IVsUserContext.AddSubcontext 与父上下文包链接 subcontext 包。

对于上下文包，上下文的优先级由根据上下文包将开关，如编辑窗口中，工具窗口，依此类推环境自动分配。但是，对于 subcontext，需要将优先。对于在命令窗口 (工具窗口) 中的一个选项，为新 subcontext VSUC_Priority_ToolWndSel的一个 lPriority 值。当在命令窗口中更改，命令名称。 subcontext 包然后将。

IVsUserContext.AddSubcontext 方法返回指向 subcontext 包的唯一标识符根据上下文包。保存此指针并将其与 RemoveSubcontext 方法删除 subcontext。

.NET Framework 安全性

• 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息，请参见通过部分受信任的代码使用库。

请参见

参考

IVsUserContext 接口

Microsoft.VisualStudio.Shell.Interop 命名空间