Compartir a través de

Estructura EXTCHKBOX (compstui.h)

  • Artículo

Las aplicaciones CPSUI usan la estructura EXTCHKBOX (incluidos los archivos DLL de interfaz de impresora) para especificar una casilla extendida, que se puede agregar a una opción de página de hoja de propiedades.

Sintaxis

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;

Miembros

cbSize

Tamaño, en bytes, de la estructura EXTCHKBOX .

Flags

Marcas de bits, que pueden ser una de las siguientes:

ECBF_CHECKNAME_AT_FRONT

Si se establece, CPSUI muestra cadenas en el orden "pCheckedName pSeparator SelectName", donde SelectName es la cadena asociada al valor seleccionado de la opción.

Si no se establece, CPSUI muestra cadenas en el orden "SelectName pSeparator pCheckedName".

ECBF_CHECKNAME_ONLY_ENABLED

Si se establece, CPSUI muestra la cadena pCheckedName solo si la opción está activada y habilitada (es decir, OPTIF_ECB_CHECKED está establecida y OPTIF_DISABLED está desactivada en la estructura OPTITEM ).

Si no se establece, CPSUI siempre muestra la cadena pCheckedName si la opción está activada (es decir, OPTIF_ECB_CHECKED se establece en la estructura OPTITEM ), incluso si la opción está deshabilitada.

ECBF_ICONID_AS_HICON

Si se establece, el miembro IconID contiene un identificador de icono.

Si no se establece, el miembro IconID contiene un identificador de recurso de icono.

ECBF_OVERLAY_ECBICON_IF_CHECKED

Si se establece y si la casilla está activada (es decir, OPTIF_ECB_CHECKED se establece en la estructura OPTITEM ), CPSUI superpone el icono identificado por el miembro IconID en el icono asociado al elemento de opción.

ECBF_OVERLAY_NO_ICON

Si se establece, CPSUI superpone su icono de IDI_CPSUI_NO en el icono identificado por el miembro IconID .

ECBF_OVERLAY_STOP_ICON

Si se establece, CPSUI superpone el icono de IDI_CPSUI_STOP en el icono identificado por el miembro IconID .

ECBF_OVERLAY_WARNING_ICON

Si se establece, CPSUI superpone su icono de IDI_CPSUI_WARNING en el icono identificado por el miembro IconID .

pTitle

Identificador de cadena, que representa el título de la casilla. Puede ser un puntero de 32 bits a una cadena terminada en NULL o puede ser un identificador de recurso de cadena de 16 bits con HIWORD establecido en cero.

pSeparator

Identificador de cadena, que representa un carácter separador que se mostrará entre la cadena de nombre activada y la cadena de opción seleccionada. Puede ser un puntero de 32 bits a una cadena terminada en NULL o puede ser un identificador de recurso de cadena de 16 bits con HIWORD establecido en cero.

pCheckedName

Identificador de cadena, que representa el texto que se va a mostrar cuando se activa la casilla. Puede ser un puntero de 32 bits a una cadena terminada en NULL o puede ser un identificador de recurso de cadena de 16 bits con HIWORD establecido en cero.

IconID

Uno de los siguientes identificadores de icono:

  • Un identificador de recurso de icono. Esto puede definirse por la aplicación o puede ser uno de los identificadores de recursos de recursos de icono con prefijos de CPSUI proporcionados IDI_CPSUI.

  • Identificador de icono. Si se especifica un identificador, ECBF_ICONID_AS_HICON debe establecerse en el miembro Flags .

Si este valor es cero, no se muestra un icono.

wReserved[4]

Reservado, debe inicializarse en cero.

dwReserved[2]

Reservado, debe inicializarse en cero.

Comentarios

Una casilla extendida es un tipo de casilla definido por CPSUI que se puede asociar a una estructura OPTITEM . Una estructura OPTITEM puede tener una casilla extendida o un botón de pulsación extendido asociado.

Requisitos

Requisito Valor
Header compstui.h (incluir Compstui.h)

Consulte también

EXTPUSH