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

[アーティクル]
02/21/2013

ActiveX コントロールがショートメッセージは、コントロールのユーザーがフォントプロパティを変更して、テキストの外観を変更できるようにすることができます。フォントプロパティは、フォントオブジェクトとして実装され、 2 種類の 1 つです: ストックまたはカスタム。ストックフォントプロパティは、プロパティの追加ウィザードを使用して追加できる preimplemented フォントプロパティです。カスタムフォントのプロパティは、エンティティ preimplemented し、コントロールの開発者はプロパティの動作と使用を決定します。

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

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

ストックフォントプロパティを使用する

ストックフォントプロパティは、クラス COleControlによって preimplemented。また、標準フォントのプロパティページでは、使用すると、名前、サイズ、およびフォームのようなフォントオブジェクトのさまざまな属性を、変更を許可します。

COleControlの GetFont、 SetFontと InternalGetFont 関数によってフォントオブジェクトにアクセスします。コントロールのユーザーは GetFont と SetFont 関数によって他の取得と設定のプロパティと同様にフォントオブジェクトにアクセスします。フォントオブジェクトへのアクセスがコントロール内から必要な場合は、 InternalGetFont 関数を使用します。

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

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

コントロールプロジェクトを読み込んでください。
クラスビューで、コントロールのライブラリノードを展開します。
ショートカットメニューを開くには、コントロール（ライブラリノードの 2 番目のノード）のインターフェイスノードを右クリックします。
ショートカットメニューのをクリック追加は、 プロパティの追加をクリックします。

これは、プロパティの追加ウィザードを開きます。
プロパティ名(O),プロパティ名 ボックスで、をクリック フォント。
[完了] をクリックします。

プロパティの追加ウィザードはコントロールクラスの実装ファイルに含まれるコントロールのディスパッチマップに次の行を追加します:

DISP_STOCKPROP_FONT()

また、プロパティの追加ウィザードは、コントロール .IDL ファイルに次の行を追加します:

[id(DISPID_FONT)] IFontDisp*Font;

ストック Caption プロパティは、ストックフォントプロパティの情報を使用して描画できるテキストプロパティの例です。コントロールに標準的なキャプションプロパティを追加すると、ストックフォントプロパティに使用する要素と似た手順を使用します。

標準的なキャプションプロパティをプロパティの追加ウィザードを追加するには

コントロールプロジェクトを読み込んでください。
クラスビューで、コントロールのライブラリノードを展開します。
ショートカットメニューを開くには、コントロール（ライブラリノードの 2 番目のノード）のインターフェイスノードを右クリックします。
ショートカットメニューのをクリック追加は、 プロパティの追加をクリックします。

これは、プロパティの追加ウィザードを開きます。
プロパティ名(O),プロパティ名 ボックスで、をクリック キャプション。
[完了] をクリックします。

プロパティの追加ウィザードはコントロールクラスの実装ファイルに含まれるコントロールのディスパッチマップに次の行を追加します:

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 コントロールはカスタムフォントのプロパティを持つ場合があります。カスタムフォントのプロパティを追加するには、次の条件を満たしている:

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

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

カスタムフォントのプロパティを実装するには、プロパティを追加し、コードに対する変更を行うには、プロパティの追加ウィザードを使用します。以降のセクションでは、サンプルのコントロールに HeadingFont のカスタムプロパティを追加する方法について説明します。

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

コントロールプロジェクトを読み込んでください。
クラスビューで、コントロールのライブラリノードを展開します。
ショートカットメニューを開くには、コントロール（ライブラリノードの 2 番目のノード）のインターフェイスノードを右クリックします。
ショートカットメニューのをクリック追加は、 プロパティの追加をクリックします。

これは、プロパティの追加ウィザードを開きます。
プロパティ名(O),プロパティ名 ボックスで、プロパティの名前を入力します。この例では、 HeadingFontを使用します。
Implementation Typeでは、をクリック Get/Set Methods。
プロパティの型,プロパティの種類,プロパティの種類(Y),プロパティ型 ボックスで、プロパティの型の選択 IDispatch* 。
[完了] をクリックします。

