Compartilhar via

Interface IUICollectionChangedEvent (uiribbon.h)

  • Artigo

A interface IUICollectionChangedEvent é implementada pelo aplicativo e define o método necessário para lidar com alterações em uma coleção em tempo de execução.

Herança

A interface IUICollectionChangedEvent herda da interface IUnknown . IUICollectionChangedEvent também tem estes tipos de membros:

Métodos

A interface IUICollectionChangedEvent tem esses métodos.

 
IUICollectionChangedEvent::OnChanged

Chamado quando uma IUICollection é alterada.

Comentários

A estrutura da Faixa de Opções do Windows incorpora o mecanismo padrão de cliente-servidor COM (Component Object Model) de objetos conectáveis para escutar e manipular eventos alterados de coleção em tempo de execução.

A Faixa de Opções atua como o objeto conectável do servidor COM que define interfaces de notificação de entrada e saída para o cliente, que é o aplicativo host da Faixa de Opções. As interfaces de entrada são implementadas pela Faixa de Opções. As interfaces de saída são implementadas pelo aplicativo em um objeto dedicado que é criado pelo aplicativo e chamado de coletor de conexão do cliente. Esse coletor é usado para estabelecer uma conexão com o objeto conectável.

Além de definir as interfaces de entrada e saída, a Faixa de Opções também deve implementar a interface IConnectionPointContainer e criar pelo menos um objeto de ponto de conexão que implemente a interface IConnectionPoint e gerencie a conexão com o coletor do cliente.

Nota O cliente deve consultar o objeto conectável para IConnectionPointContainer para determinar se o objeto é conectável antes que o cliente tente criar um objeto de coletor.
 
No caso da Faixa de Opções, IUICollectionChangedEvent é a interface de saída definida pela estrutura e implementada pelo aplicativo. A Faixa de Opções dispara o evento IUICollectionChangedEvent::OnChanged no cliente enviando uma notificação de saída quando uma coleção é alterada, por exemplo, adicionando um Comando à QAT (Barra de Ferramentas de Acesso Rápido).

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2, Windows Server 2008 com SP2 e Platform Update para Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho uiribbon.h

Confira também

Eventos em COM e objetos conectáveis

Exemplo de Galeria

IUICollection