Structure EXTCHKBOX (compstui.h)
La structure EXTCHKBOX est utilisée par les applications CPSUI (y compris les DLL d’interface d’imprimante) pour spécifier une case à cocher étendue, qui peut être ajoutée à une option de page de feuille de propriétés.
Syntaxe
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;
Membres
cbSize
Taille, en octets, de la structure EXTCHKBOX.
Flags
Indicateurs de bits, qui peuvent être l’un des éléments suivants :
ECBF_CHECKNAME_AT_FRONT
Si elle est définie, CPSUI affiche des chaînes dans l’ordre « pCheckedName pSeparator SelectName», où SelectName est la chaîne associée à la valeur sélectionnée de l’option.
S’il n’est pas défini, CPSUI affiche les chaînes dans l’ordre «SelectName pSeparator pCheckedName ».
ECBF_CHECKNAME_ONLY_ENABLED
Si elle est définie, CPSUI affiche la chaîne pCheckedName uniquement si l’option est activée et activée (autrement dit, OPTIF_ECB_CHECKED est définie et OPTIF_DISABLED est effacée dans la structure OPTITEM).
Si elle n’est pas définie, CPSUI affiche toujours la chaîne pCheckedName si l’option est cochée (autrement dit, OPTIF_ECB_CHECKED est définie dans la structure OPTITEM), même si l’option est désactivée.
ECBF_ICONID_AS_HICON
Si la valeur est définie, le IconID membre contient un handle d’icône.
Si ce n’est pas le cas, le IconID membre contient un identificateur de ressource d’icône.
ECBF_OVERLAY_ECBICON_IF_CHECKED
Si elle est définie et si la case à cocher est cochée (autrement dit, OPTIF_ECB_CHECKED est définie dans la structure OPTITEM), CPSUI superpose l’icône identifiée par le IconID membre sur l’icône associée à l’élément d’option.
ECBF_OVERLAY_NO_ICON
Si elle est définie, CPSUI superpose son icône de IDI_CPSUI_NO sur l’icône identifiée par le IconID membre.
ECBF_OVERLAY_STOP_ICON
Si cette option est définie, CPSUI superpose l’icône de IDI_CPSUI_STOP sur l’icône identifiée par le IconID membre.
ECBF_OVERLAY_WARNING_ICON
Si cette option est définie, CPSUI superpose son icône de IDI_CPSUI_WARNING sur l’icône identifiée par le IconID membre.
pTitle
Identificateur de chaîne représentant le titre de la case à cocher. Il peut s’agir d’un pointeur 32 bits vers une chaîne terminée par NULL, ou il peut s’agir d’un identificateur de ressource de chaîne 16 bits avec HIWORD défini sur zéro.
pSeparator
Identificateur de chaîne, représentant un caractère séparateur à afficher entre la chaîne de nom cochée et la chaîne d’option sélectionnée, il peut s’agir d’un pointeur 32 bits vers une chaîne terminée par NULL, ou il peut s’agir d’un identificateur de ressource de chaîne 16 bits avec HIWORD défini sur zéro.
pCheckedName
Identificateur de chaîne, représentant le texte à afficher lorsque la case à cocher est cochée. Il peut s’agir d’un pointeur 32 bits vers une chaîne terminée par NULL, ou il peut s’agir d’un identificateur de ressource de chaîne 16 bits avec HIWORD défini sur zéro.
IconID
L’un des identificateurs d’icône suivants :
Identificateur de ressource d’icône. Cela peut être défini par l’application, ou il peut s’agir de l’un des identificateurs de ressource d’icônes IDI_CPSUI préfixés de cpSUI.
Handle d’icône. Si un handle est spécifié, ECBF_ICONID_AS_HICON doit être défini dans le membre Indicateurs.
Si cette valeur est égale à zéro, une icône n’est pas affichée.
wReserved[4]
Réservé, doit être initialisé à zéro.
dwReserved[2]
Réservé, doit être initialisé à zéro.
Remarques
Une case à cocher étendue est un type de case à cocher défini par CPSUI qui peut être associé à une structure OPTITEM. Une structure OPTITEM peut avoir une case à cocher étendue ou un bouton push étendu associé à celui-ci.
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | compstui.h (include Compstui.h) |