次の方法で共有


EXTCHKBOX 構造体 (compstui.h)

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]

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

注釈

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

要件

要件
Header compstui.h (Compstui.h を含む)

こちらもご覧ください

EXTPUSH