Método ICommDlgBrowser::OnStateChange (shobjidl_core.h)

  • Artigo

Chamado após um estado, identificado pelo parâmetro uChange , foi alterado na interface IShellView .

Sintaxe

HRESULT OnStateChange(
  IShellView *ppshv,
  ULONG      uChange
);

Parâmetros

ppshv

Tipo: IShellView*

Um ponteiro para a interface IShellView da exibição.

uChange

Tipo: ULONG

Alterar no estado de seleção. Esse parâmetro pode usar um dos valores a seguir.

CDBOSC_SETFOCUS

O foco foi definido como o modo de exibição.

CDBOSC_KILLFOCUS

A exibição perdeu o foco.

CDBOSC_SELCHANGE

A seleção foi alterada.

CDBOSC_RENAME

Um item foi renomeado.

CDBOSC_STATECHANGE

Um item foi marcado ou desmarcado.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Esse método é usado para permitir que as caixas de diálogo de arquivo comuns acompanhem o estado do modo de exibição e alterem sua interface do usuário conforme necessário.

Observação aos aplicativos de chamada

Quando os itens no modo de exibição são selecionados ou quando o modo de exibição perde o foco, ele precisa chamar esse método para notificar a caixa de diálogo comum de que o estado de exibição ou o estado de seleção está sendo alterado.

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 Shlobj.h)
DLL Shell32.dll (versão 4.0 ou posterior)

Confira também

ICommDlgBrowser