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 zone de case activée é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 suivants :

ECBF_CHECKNAME_AT_FRONT

Si la valeur est définie, CPSUI affiche les 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 la valeur est définie, CPSUI affiche la chaîne pCheckedName uniquement si l’option est activée (autrement dit, OPTIF_ECB_CHECKED est définie et OPTIF_DISABLED est clair dans la structure OPTITEM ).

S’il n’est pas défini, 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

S’il est défini, le membre IconID contient un handle d’icône.

S’il n’est pas défini, le membre IconID contient un identificateur de ressource d’icône.

ECBF_OVERLAY_ECBICON_IF_CHECKED

Si cette option est définie et si la case case activée est cochée (autrement dit, OPTIF_ECB_CHECKED est définie dans la structure OPTITEM), CPSUI superpose l’icône identifiée par le membre IconID sur l’icône associée à l’élément d’option.

ECBF_OVERLAY_NO_ICON

Si la valeur est définie, CPSUI superpose son icône IDI_CPSUI_NO à l’icône identifiée par le membre IconID .

ECBF_OVERLAY_STOP_ICON

Si cette option est définie, CPSUI superpose l’icône IDI_CPSUI_STOP à l’icône identifiée par le membre IconID .

ECBF_OVERLAY_WARNING_ICON

Si cette option est définie, CPSUI superpose son icône IDI_CPSUI_WARNING sur l’icône identifiée par le membre IconID .

pTitle

Identificateur de chaîne, représentant le titre de la zone case activée. Il peut s’agir d’un pointeur 32 bits vers une chaîne terminée par NULL, ou 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 de séparation à 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 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 case activée est cochée. Il peut s’agir d’un pointeur 32 bits vers une chaîne terminée par NULL, ou 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. Il peut s’agir de l’un des identificateurs de ressource d’icône avec préfixe IDI_CPSUI fournis par 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, aucune icône n’est affichée.

wReserved[4]

Réservé, doit être initialisé à zéro.

dwReserved[2]

Réservé, doit être initialisé à zéro.

Remarques

Une zone de case activée étendue est un type de zone de case activée défini par CPSUI qui peut être associé à une structure OPTITEM. Une structure OPTITEM peut être associée à une zone de case activée étendue ou à un bouton poussoir étendu.

Configuration requise

Voir aussi

EXTPUSH