Partilhar via


Classe CFirePropNotifyEvent

Observação

A Active Template Library (ATL) continua a ser suportada. No entanto, já não estamos a adicionar funcionalidades nem a atualizar a documentação.

Esta classe fornece métodos para notificar o sumidouro do contentor sobre alterações nas propriedades de controlo.

Importante

Esta classe e os seus membros não podem ser usados em aplicações que sejam executadas no Windows Runtime.

Sintaxe

class CFirePropNotifyEvent

Membros

Métodos Públicos

Nome Description
CFirePropNotifyEvent::FireOnChanged (Estática) Notifica a pia do recipiente que uma propriedade de controlo foi alterada.
CFirePropNotifyEvent::FireOnRequestEdit (Estática) Notifica o lava-loiça do contentor que uma propriedade de controlo está prestes a mudar.

Observações

CFirePropNotifyEvent tem dois métodos que notificam a pia do recipiente que uma propriedade de controlo mudou ou está prestes a mudar.

Se a classe que implementa o seu controlo for derivada de IPropertyNotifySink, os CFirePropNotifyEvent métodos são invocados quando chama FireOnRequestEdit ou FireOnChanged. Se a sua classe de controlo não for derivada de IPropertyNotifySink, chamadas a estas funções retornam S_OK.

Para mais informações sobre como criar controlos, consulte o Tutorial ATL.

Requerimentos

Cabeçalho: atlctl.h

CFirePropNotifyEvent::FireOnChanged

Notifica todas as interfaces IPropertyNotifySink conectadas (em todos os pontos de ligação do objeto) que a propriedade do objeto especificada mudou.

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

Parâmetros

pUnk
[dentro] Aponta para o IUnknown do objeto que envia a notificação.

dispID
[dentro] Identificador da propriedade que mudou.

Valor de retorno

Um dos valores padrão do HRESULT.

Observações

Esta função é segura para usar mesmo que o seu controlo não suporte pontos de ligação.

CFirePropNotifyEvent::FireOnRequestEdit

Notifica todas as interfaces IPropertyNotifySink ligadas (em todos os pontos de ligação do objeto) de que a propriedade do objeto especificada está prestes a mudar.

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

Parâmetros

pUnk
[dentro] Aponta para o IUnknown do objeto que envia a notificação.

dispID
[dentro] Identificador da propriedade prestes a mudar.

Valor de retorno

Um dos valores padrão do HRESULT.

Observações

Esta função é segura para usar mesmo que o seu controlo não suporte pontos de ligação.

Consulte também

Visão geral da classe