MFC ActiveX コントロール : フォントの使用

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

更新 : 2007 年 11 月

ActiveX コントロールでテキストを表示する場合は、フォントのプロパティを変更できるようにすると、コントロールのユーザーがテキストの外観を変更できるようになります。フォントのプロパティは、フォントオブジェクトとして実装され、ストックプロパティとカスタムプロパティの 2 種類に分かれます。ストックフォントプロパティは、あらかじめ実装されているフォントプロパティであり、プロパティ追加ウィザードを使って追加できます。カスタムフォントプロパティは、あらかじめ実装されていないフォントプロパティで、開発者が動作や使い方を決定します。

ここでは、次のトピックについて説明します。

ストックフォントプロパティの使用
コントロールでのカスタムフォントプロパティの使用

ストックフォントプロパティの使用

ストックフォントプロパティは、COleControl クラスによってあらかじめ実装されています。また、標準のフォントプロパティページも用意されています。ユーザーは、このプロパティページを使って、フォントオブジェクトのさまざまな属性 (名前、サイズ、スタイルなど) を変更できます。

フォントオブジェクトにアクセスするには、COleControl の関数 GetFont、SetFont、および InternalGetFont を使用します。コントロールのユーザーは、ほかの Get/Set プロパティにアクセスする場合と同様に、GetFont 関数と SetFont 関数を使ってフォントオブジェクトにアクセスします。コントロール内からフォントオブジェクトにアクセスするには、InternalGetFont 関数を使用します。

「MFC ActiveX コントロール : プロパティ」で説明したように、プロパティ追加ウィザードを使うとストックプロパティを簡単に追加できます。フォントプロパティを選択すると、コントロールのディスパッチマップにストックフォントプロパティのエントリが自動的に挿入されます。

プロパティ追加ウィザードを使ってストックフォントプロパティを追加するには

コントロールのプロジェクトを読み込みます。
[クラスビュー] ウィンドウで、コントロールのライブラリノードを展開します。
コントロールのインターフェイスノード (ライブラリノードの 2 番目のノード) を右クリックし、ショートカットメニューを開きます。
ショートカットメニューの [追加] をクリックし、[プロパティの追加] をクリックします。

これにより、プロパティ追加ウィザードが開きます。
[プロパティ名] ボックスの [Font] をクリックします。
[完了] をクリックします。

コントロールクラスの実装ファイル内にあるコントロールのディスパッチマップに、次の行が追加されます。

DISP_STOCKPROP_FONT()

さらに、コントロールの .IDL ファイルに次の行が追加されます。

[id(DISPID_FONT)] IFontDisp*Font;

ストックフォントプロパティの情報を使って描画できるテキストプロパティとしては、たとえば、ストックキャプションプロパティがあります。ストックキャプションプロパティをコントロールに追加するための手順は、ストックフォントプロパティを追加する際の手順に似ています。

プロパティ追加ウィザードを使ってストックキャプションプロパティを追加するには

コントロールのプロジェクトを読み込みます。
[クラスビュー] ウィンドウで、コントロールのライブラリノードを展開します。
コントロールのインターフェイスノード (ライブラリノードの 2 番目のノード) を右クリックし、ショートカットメニューを開きます。
ショートカットメニューの [追加] をクリックし、[プロパティの追加] をクリックします。

これにより、プロパティ追加ウィザードが開きます。
[プロパティ名] ボックスの [Caption] をクリックします。
[完了] をクリックします。

コントロールクラスの実装ファイル内にあるコントロールのディスパッチマップに、次の行が追加されます。

DISP_STOCKPROP_CAPTION()

OnDraw 関数の変更

OnDraw の既定の実装では、コントロールに表示されるすべてのテキストに対して Windows のシステムフォントが使用されます。したがって、デバイスコンテキストにフォントオブジェクトを選択して OnDraw のコードを変更する必要があります。それには、次の例のように、COleControl::SelectStockFont を呼び出してコントロールのデバイスコンテキストを渡します。

CFont* pOldFont;
TEXTMETRIC tm;
const CString& strCaption = InternalGetText();

pOldFont = SelectStockFont(pdc);
pdc->FillRect(rcBounds, CBrush::FromHandle((HBRUSH )GetStockObject(WHITE_BRUSH)));
pdc->Ellipse(rcBounds);
pdc->GetTextMetrics(&tm);
pdc->SetTextAlign(TA_CENTER | TA_TOP);
pdc->ExtTextOut((rcBounds.left + rcBounds.right) / 2, 
   (rcBounds.top + rcBounds.bottom - tm.tmHeight) / 2,
   ETO_CLIPPED, rcBounds, strCaption, strCaption.GetLength(), NULL);

