Struktur EXTCHKBOX (compstui.h)

  • Artikel

Struktur EXTCHKBOX digunakan oleh aplikasi CPSUI (termasuk DLL antarmuka printer) untuk menentukan kotak centang yang diperluas, yang dapat ditambahkan ke opsi halaman lembar properti.

Sintaks

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;

Anggota

cbSize

Ukuran, dalam byte, dari struktur EXTCHKBOX .

Flags

Bendera bit, yang bisa menjadi salah satu dari berikut ini:

ECBF_CHECKNAME_AT_FRONT

Jika diatur, CPSUI menampilkan string dalam urutan "pCheckedName pSeparator SelectName", di mana SelectName adalah string yang terkait dengan nilai opsi yang dipilih.

Jika tidak diatur, CPSUI menampilkan string dalam urutan "SelectName pSeparator pCheckedName".

ECBF_CHECKNAME_ONLY_ENABLED

Jika diatur, CPSUI menampilkan string pCheckedName hanya jika opsi dicentang dan diaktifkan (yaitu, OPTIF_ECB_CHECKED diatur dan OPTIF_DISABLED jelas dalam struktur OPTITEM ).

Jika tidak diatur, CPSUI selalu menampilkan string pCheckedName jika opsi dicentang (yaitu, OPTIF_ECB_CHECKED diatur dalam struktur OPTITEM ), bahkan jika opsi dinonaktifkan.

ECBF_ICONID_AS_HICON

Jika diatur, anggota IconID berisi handel ikon.

Jika tidak diatur, anggota IconID berisi pengidentifikasi sumber daya ikon.

ECBF_OVERLAY_ECBICON_IF_CHECKED

Jika diatur, dan jika kotak centang dicentang (yaitu, OPTIF_ECB_CHECKED diatur dalam struktur OPTITEM ), CPSUI melapisi ikon yang diidentifikasi oleh anggota IconID ke ikon yang terkait dengan item opsi.

ECBF_OVERLAY_NO_ICON

Jika diatur, CPSUI melapisi ikon IDI_CPSUI_NO ke ikon yang diidentifikasi oleh anggota IconID .

ECBF_OVERLAY_STOP_ICON

Jika diatur, CPSUI melapisi ikon IDI_CPSUI_STOP ke ikon yang diidentifikasi oleh anggota IconID .

ECBF_OVERLAY_WARNING_ICON

Jika diatur, CPSUI melapisi ikon IDI_CPSUI_WARNING ke ikon yang diidentifikasi oleh anggota IconID .

pTitle

Pengidentifikasi string, mewakili judul kotak centang. Ini bisa menjadi penunjuk 32-bit ke string yang dihentikan NULL, atau dapat menjadi pengidentifikasi sumber daya string 16-bit dengan HIWORD diatur ke nol.

pSeparator

Pengidentifikasi string, yang mewakili karakter pemisah yang akan ditampilkan antara string nama yang dicentang dan string opsi yang dipilih Ini bisa menjadi penunjuk 32-bit ke string yang dihentikan NULL, atau dapat menjadi pengidentifikasi sumber daya string 16-bit dengan HIWORD diatur ke nol.

pCheckedName

Pengidentifikasi string, mewakili teks yang akan ditampilkan saat kotak centang dicentang. Ini bisa menjadi penunjuk 32-bit ke string yang dihentikan NULL, atau dapat menjadi pengidentifikasi sumber daya string 16-bit dengan HIWORD diatur ke nol.

IconID

Salah satu pengidentifikasi ikon berikut:

  • Pengidentifikasi sumber daya ikon. Ini dapat ditentukan aplikasi, atau dapat menjadi salah satu pengidentifikasi sumber daya ikon awalan CPSUI yang disediakan IDI_CPSUI.

  • Handel ikon. Jika handel ditentukan, ECBF_ICONID_AS_HICON harus diatur di anggota Bendera .

Jika nilai ini nol, ikon tidak ditampilkan.

wReserved[4]

Dicadangkan, harus diinisialisasi ke nol.

dwReserved[2]

Dicadangkan, harus diinisialisasi ke nol.

Keterangan

Kotak centang yang diperluas adalah jenis kotak centang yang ditentukan CPSUI yang dapat dikaitkan dengan struktur OPTITEM . Struktur OPTITEM dapat memiliki satu kotak centang yang diperluas atau satu tombol pendorongan diperluas yang terkait dengannya.

Persyaratan

Persyaratan Nilai
Header compstui.h (termasuk Compstui.h)

Lihat juga

EXTPUSH