CHOOSEFONTA 構造体 (commdlg.h)

ChooseFont 関数が [フォント] ダイアログ ボックスの初期化に使用する情報を格納します。 ユーザーがダイアログ ボックスを閉じると、この構造のユーザーの選択に関する情報が返されます。

構文

typedef struct tagCHOOSEFONTA {
  DWORD        lStructSize;
  HWND         hwndOwner;
  HDC          hDC;
  LPLOGFONTA   lpLogFont;
  INT          iPointSize;
  DWORD        Flags;
  COLORREF     rgbColors;
  LPARAM       lCustData;
  LPCFHOOKPROC lpfnHook;
  LPCSTR       lpTemplateName;
  HINSTANCE    hInstance;
  LPSTR        lpszStyle;
  WORD         nFontType;
  WORD         ___MISSING_ALIGNMENT__;
  INT          nSizeMin;
  INT          nSizeMax;
} CHOOSEFONTA;

メンバー

lStructSize

型: DWORD

構造体の長さ (バイト単位)。

hwndOwner

型: HWND

ダイアログ ボックスを所有するウィンドウへのハンドル。 このメンバーは、任意の有効なウィンドウ ハンドルにすることも、ダイアログ ボックスに所有者がいない場合は NULL にすることもできます。

hDC

種類: HDC

このメンバーは ChooseFont 関数では無視されます。

Windows Vista および Windows XP/2000: ダイアログ ボックスにフォントが表示されるプリンターのデバイス コンテキストまたは情報コンテキストへのハンドル。 このメンバーは、Flags メンバーが CF_PRINTERFONTS または CF_BOTH フラグを指定する場合にのみ使用されます。それ以外の場合、このメンバーは無視されます。

lpLogFont

種類: LPLOGFONT

LOGFONT 構造体へのポインター。 Flags メンバーで CF_INITTOLOGFONTSTRUCT フラグを設定し、他のメンバーを初期化すると、ChooseFont 関数は LOGFONT メンバーに一致するフォントでダイアログ ボックスを初期化します。 ユーザーが [OK] ボタンをクリックすると、 ChooseFont は ユーザーの選択に基づいて LOGFONT 構造体のメンバーを設定します。

iPointSize

型: INT

ポイントの 1/10 単位で、選択したフォントのサイズ。 ユーザーがダイアログ ボックスを閉じると、 ChooseFont 関数によってこの値が設定されます。

Flags

型: DWORD

[ フォント ] ダイアログ ボックスの初期化に使用できるビット フラグのセット。 ダイアログ ボックスが戻ると、ユーザー入力を示すようにこれらのフラグが設定されます。 このメンバーには、次の値の 1 つ以上を指定できます。

rgbColors

種類: COLORREF

CF_EFFECTS フラグが設定されている場合、rgbColors は初期テキストの色を指定します。 ChooseFont が正常に返されると、このメンバーには、ユーザーが選択したテキストの色の RGB 値が含まれます。 COLORREF カラー値を作成するには、RGB マクロを使用します。

lCustData

型: LPARAM

システムが lpfnHook メンバーによって識別されるフック・プロシージャーに渡すアプリケーション定義データ。 システムが WM_INITDIALOG メッセージをフック・プロシージャーに送信する場合、メッセージの lParam パラメーターは、ダイアログの作成時に指定された CHOOSEFONT 構造体へのポインターです。 フック プロシージャでは、このポインターを使用して lCustData 値を取得できます。

lpfnHook

種類: LPCFHOOKPROC

ダイアログ ボックス用のメッセージを処理できる CFHookProc フック プロシージャへのポインター。 CF_ENABLEHOOK フラグがFlags メンバーに設定されていない限り、このメンバーは無視されます。

lpTemplateName

種類: LPCTSTR

hInstance メンバーによって識別されるモジュール内のダイアログ ボックス テンプレート リソースの名前。 このテンプレートは、標準のダイアログ ボックス テンプレートに置き換えられます。 番号付きダイアログ ボックス リソースの場合、 lpTemplateName には MAKEINTRESOURCE マクロによって返される値を指定できます。 CF_ENABLETEMPLATE フラグがFlags メンバーに設定されていない限り、このメンバーは無視されます。

hInstance

種類: HINSTANCE

CF_ENABLETEMPLATEHANDLE フラグが Flags メンバーに設定されている場合、hInstance はダイアログ ボックス テンプレートを含むメモリ オブジェクトへのハンドルです。 CF_ENABLETEMPLATE フラグが設定されている場合、hInstance は lpTemplateName メンバーによって名前付けされたダイアログ ボックス テンプレートを含むモジュールへのハンドルです。 CF_ENABLETEMPLATEHANDLEもCF_ENABLETEMPLATEも設定されていない場合、このメンバーは無視されます。

lpszStyle

種類: LPTSTR

スタイル データ。 CF_USESTYLE フラグが指定されている場合、ChooseFont は、このバッファー内のデータを使用して、[フォント スタイル] コンボ ボックスを初期化します。 ユーザーがダイアログ ボックスを閉じると、 ChooseFont は [ フォント スタイル ] コンボ ボックスの文字列をこのバッファーにコピーします。

nFontType

種類: WORD

ChooseFont が返されるときに選択したフォントの種類。 このメンバーには、次の値の 1 つ以上を指定できます。

___MISSING_ALIGNMENT__

nSizeMin

型: INT

ユーザーが選択できるポイント サイズの最小値。 ChooseFont は 、 CF_LIMITSIZE フラグが指定されている場合にのみ、このメンバーを認識します。

nSizeMax

型: INT

ユーザーが選択できるポイント サイズの最大値。 ChooseFont は 、 CF_LIMITSIZE フラグが指定されている場合にのみ、このメンバーを認識します。

解説

要件

関連項目

ChooseFont

共通ダイアログ ボックス ライブラリ

概念

MAKEINTRESOURCE

参照