Método IAdviseSink::OnViewChange (objidl.h)

  • Artigo

Notifica os coletores de aviso registrados de um objeto de que sua exibição foi alterada.

Sintaxe

void OnViewChange(
  [in] DWORD dwAspect,
  [in] LONG  lindex
);

Parâmetros

[in] dwAspect

O aspecto ou a exibição do objeto. Contém um valor obtido da enumeração DVASPECT .

[in] lindex

A parte da exibição que mudou. Atualmente, somente -1 é válido.

Valor retornado

Nenhum

Comentários

Os contêineres se registram para serem notificados quando a exibição de um objeto for alterada chamando IViewObject::SetAdvise. Depois de registrado, o objeto chamará o método IAdviseSink::OnViewChange do coletor quando apropriado. OnViewChange pode ser chamado quando o objeto está no estado carregado ou em execução.

Embora os valores DVASPECT sejam bits de sinalizador individuais, dwAspect pode representar apenas um valor. Ou seja, dwAspect não pode conter o resultado de uma operação OR combinando dois ou mais valores DVASPECT .

O parâmetro lindex representa a parte do aspecto que é de interesse. O valor de lindex depende do valor de dwAspect. Se dwAspect for DVASPECT_THUMBNAIL ou DVASPECT_ICON, lindex será ignorado. Se dwAspect for DVASPECT_CONTENT, lindex deverá ser -1, o que indica que toda a exibição é de interesse e é o único valor válido no momento.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [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 objidl.h

Confira também

Iadvisesink

IViewObject::SetAdvise