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, содержащий окно инструментов.
Возвращаемое значение
Если метод завершается успешно, возвращает значение S_OK. В противном случае функция возвращает код ошибки.
Комментарии
Подпись COM
Из всшелл. IDL:
HRESULT IVsUIShell::FindToolWindow(
[in] VSFINDTOOLWIN grfFTW,
[in] REFGUID rguidPersistenceSlot,
[out] IVsWindowFrame **ppWindowFrame
);
Для этого метода необходимо, чтобы было создано полностью созданное окно инструментов. Из-за отложенного создания окон инструментов может существовать допустимая рамка окна, но окно, возможно, еще не создано. Если фрейм окна не заполняется объектом, происходит сбой среды и родительская подпрограммы отвечает за завершение создания окна. Однако если указать значение FTW_fForceCreate для grfFTW параметра, среда попытается создать окно инструментов. Если указано значение FTW_fFrameOnly , среда возвращает указатель на фрейм окна, даже если рамка окна не заполнена объектом. Используйте FTW_fFrameOnly значение, чтобы задать свойство в рамке окна инструментов. в этом случае полностью созданное окно инструментов не требуется.