EXTCHKBOX 構造体 (compstui.h)

[アーティクル]
02/06/2025

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

設定すると、オプションがオンで有効になっている場合 (つまり、OPTIF_ECB_CHECKEDが設定され、OPTITEM 構造体でOPTIF_DISABLEDがクリアされている) 場合にのみ、CPSUI によって 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 は、IconID メンバーによって識別されるアイコンにIDI_CPSUI_NO アイコンをオーバーレイします。

ECBF_OVERLAY_STOP_ICON

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

ECBF_OVERLAY_WARNING_ICON

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

pTitle

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

pSeparator

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

pCheckedName

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

IconID

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

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

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

wReserved[4]

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

dwReserved[2]

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

備考

拡張チェック・ボックスは、OPTITEM 構造体に関連付けることができる CPSUI 定義のタイプのチェック・ボックスです。 OPTITEM 構造体には、1 つの拡張チェックボックスまたは 1 つの拡張プッシュボタンを関連付けることができます。

必要条件

要件	価値
ヘッダー	compstui.h (Compstui.h を含む)

次の方法で共有