Метод IShellBrowser::GetControlWindow (shobjidl_core.h)

Статья
08/26/2023

Возвращает дескриптор окна для элемента управления браузера.

Синтаксис

HRESULT GetControlWindow(
  UINT id,
  HWND *phwnd
);

Параметры

id

Тип: UINT

Запрашиваемый дескриптор элемента управления. Этот параметр может иметь одно из следующих значений:

FCW_TOOLBAR

Извлекает дескриптор окна на панель инструментов браузера.

FCW_STATUS

Извлекает дескриптор окна в строку состояния браузера.

FCW_TREE

Извлекает дескриптор окна в древовидное представление браузера.

FCW_PROGRESS

Извлекает дескриптор окна в индикатор выполнения браузера.

phwnd

Тип: HWND*

Адрес дескриптора окна для элемента управления Windows Обозреватель.

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

Тип: HRESULT

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

GetControlWindow используется, чтобы представления могли напрямую управлять элементами управления браузера. FCW_TREE следует использовать только для определения наличия дерева.

Примечания к вызывающим приложениям

GetControlWindow используется для управления состоянием окон элементов управления и их проверки. Не отправлять сообщения непосредственно этим элементам управления; Вместо этого используйте IShellBrowser::SendControlMsg. Будьте готовы к возврату значения NULL этим методом. Более поздние версии Windows Обозреватель могут не включать панель инструментов, строку состояния или окно дерева.

Примечания для разработчиков

GetControlWindow возвращает дескриптор окна для этих элементов управления, если они существуют в вашей реализации.

См. также IShellBrowser.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	shobjidl_core.h (включая Shobjidl.h)
DLL	Shell32.dll (версия 4.0 или более поздняя)

Поделиться через