IPropertyNotifySink インターフェイス (ocidl.h)

  • [アーティクル]

シンク オブジェクトによって実装され、 IPropertyNotifySink を送信インターフェイスとしてサポートするオブジェクトからプロパティの変更に関する通知を受け取ります。 (サポートする接続可能なオブジェクトから) このインターフェイスの通知を受信する必要があるクライアントは、このインターフェイスを使用してシンクを作成し、接続ポイント メカニズムを介して接続可能オブジェクトに接続します。 接続ポイントの詳細については、「 IConnectionPointContainer」を参照してください。

継承

IPropertyNotifySink インターフェイスは、IUnknown インターフェイスから継承されます。 IPropertyNotifySink には、次の種類のメンバーもあります。

メソッド

IPropertyNotifySink インターフェイスには、これらのメソッドがあります。

 
IPropertyNotifySink::OnChanged

バインド可能なプロパティが変更されたことをシンクに通知します。
IPropertyNotifySink::OnRequestEdit

requestedit プロパティが変更されようとしていることをシンクに通知します。

注釈

オブジェクト自体は、オブジェクトの型情報の [bindable] 属性と [requestedit] 属性でマークされたプロパティに対してのみ、IPropertyNotifySink のメソッドを呼び出すために必要です。 オブジェクトが [bindable] プロパティを変更する場合、 IPropertyNotifySink::OnChanged を呼び出す必要があります。 オブジェクトが [requestedit] プロパティを変更しようとしている場合、プロパティを変更する前に IPropertyNotifySink::OnRequestEdit を呼び出す必要があります。また、この呼び出しからの戻り時にシンクによって指定されたアクションも受け入れなければなりません。

この規則の 1 つの例外は、オブジェクトの初期化または読み込みプロシージャの結果として通知が送信されない点です。 初期化時には、すべてのプロパティが変更され、すべてのプロパティの変更が許可されている必要があると見なされます。 したがって、このインターフェイスへの通知は、完全に初期化または読み込まれたオブジェクトのコンテキストでのみ意味があります。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム Windows
ヘッダー ocidl.h

関連項目

IConnectionPoint

IConnectionPointContainer