Estructura EXTCHKBOX (compstui.h)
Las aplicaciones CPSUI usan 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, se establece OPTIF_ECB_CHECKED y OPTIF_DISABLED está desactivada en la estructura de OPTITEM de).
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 elemento IconID contiene un identificador de recursos 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 de OPTITEM), CPSUI superpone el icono identificado por el iconID miembro 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 de.
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 va a mostrar entre la cadena de nombre marcada 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 en la aplicación o puede ser uno de los identificadores de recursos de recursos de icono con prefijo CPSUI proporcionados IDI_CPSUI por 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.
Observaciones
Una casilla extendida es un tipo de casilla definido por CPSUI que se puede asociar a una estructura de OPTITEM. Una estructura OPTITEM puede tener una casilla extendida o un botón de inserción extendido asociado.
Requisitos
| Requisito | Valor |
|---|---|
| encabezado de | compstui.h (include Compstui.h) |