EXTCHKBOX 結構 (compstui.h)

  • 發行項

CPSUI 應用程式會使用 EXTCHKBOX 結構， (包括印表機介面 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 才會顯示 pCheckedName 字串，也就是說，OPTIF_ECB_CHECKED已設定並OPTIF_DISABLED 在 OPTITEM 結構) 中清除。

如果未設定，即使選項已停用，CPSUI 一律會顯示 pCheckedName 字串 (，OPTIF_ECB_CHECKED在 OPTITEM 結構中設定) 。

ECBF_ICONID_AS_HICON

如果設定， IconID 成員會包含圖示句柄。

如果未設定， IconID 成員會包含圖示資源標識符。

ECBF_OVERLAY_ECBICON_IF_CHECKED

如果已設定，而且核取複選框 (，OPTIF_ECB_CHECKED是在 OPTITEM 結構) 中設定，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 位指標，也可以是 16 位字串資源識別符，且 HIWORD 設定為零。

pSeparator

字串標識碼，代表在核取的名稱字串與選取的選項字串之間顯示的分隔符。這可以是 NULL 終止字串的 32 位指標，也可以是 16 位字串資源識別符，且 HIWORD 設定為零。

pCheckedName

字串標識碼，表示核取複選框時要顯示的文字。 這可以是 NULL 終止字串的 32 位指標，也可以是 16 位字串資源識別符，且 HIWORD 設定為零。

IconID

下列其中一個圖示識別碼：

  • 圖示資源標識碼。 這可以是應用程式定義的，也可以是其中一個 CPSUI 提供的IDI_CPSUI前置圖示資源識別碼。

  • 圖示句柄。 如果指定句柄，則必須在 Flags 成員中設定ECBF_ICONID_AS_HICON。

如果此值為零，則不會顯示圖示。

wReserved[4]

保留，必須初始化為零。

dwReserved[2]

保留，必須初始化為零。

備註

擴充複選框是可與 OPTITEM 結構相關聯的 CPSUI 定義複選框類型。 OPTITEM 結構可以有一個擴充複選框或一個與其相關聯的延伸按鈕。

規格需求

需求 值
標頭 compstui.h (包含 Compstui.h)

另請參閱

EXTPUSH