IVsUIShell.FindToolWindow(UInt32, Guid, IVsWindowFrame) 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
返回所 IVsWindowFrame 请求的单实例工具窗口的指针。
public:
int FindToolWindow(System::UInt32 grfFTW, Guid % rguidPersistenceSlot, [Runtime::InteropServices::Out] Microsoft::VisualStudio::Shell::Interop::IVsWindowFrame ^ % ppWindowFrame);public int FindToolWindow (uint grfFTW, ref Guid rguidPersistenceSlot, out Microsoft.VisualStudio.Shell.Interop.IVsWindowFrame ppWindowFrame);abstract member FindToolWindow : uint32 * Guid * IVsWindowFrame -> intPublic Function FindToolWindow (grfFTW As UInteger, ByRef rguidPersistenceSlot As Guid, ByRef ppWindowFrame As IVsWindowFrame) As Integer参数
- grfFTW
- UInt32
中提供用于在环境中查找工具窗口的条件。 有关详细信息，请参阅 __VSFINDTOOLWIN。
- rguidPersistenceSlot
- Guid
中使用创建的工具窗口的唯一标识符 CreateToolWindow(UInt32, UInt32, Object, Guid, Guid, Guid, IServiceProvider, String, Int32[], IVsWindowFrame) 。 此方法的调用方可以使用映射到工具窗口的预定义标识符（如果调用方知道这些工具窗口）。
- ppWindowFrame
- IVsWindowFrame
弄指向 IVsWindowFrame 包含工具窗口的对象的指针。
返回
如果该方法成功，则它会返回 S_OK。 如果该方法失败，则会返回错误代码。
注解
COM 签名
从 vsshell：
HRESULT IVsUIShell::FindToolWindow(
[in] VSFINDTOOLWIN grfFTW,
[in] REFGUID rguidPersistenceSlot,
[out] IVsWindowFrame **ppWindowFrame
);
此方法需要完全创建的工具窗口。 由于工具窗口创建延迟，因此可能存在有效的窗口框架，但该窗口可能尚未创建。 如果不使用对象填充窗口框架，则环境将失败，并且父例程负责完成窗口创建。 但是，如果将参数的值指定 FTW_fForceCreate 为 grfFTW ，则环境将尝试为您创建工具窗口。 如果指定值 FTW_fFrameOnly ，则环境将返回一个指向窗口框架的指针，即使未使用对象填充窗口框架也是如此。 使用 FTW_fFrameOnly 值在工具窗口的窗口框架上设置一个属性，在这种情况下，不需要完全创建的工具窗口。