EXTCHKBOX 構造体 (compstui.h)

[アーティクル]
02/26/2024

EXTCHKBOX 構造体は、プロパティシートページオプションに追加できる拡張チェックボックスを指定するために、CPSUI アプリケーション (プリンターインターフェイス DLL を含む) によって使用されます。

構文

typedef struct _EXTCHKBOX {
  WORD      cbSize;
  WORD      Flags;
  LPTSTR    pTitle;
  LPTSTR    pSeparator;
  LPTSTR    pCheckedName;
  ULONG_PTR IconID;
  WORD      wReserved[4];
  ULONG_PTR dwReserved[2];
} EXTCHKBOX, *PEXTCHKBOX;

メンバー

cbSize

EXTCHKBOX 構造体のサイズ (バイト単位)。

Flags

ビットフラグ。次のいずれかになります。

ECBF_CHECKNAME_AT_FRONT

設定した場合、CPSUI は"pCheckedName pSeparator SelectName" という順序で文字列を表示します。 ここで、SelectName はオプションの選択した値に関連付けられた文字列です。

設定されていない場合、CPSUI は "SelectName pSeparator pCheckedName" という順序で文字列を表示します。

ECBF_CHECKNAME_ONLY_ENABLED

設定されている場合、CPSUI は、オプションがオンで有効になっている場合 (つまり、OPTIF_ECB_CHECKEDが設定され、 OPTITEM 構造体でOPTIF_DISABLEDがクリアされている) 場合にのみ、pCheckedName 文字列を表示します。

設定されていない場合、オプションが無効になっている場合でも、CPSUI は常に pCheckedName 文字列を表示します (つまり、オプションが無効になっている場合でも、 OPTITEM 構造体で設定OPTIF_ECB_CHECKED)。

ECBF_ICONID_AS_HICON

設定した場合、 IconID メンバーにはアイコンハンドルが含まれます。

設定されていない場合、 IconID メンバーにはアイコンリソース識別子が含まれます。

ECBF_OVERLAY_ECBICON_IF_CHECKED

設定されている場合、およびチェックボックスがオンになっている場合 (つまり、OPTITEM 構造体にOPTIF_ECB_CHECKEDが設定されている場合)、CPSUI は IconID メンバーによって識別されるアイコンをオプション項目に関連付けられているアイコンにオーバーレイします。

ECBF_OVERLAY_NO_ICON

設定した場合、CPSUI は、そのIDI_CPSUI_NOアイコンを IconID メンバーによって識別されるアイコンにオーバーレイします。

ECBF_OVERLAY_STOP_ICON

設定した場合、CPSUI は、IDI_CPSUI_STOP アイコンを IconID メンバーによって識別されるアイコンにオーバーレイします。

ECBF_OVERLAY_WARNING_ICON

設定した場合、CPSUI は、そのIDI_CPSUI_WARNINGアイコンを IconID メンバーによって識別されるアイコンにオーバーレイします。

pTitle

チェックボックスのタイトルを表す文字列識別子。 NULL で終わる文字列への 32 ビットポインターを指定することも、HIWORD を 0 に設定した 16 ビット文字列リソース識別子を指定することもできます。

pSeparator

文字列識別子。チェックされた名前文字列と選択したオプション文字列の間に表示される区切り文字を表します。NULL で終わる文字列への 32 ビットポインターを指定することも、HIWORD を 0 に設定した 16 ビット文字列リソース識別子を指定することもできます。

pCheckedName

[チェック] ボックスがオンのときに表示されるテキストを表す文字列識別子。 NULL で終わる文字列への 32 ビットポインターを指定することも、HIWORD を 0 に設定した 16 ビット文字列リソース識別子を指定することもできます。

IconID

次のいずれかのアイコン識別子:

アイコンリソース識別子。これは、アプリケーション定義でも、CPSUI 提供のIDI_CPSUIプレフィックス付きアイコンリソース識別子の 1 つでもかまいません。
アイコンハンドル。ハンドルが指定されている場合は、 flags メンバーでECBF_ICONID_AS_HICONを設定する必要があります。

この値が 0 の場合、アイコンは表示されません。

wReserved[4]

予約済み。は 0 に初期化する必要があります。

dwReserved[2]