共用方式為


EXTCHKBOX 結構 (compstui.h)

CPSUI 應用程式會使用 EXTCHKBOX 結構來指定擴充複選框,其可新增至屬性表頁面選項。

語法

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圖標資源識別碼。

  • 圖示句柄。 如果指定句柄,則必須在 旗標 成員中設定ECBF_ICONID_AS_HICON。

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

wReserved[4]

保留的 必須初始化為零。

dwReserved[2]

保留的 必須初始化為零。

言論

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

要求

要求 價值
標頭 compstui.h (包括 Compstui.h)

另請參閱

EXTPUSH