Compartilhar via

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

  • Artigo

Obtém o identificador de janela para um controle de navegador.

Sintaxe

HRESULT GetControlWindow(
  UINT id,
  HWND *phwnd
);

Parâmetros

id

Tipo: UINT

O identificador de controle que está sendo solicitado. Esse parâmetro pode usar um dos valores a seguir:

FCW_TOOLBAR

Recupera o identificador de janela para a barra de ferramentas do navegador.

FCW_STATUS

Recupera o identificador de janela para a barra de status do navegador.

FCW_TREE

Recupera o identificador de janela para o modo de exibição de árvore do navegador.

FCW_PROGRESS

Recupera o identificador de janela para a barra de progresso do navegador.

phwnd

Tipo: HWND*

O endereço do identificador de janela para o controle Explorer do Windows.

Retornar valor

Tipo: HRESULT

Retorna S_OK se tiver êxito ou um valor de erro definido por COM caso contrário.

Comentários

GetControlWindow é usado para que as exibições possam manipular diretamente os controles do navegador. FCW_TREE deve ser usado apenas para determinar se a árvore está presente.

Anotações para aplicativos de chamada

GetControlWindow é usado para manipular e testar o estado das janelas de controle. Não envie mensagens diretamente para esses controles; em vez disso, use IShellBrowser::SendControlMsg. Esteja preparado para que esse método retorne NULL. Versões posteriores do Windows Explorer podem não incluir uma barra de ferramentas, uma barra de status ou uma janela de árvore.

Anotações aos implementadores

GetControlWindow retornará o identificador de janela para esses controles se eles existirem em sua implementação.

Consulte também IShellBrowser

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shobjidl_core.h (inclua Shobjidl.h)
DLL Shell32.dll (versão 4.0 ou posterior)