MFC ActiveX コントロール: ActiveX コントロールでの画像の使用

2025-06-21

この記事では、一般的な画像の種類と、それを ActiveX コントロールに実装する方法について説明します。ここでは、次の内容について説明します。

カスタム図プロパティの概要
ActiveX コントロールでのカスタム画像プロパティの実装
コントロールプロジェクトへの追加

カスタム図プロパティの概要

図の種類は、一部の ActiveX コントロールに共通する種類のグループの 1 つです。 Picture 型は、メタファイル、ビットマップ、またはアイコンを処理し、ActiveX コントロールに表示する図を指定できます。カスタム Picture プロパティは、Picture オブジェクトと、コントロールユーザーが Picture プロパティにアクセスできるようにする Get/Set 関数を使用して実装されます。ストック画像プロパティページを使用して、ユーザーがカスタム Picture プロパティにアクセスできるようにします。

標準の画像の種類に加えて、フォントと色の種類も使用できます。 ActiveX コントロールで標準のフォントの種類を使用する方法の詳細については、「 MFC ActiveX コントロール: フォントの使用」を参照してください。

ActiveX コントロールクラスには、コントロール内に Picture プロパティを実装するために使用できるコンポーネントがいくつか用意されています。これらのコンポーネントは次のとおりです。

CPictureHolder クラス。

このクラスを使用すると、カスタム Picture プロパティによって表示される項目の画像オブジェクトと機能に簡単にアクセスできます。
Get/Set 関数で実装される LPPICTUREDISP 型のプロパティのサポート。

クラスビューを使用すると、Picture 型をサポートするカスタムプロパティ (プロパティ) をすばやく追加できます。クラスビューを使用して ActiveX コントロールのプロパティを追加する方法の詳細については、「 MFC ActiveX コントロール: プロパティ」を参照してください。
コントロールの Picture プロパティまたはプロパティを操作するプロパティページ。

このプロパティページは、ActiveX コントロールで使用できるストックプロパティページのグループの一部です。 ActiveX コントロールのプロパティページの詳細については、「MFC ActiveX コントロール: ストックプロパティページの使用」を参照してください。

ActiveX コントロールでのカスタム画像プロパティの実装

このセクションで説明する手順を完了すると、コントロールはユーザーが選択した画像を表示できます。ユーザーは、現在の画像を表示するプロパティページを使用して表示される画像を変更でき、ユーザーが別の画像を選択できるようにする [参照] ボタンがあります。

カスタム Picture プロパティは、他のプロパティの実装に使用されるプロセスと同様のプロセスを使用して実装されます。主な違いは、カスタムプロパティが Picture 型をサポートする必要がある点です。 Picture プロパティの項目は ActiveX コントロールによって描画される必要があるため、プロパティを完全に実装する前に、いくつかの追加と変更を行う必要があります。

カスタム Picture プロパティを実装するには、次の操作を行う必要があります。

コントロールプロジェクトにコードを追加します。

標準の Picture プロパティページ ID、 CPictureHolder型のデータメンバー、および Get/Set 実装を持つ LPPICTUREDISP 型のカスタムプロパティを追加する必要があります。
コントロールクラス内のいくつかの関数を変更します。

これらの変更は、ActiveX コントロールの描画を担当するいくつかの関数に対して行われます。

コントロールプロジェクトへの追加

標準の Picture プロパティページのプロパティページ ID を追加するには BEGIN_PROPPAGEIDS、コントロール実装ファイル (.CPP):

PROPPAGEID(CLSID_CPicturePropPage)

また、BEGIN_PROPPAGEIDS マクロの count パラメーターを 1 ずつインクリメントする必要があります。次の行は、これを示しています。

BEGIN_PROPPAGEIDS(CMyAxPicCtrl, 2)

CPictureHolder データメンバーをコントロールクラスに追加するには、コントロールヘッダーファイル (.H):

CPictureHolder    m_pic;

データメンバーに m_pic名前を付ける必要はありません。任意の名前で十分です。

次に、Picture 型をサポートするカスタムプロパティを追加します。

プロパティの追加ウィザードを使用してカスタム画像プロパティを追加するには

