Método IShellView::UIActivate (shobjidl_core.h)

Chamado quando o estado de ativação da janela de exibição é alterado por um evento que não é causado pela própria exibição do Shell. Por exemplo, se a tecla TAB for pressionada quando a árvore tiver o foco, a exibição deverá receber o foco.

Sintaxe

HRESULT UIActivate(
  UINT uState
);

Parâmetros

uState

Tipo: UINT

Sinalizador que especifica o estado de ativação da janela. Esse parâmetro pode usar um dos valores a seguir.

SVUIA_ACTIVATE_FOCUS

O Windows Explorer acabou de criar a janela de exibição com o foco de entrada. Isso significa que o modo de exibição shell deve ser capaz de definir itens de menu apropriados para o estado focado.

SVUIA_ACTIVATE_NOFOCUS

A exibição shell está perdendo o foco de entrada ou acabou de ser criada sem o foco de entrada. O modo de exibição Shell deve ser capaz de definir itens de menu apropriados para o estado nãofocado. Isso significa que nenhum item específico à seleção deve ser adicionado.

SVUIA_DEACTIVATE

O Windows Explorer está prestes a destruir a janela de exibição do Shell. A exibição shell deve remover todas as interfaces de usuário estendidas. Normalmente, são menus mesclados e janelas pop-up de modelagem mescladas.

SVUIA_INPLACEACTIVATE

A exibição shell está ativa sem foco. Esse sinalizador só é usado quando UIActivate é exposto por meio da interface IShellView2 .

Retornar valor

Tipo: HRESULT

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

Comentários

Antes de remeritar itens de menu, a exibição shell normalmente conecta a mensagem WM_SETFOCUS e chama o método OnViewWindowActive . A exibição shell não deve conectar a mensagem NM_KILLFOCUS para remergir itens de menu.

Anotações para aplicativos de chamada

Chame esse método para informar a exibição de uma alteração de estado de ativação.

Anotações aos implementadores

Use esse método para acompanhar o estado de ativação e alterar qualquer comportamento, conforme apropriado.

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

IShellView