属性によるプロパティの追加

[アーティクル]
09/17/2008

ActiveX コントロールへのプロパティやメソッドの追加は、短時間で簡単にできる属性使用の練習になります。ここでは、属性を使って簡単な読み取り/書き込みカスタムプロパティを追加する手順を示し、コントロールプロジェクトに対する変更について検討します。

サンプルプログラムでは、Data という名前のカスタムプロパティを追加しています。このプロパティは、数値の現在の値を取得または設定します。このプロパティは、short 型のデータメンバに格納されます。

カスタムプロパティを完全に実装するには、コントロールの既定のインターフェイス、およびコントロールを実装するクラスに、プロパティを追加する必要があります。この処理は、プロパティの追加ウィザードと propget 属性および propput 属性を使用して行います。これらの属性は、読み取り/書き込みプロパティメソッドの標準セットをコントロールインターフェイスに実装します。コントロールのクライアントは、実装されるメソッドと標準の COM プロシージャを使用して、値 (この場合はデータ文字列) を参照したり設定したりします。

カスタム Data プロパティを追加するには

[クラスビュー] の [MyAxCtrl] を展開し、IMyCtl ノードを右クリックします。
ショートカットメニューの [追加] をポイントし、[プロパティの追加] をクリックします。

プロパティの追加ウィザードが表示されます。
[プロパティの種類] ボックスの一覧の [SHORT] をクリックします。
[プロパティ名] に対して「Data」と入力します。
[完了] をクリックして、カスタムプロパティを実装します。

次の変更が行われます。

MyCtl.cpp get 関数と set 関数の本体が CMyCtl クラスに追加されます。これらは後で変更されます。

STDMETHODIMP CMyCtl::get_Data(SHORT* pVal)
{
   // TODO: Add your implementation code here
   return S_OK;
}

STDMETHODIMP CMyCtl::put_Data(SHORT newVal)
{
   // TODO: Add your implementation code here
   return S_OK;
}

MyCtl.h get メソッドと set メソッドが IMyCtl インターフェイスに追加されます。

[propget, id(1), helpstring("property Data")] HRESULT Data([out, retval] SHORT* pVal);
[propput, id(1), helpstring("property Data")] HRESULT Data([in] SHORT newVal);