pdc->SelectObject(pOldFont);

フォントオブジェクトを使用するために OnDraw 関数を変更すると、コントロール内のテキストがコントロールのストックフォントプロパティの特性で表示されるようになります。

コントロールでのカスタムフォントプロパティの使用

ActiveX コントロールでは、ストックフォントプロパティだけでなくカスタムフォントプロパティも使用できます。カスタムフォントプロパティを追加するときには、以下の作業が必要になります。

プロパティ追加ウィザードを使ってカスタムフォントプロパティを実装する。
フォントの通知を処理する。
新しいフォント通知インターフェイスを実装する。

カスタムフォントプロパティの実装

カスタムフォントプロパティを実装するには、プロパティ追加ウィザードを使ってプロパティを追加し、コードを一部変更します。ここでは、Sample コントロールにカスタムフォントプロパティ HeadingFont を追加する方法について説明します。

プロパティ追加ウィザードを使ってカスタムフォントプロパティを追加するには

コントロールのプロジェクトを読み込みます。
[クラスビュー] ウィンドウで、コントロールのライブラリノードを展開します。
コントロールのインターフェイスノード (ライブラリノードの 2 番目のノード) を右クリックし、ショートカットメニューを開きます。
ショートカットメニューの [追加] をクリックし、[プロパティの追加] をクリックします。

これにより、プロパティ追加ウィザードが開きます。
[プロパティ名] ボックスにプロパティ名を入力ます。この例では、「HeadingFont」と入力します。
実装の種類として、[Get/Set メソッド] をクリックします。
[プロパティの種類] ボックスで、プロパティの種類として [IDispatch*] を選択します。
[完了] をクリックします。

プロパティ追加ウィザードによって、CSampleCtrl クラスと SAMPLE.IDL ファイルにカスタムプロパティ HeadingFont を追加するコードが作成されます。HeadingFont プロパティの実装の種類は Get/Set なので、プロパティの追加ウィザードは、CSampleCtrl クラスのディスパッチマップを変更して DISP_PROPERTY_EX_IDDISP_PROPERTY_EX マクロエントリを挿入します。

DISP_PROPERTY_EX_ID(CMyAxFontCtrl, "HeadingFont", dispidHeadingFont, 
   GetHeadingFont, SetHeadingFont, VT_DISPATCH)

DISP_PROPERTY_EX マクロは、プロパティ名 HeadingFont を対応する CSampleCtrl クラスの Get メソッドと Set メソッドである GetHeadingFont と SetHeadingFont に関連付けます。また、プロパティ値の型も指定します (この場合は VT_FONT)。

さらに、プロパティ追加ウィザードはコントロールのヘッダー (.H) ファイルに GetHeadingFont 関数と SetHeadingFont 関数の宣言を追加し、コントロールの実装 (.CPP) ファイルにこれらの関数の関数テンプレートを追加します。

IDispatch* CWizardGenCtrl::GetHeadingFont(void)
{
   AFX_MANAGE_STATE(AfxGetStaticModuleState());

   // TODO: Add your dispatch handler code here

   return NULL;
}

void CWizardGenCtrl::SetHeadingFont(IDispatch* /*pVal*/)
{
   AFX_MANAGE_STATE(AfxGetStaticModuleState());

   // TODO: Add your property handler code here

   SetModifiedFlag();
}

最後に、プロパティ追加ウィザードは、HeadingFont プロパティのエントリを追加してコントロールの .IDL ファイルを変更します。

[id(1)] IDispatch* HeadingFont;

コントロールのコードの変更

コントロールに HeadingFont プロパティを追加したら、この新しいプロパティが完全にサポートされるように、コントロールのヘッダーファイルと実装ファイルを変更します。

コントロールのヘッダー (.H) ファイルに、次のようなプロテクトメンバ変数の宣言を追加します。

protected:
   CFontHolder m_fontHeading;

コントロールの実装 (.CPP) ファイルを次のように変更します。

コントロールのコンストラクタで m_fontHeading を初期化します。

CMyAxFontCtrl::CMyAxFontCtrl()
   : m_fontHeading(&m_xFontNotification)
{
    InitializeIIDs(&IID_DNVC_MFC_AxFont, &IID_DNVC_MFC_AxFontEvents);
}

フォントの既定の属性を持つ静的 FONTDESC 構造体を宣言します。

static const FONTDESC _fontdescHeading =
  { sizeof(FONTDESC), OLESTR("MS Sans Serif"), FONTSIZE( 12 ), FW_BOLD, 
    ANSI_CHARSET, FALSE, FALSE, FALSE };

コントロールの DoPropExchange メンバ関数に、PX_Font 関数の呼び出しを追加します。これにより、カスタムフォントプロパティの初期化と永続化が行われます。

