CFirePropNotifyEvent 类
此类提供了将控件更改情况通知给容器的接收器的方法。
重要
无法在 Windows 运行时中执行的应用程序中使用此类及其成员。
语法
class CFirePropNotifyEvent
成员
公共方法
名称 | 描述 |
---|---|
CFirePropNotifyEvent::FireOnChanged | (静态)通知容器的接收器控件属性已更改。 |
CFirePropNotifyEvent::FireOnRequestEdit | (静态)通知容器的接收器控件属性即将更改。 |
备注
CFirePropNotifyEvent
有两种方法,通知容器的接收器控件属性已更改或即将更改。
如果实现控件的类派生自 IPropertyNotifySink
,则在调用 FireOnRequestEdit
或 FireOnChanged
时调用 CFirePropNotifyEvent
方法。 如果控件类不是派生自 IPropertyNotifySink
,则对这些函数的调用将返回 S_OK。
有关如何创建控件的详细信息,请参阅 ATL 教程。
要求
标头:atlctl.h
CFirePropNotifyEvent::FireOnChanged
通知所有连接的 IPropertyNotifySink 接口(在对象的每个连接点上),指定的对象属性已更改。
static HRESULT FireOnChanged(IUnknown* pUnk, DISPID dispID);
参数
pUnk
[in] 指向发送通知的 IUnknown
对象的指针。
dispID
[in] 已更改的属性的标识符。
返回值
标准 HRESULT 值之一。
备注
即使控件不支持连接点,此方法也是安全的。
CFirePropNotifyEvent::FireOnRequestEdit
通知所有连接的 IPropertyNotifySink 接口(在对象的每个连接点上),指定的对象属性将要更改。
static HRESULT FireOnRequestEdit(IUnknown* pUnk, DISPID dispID);
参数
pUnk
[in] 指向发送通知的 IUnknown
对象的指针。
dispID
[in] 要更改的属性的标识符。
返回值
标准 HRESULT 值之一。
备注
即使控件不支持连接点,此方法也是安全的。