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 値のいずれか。

解説

この関数は、コントロールがコネクション ポイントをサポートしていない場合でも、安全に呼び出すことができます。

関連項目

クラスの概要