プロパティの追加ウィザードは CSampleCtrl のクラスと SAMPLE.IDL ファイルに HeadingFont のカスタムプロパティを追加するコードを作成します。HeadingFont が取得と設定のプロパティ型であるため、プロパティの追加ウィザードは DISP_PROPERTY_EX_IDDISP_PROPERTY_EX マクロエントリを含むように CSampleCtrl のクラスのディスパッチマップを変更します:

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

DISP_PROPERTY_EX のマクロは CSampleCtrl の対応するクラス名と HeadingFont のプロパティ設定を取得します GetHeadingFont メソッド、および SetHeadingFont関連付け。プロパティ値の型も指定されます; この場合、 VT_FONT。

プロパティの追加ウィザードは、コントロールのヘッダーファイルの宣言を追加します。 GetHeadingFont と SetHeadingFont の H）は機能し、コントロールの実装ファイル（.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)

または 1 ずつ BEGIN_PROPPAGEIDS マクロのパラメーター数をインクリメントします。次の行は、これを示しています:

BEGIN_PROPPAGEIDS(CMyAxFontCtrl, 2)

これらの変更が加えられた後、追加機能を組み込むプロジェクト全体を再ビルドします。

フォントの通知の処理

ほとんどの場合、フォントオブジェクトの特性がいつ変更したかを確認するコントロールは。各フォントオブジェクトは IFontNotification インターフェイスのメンバー関数を呼び出すことで変更するときに通知を提供できますが、 COleControlによって実装されます。

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

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

フォントオブジェクトが両方とも同じ IFontNotificationの実装を使用する上の図の実線。これは、フォントが変更された区別する場合は、問題が発生する可能性があります。

コントロールのフォントオブジェクトの通知を区別する 1 とおりの方法は、コントロールの各フォントオブジェクトの IFontNotification インターフェイスの別の実装を作成します。この手法は、最近変更されたフォントを使用し、文字列や、文字列を更新して描画コードを最適化するようにします。以降のセクションでは、 2 番目のフォントプロパティに別の通知インターフェイスを実装するための手順を示します。2 番目のフォントプロパティは、前のセクションで追加した HeadingFont のプロパティと見なされます。

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

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

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

コントロールのヘッダーファイル。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_xHeadingFontNotifyに &m_xFontNotification を変更します。次のコードを追加します:

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を、ほぼ同様に、ダイヤルします。このインターフェイスの参照カウントがゼロになると、インターフェイスの実装を解放できます。この例では、特定のオブジェクトの IPropertyNotifySink インターフェイスへの QueryInterface 関数の戻り値のポインター。この関数は、 ActiveX コントロールは、インターフェイスをサポートするかを判断するためにオブジェクトを呼び出すことができます。

プロジェクトへの変更が加えられると、プロジェクトを再度ビルドし、インターフェイスをテストするテストコンテナーを使用します。テストコンテナーへのアクセス方法については、「テストコンテナーでのプロパティとイベントのテスト」を参照してください。

参照

概念

MFC ActiveX コントロール

次の方法で共有

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

ストックフォントプロパティを使用する

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

標準的なキャプションプロパティをプロパティの追加ウィザードを追加するには

OnDraw の関数の変更

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

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

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

コードの変更

フォントの通知の処理

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

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

実装ファイルへの加算

参照

関連項目

概念

その他のリソース

次の方法で共有

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

ストック フォント プロパティを使用する

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

標準的なキャプション プロパティをプロパティの追加ウィザードを追加するには

OnDraw の関数の変更

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

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

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

コードの変更

フォントの通知の処理

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

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

実装ファイルへの加算

参照

関連項目

概念

その他のリソース

ストックフォントプロパティを使用する

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

標準的なキャプションプロパティをプロパティの追加ウィザードを追加するには

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

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

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

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