CFirePropNotifyEvent

class CFirePropNotifyEvent

CFirePropNotifyEvent has two methods that notify the container's sink a control property has changed or is about to change.

If the class implementing your control is derived from IPropertyNotifySink, the CFirePropNotifyEvent methods are invoked when you call FireOnRequestEdit or FireOnChanged. If your control class is not derived from IPropertyNotifySink, calls to these functions return S_OK.

For more information about creating controls, see the ATL Tutorial.

#include <atlctl.h>


CFirePropNotifyEvent Class Members

Methods
FireOnChangedNotifies the container's sink that a control property has changed.
FireOnRequestEditNotifies the container's sink that a control property is about to change.

CFirePropNotifyEvent Overview


Methods


CFirePropNotifyEvent::FireOnChanged

HRESULT FireOnChanged( IUnknown* pUnk, DISPID dispID );

Return Value

One of the standard HRESULT values.

Parameters

pUnk [in] Pointer to the IUnknown of the object sending the notification.

dispID [in] Identifier of the property that has changed.

Remarks

Notifies all connected IPropertyNotifySink interfaces (on every connection point of the object) that the specified object property has changed. This function is safe to call even if your control doesn't support connection points.

CFirePropNotifyEvent Overview | Class Members

See Also CFirePropNotifyEvent::FireOnRequestEdit, CComControl::FireOnChanged


CFirePropNotifyEvent::FireOnRequestEdit

HRESULT FireOnRequestEdit( IUnknown* pUnk, DISPID dispID );

Return Value

One of the standard HRESULT values.

Parameters

pUnk [in] Pointer to the IUnknown of the object sending the notification.

dispID [in] Identifier of the property about to change.

Remarks

Notifies all connected IPropertyNotifySink interfaces (on every connection point of the object) that the specified object property is about to change. This function is safe to call even if your control doesn't support connection points.

CFirePropNotifyEvent Overview | Class Members

See Also CFirePropNotifyEvent::FireOnChanged, CComControl::FireOnRequestEdit