Compartilhar via


Classe CFirePropNotifyEvent

Essa classe fornece métodos para notificar o coletor do contêiner sobre alterações na propriedade de controle.

Importante

Essa classe e os respectivos membros não podem ser usados em aplicativos executados no Windows Runtime.

Sintaxe

class CFirePropNotifyEvent

Membros

Métodos públicos

Nome Descrição
CFirePropNotifyEvent::FireOnChanged (Estático) Notifica o coletor do contêiner que uma propriedade de controle foi alterada.
CFirePropNotifyEvent::FireOnRequestEdit (Estático) Notifica o coletor do contêiner que uma propriedade de controle está prestes a ser alterada.

Comentários

CFirePropNotifyEvent tem dois métodos que notificam o coletor do contêiner de que uma propriedade de controle foi alterada ou está prestes a ser alterada.

Se a classe que implementa seu controle for derivada de IPropertyNotifySink, os métodos CFirePropNotifyEvent serão invocados quando você chama FireOnRequestEdit ou FireOnChanged. Se a classe de controle não for derivada de IPropertyNotifySink, as chamadas para essas funções retornarão S_OK.

Para obter mais informações sobre como criar um controle, consulte o Tutorial do ATL.

Requisitos

Cabeçalho: atlctl.h

CFirePropNotifyEvent::FireOnChanged

Notifica todas as interfaces IPropertyNotifySink conectadas (em cada ponto de conexão do objeto) de que a propriedade de objeto especificada foi alterada.

static HRESULT FireOnChanged(IUnknown* pUnk, DISPID dispID);

Parâmetros

pUnk
[in] Ponteiro ao IUnknown do objeto que envia a notificação.

dispID
[entrada] O identificador da propriedade que foi modificada.

Valor de retorno

Um dos valores HRESULT padrão.

Comentários

Essa função é segura para chamar mesmo que seu controle não permita pontos de conexão.

CFirePropNotifyEvent::FireOnRequestEdit

Notifica todas as interfaces IPropertyNotifySink conectadas (em cada ponto de conexão do objeto) de que a propriedade de objeto especificada está prestes a ser alterada.

static HRESULT FireOnRequestEdit(IUnknown* pUnk, DISPID dispID);

Parâmetros

pUnk
[in] Ponteiro ao IUnknown do objeto que envia a notificação.

dispID
[entrada] Identificador da propriedade prestes a ser alterada.

Valor de retorno

Um dos valores HRESULT padrão.

Comentários

Essa função é segura para chamar mesmo que seu controle não permita pontos de conexão.

Confira também

Visão geral da aula