CComControl::FireOnRequestEdit

更新 : 2007 年 11 月

コントロール プロパティが変更されようとしていること、およびその変更の処理方法をオブジェクトがコンテナのシンクに問い合わせていることをシンクに通知します。

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

参照

参照

CComControl クラス

CComControl::FireOnChanged

その他の技術情報

CComControl のメンバ