Compartir a través de

Método IShellBrowser::GetControlWindow (shobjidl_core.h)

  • Artículo

Obtiene el identificador de ventana para un control del explorador.

Sintaxis

HRESULT GetControlWindow(
  UINT id,
  HWND *phwnd
);

Parámetros

id

Tipo: UINT

Identificador de control que se solicita. Este parámetro puede establecerse con uno de los siguientes valores:

FCW_TOOLBAR

Recupera el identificador de ventana en la barra de herramientas del explorador.

FCW_STATUS

Recupera el identificador de la ventana en la barra de estado del explorador.

FCW_TREE

Recupera el identificador de ventana en la vista de árbol del explorador.

FCW_PROGRESS

Recupera el identificador de ventana en la barra de progreso del explorador.

phwnd

Tipo: HWND*

Dirección del identificador de la ventana al control Explorador de Windows.

Valor devuelto

Tipo: HRESULT

Devuelve S_OK si se ejecuta correctamente o un valor de error definido por COM.

Comentarios

GetControlWindow se usa para que las vistas puedan manipular directamente los controles del explorador. FCW_TREE solo se debe usar para determinar si el árbol está presente.

Notas a las aplicaciones de llamada

GetControlWindow se usa para manipular y probar el estado de las ventanas de control. No envíe mensajes directamente a estos controles; en su lugar, use IShellBrowser::SendControlMsg. Prepárese para que este método devuelva NULL. Es posible que las versiones posteriores del Explorador de Windows no incluyan una barra de herramientas, una barra de estado o una ventana de árbol.

Notas para los implementadores

GetControlWindow devuelve el identificador de ventana a estos controles si existen en la implementación.

Consulte también IShellBrowser.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shobjidl_core.h (include Shobjidl.h)
Archivo DLL Shell32.dll (versión 4.0 o posterior)