コントロール プロパティが変更されようとしていること、およびその変更の処理方法をオブジェクトがコンテナーのシンクに問い合わせていることをシンクに通知します。
HRESULT FireOnRequestEdit(
DISPID dispID
);
パラメーター
- dispID
[入力] 変更されるプロパティの識別子。
戻り値
標準の HRESULT 値のいずれかを返します。
解説
コントロール クラスが IPropertyNotifySink から派生している場合、このメソッドは CFirePropNotifyEvent::FireOnRequestEdit を呼び出して、接続されているすべての IPropertyNotifySink インターフェイスに、指定されたコントロール プロパティが変更されようとしていることを通知します。 コントロール クラスが IPropertyNotifySink から派生していない場合、このメソッドは S_OK を返します。
コントロールがコネクション ポイントをサポートしていない場合でも、このメソッドは安全に呼び出すことができます。
使用例
STDMETHODIMP CMyControl::put_MyTitle(BSTR newVal)
{
// the DISPID for MyTitle in this example is 4
DISPID dispID = 4;
// make sure we can change the property
if (FireOnRequestEdit(dispID) == S_FALSE)
return S_FALSE;
// store newVal in CComBstr member
m_bstrMyTitle = newVal;
// signal that the property has been changed
FireOnChanged(dispID);
return S_OK;
}
必要条件
**ヘッダー:**atlctl.h