void CMyAxFontCtrl::DoPropExchange(CPropExchange* pPX)
{
    ExchangeVersion(pPX, MAKELONG(_wVerMinor, _wVerMajor));
    COleControl::DoPropExchange(pPX);

   // [...other PX_ function calls...]
   PX_Font(pPX, _T("HeadingFont"), m_fontHeading, &_fontdescHeading);
}

コントロールの GetHeadingFont メンバ関数の実装を完了します。

IDispatch* CMyAxFontCtrl::GetHeadingFont(void)
{
   AFX_MANAGE_STATE(AfxGetStaticModuleState());

   return m_fontHeading.GetFontDispatch();
}

コントロールの SetHeadingFont メンバ関数の実装を完了します。

void CMyAxFontCtrl::SetHeadingFont(IDispatch* pVal)
{
   AFX_MANAGE_STATE(AfxGetStaticModuleState());

   m_fontHeading.InitializeFont(&_fontdescHeading, pVal);
   OnFontChanged();    //notify any changes
   SetModifiedFlag();
}

コントロールの OnDraw メンバ関数を変更して、前に選択されたフォントを保持するための変数を定義します。
```
CFont* pOldHeadingFont;
```
コントロールの OnDraw メンバ関数で、フォントを使用するすべての場所に次の行を追加して、デバイスコンテキストにカスタムフォントが選択されるように変更します。
```
pOldHeadingFont = SelectFontObject(pdc, m_fontHeading);
```
コントロールの OnDraw メンバ関数で、フォントを使用した後に次の行を追加して、デバイスコンテキストに選択されているフォントを前のフォントに戻します。
```
pdc->SelectObject(pOldHeadingFont);
```

カスタムフォントプロパティの実装が完了したら、コントロールのユーザーがコントロールの現在のフォントを変更できるように、標準のフォントプロパティページを実装する必要があります。標準のフォントプロパティページのプロパティページ ID を追加するには、BEGIN_PROPPAGEIDS マクロの後に次の行を挿入します。

PROPPAGEID(CLSID_CFontPropPage)

このほか、BEGIN_PROPPAGEIDS マクロのパラメータ count の値を 1 つ増やす必要があります。たとえば、次のようになります。

BEGIN_PROPPAGEIDS(CMyAxFontCtrl, 2)

変更作業が完了したら、プロジェクト全体をリビルドして追加機能を組み込みます。

フォントの通知の処理

通常は、フォントオブジェクトの特性が変更されたら、それをコントロールに通知する必要があります。各フォントオブジェクトは、COleControl によって実装されている IFontNotification インターフェイスのメンバ関数を呼び出すことにより、変更を通知できます。

コントロールがストックフォントプロパティを使っている場合は、COleControl の OnFontChanged メンバ関数が変更の通知を処理します。カスタムフォントプロパティを追加した場合も、同じ実装を使用できます。前のセクションで取り上げた例では、m_fontHeading メンバ変数を初期化するときに &m_xFontNotification を渡すことによって変更の通知を処理しました。

複数のフォントオブジェクトインターフェイスの実装
複数のフォントオブジェクトインターフェイスの実装

上の図の実線は、両方のフォントオブジェクトが同じ IFontNotification の実装を使用していることを表しています。これでは、どちらのフォントが変更されたのかを区別する必要がある場合に問題になります。

コントロールのフォントオブジェクトの通知を区別するには、コントロールの各フォントオブジェクトに個別に IFontNotification インターフェイスを実装する方法があります。この方法を使うと、最後に変更されたフォントを使用している文字列だけを更新することによって、描画コードを最適化できます。次に、2 番目のフォントプロパティに別の通知インターフェイスを実装するための手順を紹介します。前のセクションで追加した HeadingFont プロパティを 2 番目のフォントプロパティとして使用します。

新しいフォント通知インターフェイスの実装

複数のフォントの通知を区別するには、コントロールで使用する各フォントごとに新しい通知インターフェイスを実装する必要があります。この後のセクションでは、コントロールのヘッダーファイルと実装ファイルを変更して新しいフォント通知インターフェイスを実装する方法について説明します。

ヘッダーファイルへの追加

コントロールのヘッダー (.H) ファイルで、クラス宣言に次の行を追加します。

protected:
   BEGIN_INTERFACE_PART(HeadingFontNotify, IPropertyNotifySink)
   INIT_INTERFACE_PART(CMyAxFontCtrl, HeadingFontNotify)
      STDMETHOD(OnRequestEdit)(DISPID);
      STDMETHOD(OnChanged)(DISPID);
   END_INTERFACE_PART(HeadingFontNotify)

