IVsUIShell.FindToolWindow(UInt32, Guid, IVsWindowFrame) Метод

Определение

Возвращает указатель 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 -> int
Public Function FindToolWindow (grfFTW As UInteger, ByRef rguidPersistenceSlot As Guid, ByRef ppWindowFrame As IVsWindowFrame) As Integer

Параметры

grfFTW
UInt32

[in] Предоставляет критерии, используемые для поиска окна инструментов в среде. Для получения дополнительной информации см. __VSFINDTOOLWIN.

rguidPersistenceSlot
Guid

[in] Уникальный идентификатор для окна инструментов, созданного с помощью CreateToolWindow(UInt32, UInt32, Object, Guid, Guid, Guid, IServiceProvider, String, Int32[], IVsWindowFrame). Вызывающая сторона этого метода может использовать заранее определенные идентификаторы, соответствующие окнам инструментов, если они известны вызывающей стороне.

ppWindowFrame
IVsWindowFrame

[out] Указатель на объект IVsWindowFrame, содержащий окно инструментов.

Возвращаемое значение

Int32

Если метод завершается успешно, возвращает значение S_OK. В противном случае функция возвращает код ошибки.

Комментарии

Подпись COM

Из всшелл. IDL:

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

Для этого метода необходимо, чтобы было создано полностью созданное окно инструментов. Из-за отложенного создания окон инструментов может существовать допустимая рамка окна, но окно, возможно, еще не создано. Если фрейм окна не заполняется объектом, происходит сбой среды и родительская подпрограммы отвечает за завершение создания окна. Однако если указать значение FTW_fForceCreate для grfFTW параметра, среда попытается создать окно инструментов. Если указано значение FTW_fFrameOnly , среда возвращает указатель на фрейм окна, даже если рамка окна не заполнена объектом. Используйте FTW_fFrameOnly значение, чтобы задать свойство в рамке окна инструментов. в этом случае полностью созданное окно инструментов не требуется.

Применяется к