TVOT_PUSHBUTTON

  • Artículo

Importante

Se recomienda usar el controlador de clase de bandeja de entrada IPP de Microsoft, junto con las aplicaciones de soporte técnico de impresión (PSA), para personalizar la experiencia de impresión en Windows 10 y 11 para el desarrollo de dispositivos de impresora.

Para obtener más información, consulte la Guía de diseño de aplicaciones de soporte técnico de impresión.

El tipo de opción TVOT_PUSHBUTTON consta de un botón de inserción dentro de un cuadro de grupo.

Estructura OPTITEM

Sel/pSel
Depende del miembro Style de la estructura OPTPARAM, como se indica a continuación.

Estilo de botón de inserción Uso de Sel/pSel
PUSHBUTTON_TYPE_CALLBACK No se usa.
PUSHBUTTON_TYPE_DLGPROC CPSUI almacena el valor devuelto del procedimiento del cuadro de diálogo.
PUSHBUTTON_TYPE_HTCLRADJ CPSUI almacena el valor devuelto de la operación halftoning.
PUSHBUTTON_TYPE_HTSETUP CPSUI almacena el valor devuelto de la operación halftoning.

Matriz de estructura OPTPARAM (miembro pOptParam de OPTTYPE)

pData
Depende del miembro Style , como se indica a continuación.

Estilo de botón de inserción Uso de pData
PUSHBUTTON_TYPE_CALLBACK Puntero a una función con tipo _CPSUICALLBACK.
PUSHBUTTON_TYPE_DLGPROC Puntero con tipo DLGPROC a un procedimiento de cuadro de diálogo (consulte la documentación de Microsoft Windows SDK).
PUSHBUTTON_TYPE_HTCLRADJ Puntero a la estructura COLORADJUSTMENT (descrita en la documentación de Windows SDK).
PUSHBUTTON_TYPE_HTSETUP Puntero a una estructura DEVHTADJDATA .

IconID
Identifica un icono que se va a asociar con el botón de inserción.

Lparam Depende del miembro Style , como se indica a continuación.

Estilo de botón de inserción Uso de lParam
PUSHBUTTON_TYPE_CALLBACK No se usa.
PUSHBUTTON_TYPE_DLGPROC Identificador de recursos de un recurso DIALOG o identificador de una estructura DLGTEMPLATE (consulte la documentación de Windows SDK). Depende de la marca DPF_USE_HDLGTEMPLATE en el miembro Marcas de la estructura OPTPARAM.
PUSHBUTTON_TYPE_HTCLRADJ No se usa.
PUSHBUTTON_TYPE_HTSETUP No se usa.
Término Descripción
Estilo Especifica la operación que va a realizar CPSUI cuando un usuario hace clic en el botón de inserción. Puede ser uno de los siguientes valores:
PUSHBUTTON_TYPE_CALLBACK CPSUI llama a la función de devolución de llamada con tipo _CPSUICALLBACK de la aplicación para controlar eventos de botón, con el miembro Reason de la estructura CPSUICBPARAM establecido en CPSUICB_REASON_PUSHBUTTON. (CPSUI omite el valor devuelto de la función de devolución de llamada).
PUSHBUTTON_TYPE_DLGPROC El procedimiento del cuadro de diálogo de la aplicación controla los eventos de botón. (Para obtener más información, vea la sección Comentarios de DLGPAGE). Cuando la función recibe un mensaje de WM_INITDIALOG, su argumento lParam apunta a una estructura CPSUICBPARAM con el miembro Reason establecido en CPSUICB_REASON_DLGPROC.
PUSHBUTTON_TYPE_HTCLRADJ CPSUI muestra un cuadro de diálogo de ajuste de color de media tono.
PUSHBUTTON_TYPE_HTSETUP CPSUI muestra un cuadro de diálogo de configuración de medio tono del dispositivo.

Estructura OPTTYPE

Tipo TVOT_PUSHBUTTON

Recuento 1

Estilo Se pueden especificar las siguientes marcas de bits opcionales.

Marca Descripción
OTS_PUSH_ENABLE_ALWAYS Si se establece, el botón de inserción siempre está habilitado, incluso si el usuario no puede modificar la página de la hoja de propiedades (es decir, aunque CPSUIF_UPDATE_PERMISSION no esté establecida en una estructura COMPROPSHEETUI ).

La función de devolución de llamada del botón de inserción debe mostrar su cuadro de diálogo, pero no debe permitir modificaciones del usuario.

Tenga en cuenta que también debe establecer esta marca en el miembro Flags de la estructura OPTTYPE .
OTS_PUSH_INCL_SETUP_TITLE Si se establece, CPSUI incluye la palabra "Setup" después de la cadena de nombre del botón (pName en OPTITEM).
OTS_PUSH_NO_DOT_DOT_DOT Si se establece, CPSUI incluye tres puntos (...) después de la cadena de nombre del botón (pName en OPTITEM).

BegCtrlID
Si pDlgPage en COMPROPSHEETUI identifica una página proporcionada por CPSUI o si DlgTemplateID en DLGPAGE identifica una plantilla proporcionada por CPSUI, no se usa BegCtrlID . De lo contrario, BegCtrlID debe contener el primer identificador de control de un conjunto numerado secuencialmente de identificadores de control. Los identificadores de control deben identificar los siguientes controles de Windows:

Identificador de control Windows Control
Contenido de BegCtrlID Cuadro de grupo
Contenido de BegCtrlID +1 Texto del título
Contenido de BegCtrlID +2 Cuadro de botón de inserción
Contenido de BegCtrlID +3 Icono de botón de inserción
Contenido de BegCtrlID +4 Casilla extendida o botón de inserción extendido (opcional)
Contenido de BegCtrlID +5 Casilla extendida o icono de botón de inserción extendido (opcional)

Para obtener más información, consulte Personalización de controles de ventana de CPSUI-Supported.

Requisitos

Encabezado: compstui.h (incluya Compstui.h)

Consulte también

OPTITEM

OPTPARAM

OPTTYPE