これにより、HeadingFontNotify という名前の IPropertyNotifySink インターフェイスの実装が作成されます。この新しいインターフェイスには、OnChanged というメソッドがあります。

実装ファイルへの追加

コントロールのコンストラクタで、見出しのフォントを初期化するコードの &m_xFontNotification を &m_xHeadingFontNotify に変更します。その後、次のコードを追加します。

STDMETHODIMP_(ULONG) CMyAxFontCtrl::XHeadingFontNotify::AddRef()
{
   METHOD_MANAGE_STATE(CMyAxFontCtrl, HeadingFontNotify)
   return 1;
}
STDMETHODIMP_(ULONG) CMyAxFontCtrl::XHeadingFontNotify::Release()
{
   METHOD_MANAGE_STATE(CMyAxFontCtrl, HeadingFontNotify)
   return 0;
}

STDMETHODIMP CMyAxFontCtrl::XHeadingFontNotify::QueryInterface(REFIID iid, LPVOID FAR* ppvObj)
{
   METHOD_MANAGE_STATE(CMyAxFontCtrl, HeadingFontNotify)
   if( IsEqualIID(iid, IID_IUnknown) || IsEqualIID(iid, IID_IPropertyNotifySink))
   {
      *ppvObj= this;
      AddRef();
      return NOERROR;
   }
   return ResultFromScode(E_NOINTERFACE);
}

STDMETHODIMP CMyAxFontCtrl::XHeadingFontNotify::OnChanged(DISPID)
{
   METHOD_MANAGE_STATE(CMyAxFontCtrl, HeadingFontNotify)
   pThis->InvalidateControl();
   return NOERROR;
}

STDMETHODIMP CMyAxFontCtrl::XHeadingFontNotify::OnRequestEdit(DISPID)
{
   return NOERROR;
}

IPropertyNotifySink インターフェイスの AddRef メソッドと Release メソッドは、ActiveX コントロールオブジェクトの参照カウントを追跡します。コントロールは、インターフェイスポインタにアクセスしたときに、AddRef を呼び出して参照カウントを増分します。また、グローバルメモリブロックを解放するために GlobalFree を呼び出すのと同様に、ポインタを使い終わると Release を呼び出します。インターフェイスの参照カウントが 0 になると、インターフェイスの実装を解放できます。この例では、QueryInterface 関数が、特定のオブジェクトの IPropertyNotifySink インターフェイスへのポインタを返します。ActiveX コントロールは、この関数を使って、オブジェクトがサポートしているインターフェイスを問い合わせることができます。

変更作業が完了したら、プロジェクトをリビルドし、テストコンテナを使ってインターフェイスをテストします。テストコンテナへのアクセス方法については、「テストコンテナでのプロパティとイベントのテスト」を参照してください。

参照

概念

MFC ActiveX コントロール

参照

MFC ActiveX コントロール : ActiveX コントロールにおけるピクチャの使用

MFC ActiveX コントロール : ストックプロパティページの使用

次の方法で共有

MFC ActiveX コントロール : フォントの使用

ストックフォントプロパティの使用

プロパティ追加ウィザードを使ってストックフォントプロパティを追加するには

プロパティ追加ウィザードを使ってストックキャプションプロパティを追加するには

OnDraw 関数の変更

コントロールでのカスタムフォントプロパティの使用

カスタムフォントプロパティの実装

プロパティ追加ウィザードを使ってカスタムフォントプロパティを追加するには

コントロールのコードの変更

フォントの通知の処理

新しいフォント通知インターフェイスの実装

ヘッダーファイルへの追加

実装ファイルへの追加

参照

概念

参照

その他のリソース

次の方法で共有

MFC ActiveX コントロール : フォントの使用

ストック フォント プロパティの使用

プロパティ追加 ウィザードを使ってストック フォント プロパティを追加するには

プロパティ追加 ウィザードを使ってストック キャプション プロパティを追加するには

OnDraw 関数の変更

コントロールでのカスタム フォント プロパティの使用

カスタム フォント プロパティの実装

プロパティ追加 ウィザードを使ってカスタム フォント プロパティを追加するには

コントロールのコードの変更

フォントの通知の処理

新しいフォント通知インターフェイスの実装

ヘッダー ファイルへの追加

実装ファイルへの追加

参照

概念

参照

その他のリソース

ストックフォントプロパティの使用

プロパティ追加ウィザードを使ってストックフォントプロパティを追加するには

プロパティ追加ウィザードを使ってストックキャプションプロパティを追加するには

コントロールでのカスタムフォントプロパティの使用

カスタムフォントプロパティの実装

プロパティ追加ウィザードを使ってカスタムフォントプロパティを追加するには

ヘッダーファイルへの追加