CFirePropNotifyEvent クラス
このクラスでは、コントロール プロパティの変更に関してコンテナーのシンクに通知するメソッドが提供されます。
重要
このクラスとそのメンバーは、Windows ランタイムで実行するアプリケーションで使用することはできません。
構文
class CFirePropNotifyEvent
メンバー
パブリック メソッド
| 名前 | 説明 |
|---|---|
| CFirePropNotifyEvent::FireOnChanged | (静的) コントロール プロパティが変更されたことをコンテナーのシンクに通知します。 |
| CFirePropNotifyEvent::FireOnRequestEdit | (静的) コントロール プロパティが変更されようとしていることをコンテナーのシンクに通知します。 |
解説
CFirePropNotifyEvent には、コントロール プロパティが変更されたこと、または変更されようとしていることをコンテナーのシンクに通知する、2 つのメソッドがあります。
コントロールを実装するクラスが IPropertyNotifySink から派生している場合、FireOnRequestEdit または FireOnChanged を呼び出す際に CFirePropNotifyEvent メソッドが呼び出されます。 コントロール クラスが IPropertyNotifySink から派生していない場合、これらの関数の呼び出しは S_OK を返します。
コントロールの作成の詳細については、ATL チュートリアルを参照してください。
要件
ヘッダー: atlctl.h
CFirePropNotifyEvent::FireOnChanged
(オブジェクトのすべてのコネクション ポイントで) 接続されているすべての IPropertyNotifySink インターフェイスに、指定したオブジェクト プロパティが変更されたことを通知します。
static HRESULT FireOnChanged(IUnknown* pUnk, DISPID dispID);
パラメーター
pUnk
[in] 通知を送信するオブジェクトの IUnknown へのポインター。
dispID
[入力] 変更されたプロパティの識別子。
戻り値
標準 HRESULT 値のいずれか。
解説
この関数は、コントロールがコネクション ポイントをサポートしていない場合でも、安全に呼び出すことができます。
CFirePropNotifyEvent::FireOnRequestEdit
(オブジェクトのすべてのコネクション ポイントで) 接続されているすべての IPropertyNotifySink インターフェイスに、指定したオブジェクト プロパティが変更されようとしていることを通知します。
static HRESULT FireOnRequestEdit(IUnknown* pUnk, DISPID dispID);
パラメーター
pUnk
[in] 通知を送信するオブジェクトの IUnknown へのポインター。
dispID
[入力] 変更されようとしているプロパティの識別子。
戻り値
標準 HRESULT 値のいずれか。
解説
この関数は、コントロールがコネクション ポイントをサポートしていない場合でも、安全に呼び出すことができます。