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

  • Artigo

Envia mensagens de controle para a barra de ferramentas ou para a barra de status em uma janela do Windows Explorer.

Sintaxe

HRESULT SendControlMsg(
  UINT    id,
  UINT    uMsg,
  WPARAM  wParam,
  LPARAM  lParam,
  LRESULT *pret
);

Parâmetros

id

Tipo: UINT

Um identificador para uma barra de ferramentas (FCW_TOOLBAR) ou para uma janela de barra de status (FCW_STATUS).

uMsg

Tipo: UINT

A mensagem a ser enviada ao controle.

wParam

Tipo: WPARAM

O valor depende da mensagem especificada no parâmetro uMsg .

lParam

Tipo: LPARAM

O valor depende da mensagem especificada no parâmetro uMsg .

pret

Tipo: LRESULT*

O endereço do valor retornado da função SendMessage .

Retornar valor

Tipo: HRESULT

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

Comentários

Consulte a documentação controles comuns para obter mais informações sobre as mensagens que podem ser enviadas para a barra de ferramentas ou status controle de barra.

Observações para aplicativos de chamada

O uso dessa chamada requer uma atenção diligente, pois deixar a barra de status ou a barra de ferramentas em um estado inadequado afetará o desempenho do Windows Explorer.

Observações aos implementadores

Se o Explorer do Windows não tiver esses controles, você poderá retornar E_NOTIMPL.

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)

Confira também

IShellBrowser