IVsUIShell.FindToolWindow 方法

返回请求的单实例工具窗口的 IVsWindowFrame 指针。

命名空间:  Microsoft.VisualStudio.Shell.Interop
程序集:  Microsoft.VisualStudio.Shell.Interop(在 Microsoft.VisualStudio.Shell.Interop.dll 中)

语法

声明
Function FindToolWindow ( _
    grfFTW As UInteger, _
    ByRef rguidPersistenceSlot As Guid, _
    <OutAttribute> ByRef ppWindowFrame As IVsWindowFrame _
) As Integer
int FindToolWindow(
    uint grfFTW,
    ref Guid rguidPersistenceSlot,
    out IVsWindowFrame ppWindowFrame
)

参数

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

返回值

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

备注

COM 签名

从 vsshell.idl:

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

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

.NET Framework 安全性

请参见

参考

IVsUIShell 接口

Microsoft.VisualStudio.Shell.Interop 命名空间