通过

IVsUIShell.FindToolWindowEx 方法

  • 项目

返回请求的单或多个工具窗口的 IVsWindowFrame 指针。

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

语法

声明
Function FindToolWindowEx ( _
    grfFTW As UInteger, _
    ByRef rguidPersistenceSlot As Guid, _
    dwToolWinId As UInteger, _
    <OutAttribute> ByRef ppWindowFrame As IVsWindowFrame _
) As Integer

int FindToolWindowEx(
    uint grfFTW,
    ref Guid rguidPersistenceSlot,
    uint dwToolWinId,
    out IVsWindowFrame ppWindowFrame
)

参数

  • grfFTW
    类型：System.UInt32
    [in] 在环境中提供用于了标准搜索一个工具窗口。有关更多信息，请参见 __VSFINDTOOLWIN。
  • rguidPersistenceSlot
    类型：System.Guid%
    [in] 使用 CreateToolWindow创建的工具窗口的唯一标识符。如果这些工具窗口对此方法的调用方已知，则该调用方可以使用映射到工具窗口的预定义标识符。
  • dwToolWinId
    类型：System.UInt32
    [in] 请求的工具窗口的标识符在多个实例的工具窗口中。多个工具窗口的第一个实例具有零个标识符，第二个实例具有标识符的，依此类推。

返回值

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

备注

COM 签名

从 vsshell.idl:

HRESULT IVsUIShell::FindToolWindowEx(
   [in] VSFINDTOOLWIN grfFTW,
   [in] REFGUID rguidPersistenceSlot,
   [in] DWORD dwToolWinId,
   [out] IVsWindowFrame **ppWindowFrame
);

此方法需要完全创建的工具窗口存在。 由于工具窗口延迟的创建，有效的窗架可能存在，但是，窗口可能不创建。 如果窗架未填充对象。然后将环境失败，并且父实例完成负责创建一个窗口。 但是，因此，如果您为 grfFTW 参数指定 FTW_fForceCreate 的值，然后该环境尝试创建自己的工具窗口。 如果指定 FTW_fFrameOnly的值，则该环境返回指向窗口框架组成，通常，即使窗架未填充对象。 ，在不需要情况下，使用 FTW_fFrameOnly 值将窗架的属性工具窗口的完整创建的工具窗口。

.NET Framework 安全性

请参见

参考

IVsUIShell 接口

Microsoft.VisualStudio.Shell.Interop 命名空间