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.

Si ce n’est pas défini, CPSUI affiche des 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 claire dans la structure OPTITEM).

Si elle n’est pas définie, CPSUI affiche toujours la chaîne pCheckedName si l’option est activé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 elle est définie, le membre IconID contient un handle d’icône.

Si ce n’est pas défini, le membre IconID 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 superposition 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 elle est définie, CPSUI superpose son icône IDI_CPSUI_NO sur l’icône identifiée par le membre IconID .

ECBF_OVERLAY_STOP_ICON

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

ECBF_OVERLAY_WARNING_ICON

Si elle 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 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.
  • Poignée d’icône. Si un handle est spécifié, ECBF_ICONID_AS_HICON doit être défini dans le membre Flags .
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é.

Configuration requise

   
En-tête compstui.h (include Compstui.h)

Voir aussi

EXTPUSH