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.