コントロールのプロジェクトを読み込みます。
クラスビューで、コントロールのライブラリノードを展開します。
コントロールのインターフェイスノード (ライブラリノードの 2 番目のノード) を右クリックして、ショートカットメニューを開きます。
ショートカットメニューから[ 追加 ]、[プロパティの追加]の順に選択します。
[ プロパティ名] ボックスに、プロパティ名を入力します。たとえば、この手順では ControlPicture を使用します。
[ プロパティの種類 ] ボックスで、プロパティの種類として [IPictureDisp* を選択します。
[実装の種類] で、[Get/Set メソッド] をクリックします。
Get 関数と Set 関数の一意の名前を入力するか、既定の名前をそのまま使用します。 (この例では、既定の名前 GetControlPicture と SetControlPicture が使用されます)。
[完了] をクリックします。

プロパティの追加ウィザードは、コントロールヘッダーのディスパッチマップコメント間に次のコードを追加します (.H) ファイル:

IPictureDisp* GetControlPicture(void);
void SetControlPicture(IPictureDisp* pVal);

さらに、次のコードがコントロール実装のディスパッチマップに挿入されました (.CPP) ファイル:

DISP_PROPERTY_EX_ID(CMyAxPicCtrl, "ControlPicture", dispidControlPicture,
   GetControlPicture, SetControlPicture, VT_PICTURE)

プロパティの追加ウィザードでは、コントロール実装ファイルに次の 2 つのスタブ関数も追加します。

IPictureDisp* CWizardGenCtrl::GetControlPicture(void)
{
   AFX_MANAGE_STATE(AfxGetStaticModuleState());

   // TODO: Add your dispatch handler code here

   return NULL;
}

void CWizardGenCtrl::SetControlPicture(IPictureDisp* /*pVal*/)
{
   AFX_MANAGE_STATE(AfxGetStaticModuleState());

   // TODO: Add your property handler code here

   SetModifiedFlag();
}

注

コントロールクラスと関数名は、上記の例とは異なる場合があります。

コントロールプロジェクトの変更

コントロールプロジェクトに必要な追加を行った後、ActiveX コントロールのレンダリングに影響を与えるいくつかの関数を変更する必要があります。これらの関数、 OnResetState、 OnDraw、およびカスタム Picture プロパティの Get/Set 関数は、コントロール実装ファイルにあります。 (この例では、コントロールクラスは CSampleCtrl と呼ばれ、 CPictureHolder データメンバーは m_pic と呼ばれ、カスタム図プロパティ名は ControlPicture。

コントロール OnResetState 関数で、 COleControl::OnResetStateの呼び出しの後に次の省略可能な行を追加します。

m_pic.CreateEmpty();
m_pic.CreateEmpty();

これにより、コントロールの画像が空白の図に設定されます。

図を適切に描画するには、コントロールOnDraw関数で CPictureHolder::Render を呼び出します。次の例のように関数を変更します。

void CMyAxPicCtrl::OnDraw(CDC* pdc, const CRect& rcBounds, const CRect& /*rcInvalid*/)
{
   if (!pdc)
      return;

   m_pic.Render(pdc, rcBounds, rcBounds);
}

コントロールのカスタム画像プロパティの Get 関数に、次の行を追加します。

return m_pic.GetPictureDispatch();
return m_pic.GetPictureDispatch();

コントロールのカスタム Picture プロパティの Set 関数に、次の行を追加します。

m_pic.SetPictureDispatch(pVal);
InvalidateControl();

デザイン時に追加された情報が実行時に表示されるように、picture プロパティを永続的にする必要があります。 COleControl派生クラスのDoPropExchange関数に次の行を追加します。

PX_Picture(pPX, _T("ControlPicture"), m_pic);

注

クラス名と関数名は、上記の例とは異なる場合があります。

変更が完了したら、プロジェクトをリビルドしてカスタム Picture プロパティの新機能を組み込み、テストコンテナーを使用して新しいプロパティをテストします。 Test Container にアクセスする方法について詳しくは、「テストコンテナーでのプロパティとイベントのテスト」をご覧ください。

こちらも参照ください

MFC ActiveX コントロール
 MFC ActiveX コントロール: フォントの使用
 MFC ActiveX コントロール: プロパティページ

次の方法で共有

MFC ActiveX コントロール: ActiveX コントロールでの画像の使用

カスタム図プロパティの概要

ActiveX コントロールでのカスタム画像プロパティの実装

コントロール プロジェクトへの追加

プロパティの追加ウィザードを使用してカスタム画像プロパティを追加するには

コントロール プロジェクトの変更

こちらも参照ください

フィードバック

その他のリソース

コントロールプロジェクトへの追加

コントロールプロジェクトの変更