TVOT_PUSHBUTTON
Importante
La plataforma de impresión moderna es el medio preferido de Windows para comunicarse con impresoras. Se recomienda usar el controlador de clase de bandeja de entrada IPP de Microsoft, junto con 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 Plataforma de impresión moderna y la Guía de diseño de aplicaciones para compatibilidad con impresión.
El tipo de opción TVOT_PUSHBUTTON consiste en un botón pulsador 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 del pulsador | Uso de Sel/pSel |
|---|---|
| PUSHBUTTON_TYPE_CALLBACK | No utilizado. |
| PUSHBUTTON_TYPE_DLGPROC | CPSUI almacena el valor de retorno del procedimiento del cuadro de diálogo. |
| PUSHBUTTON_TYPE_HTCLRADJ | CPSUI almacena el valor de retorno de la operación de tramado. |
| PUSHBUTTON_TYPE_HTSETUP | CPSUI almacena el valor de retorno de la operación de tramado. |
Estructura OPTPARAM (miembro pOptParam de OPTTYPE)
pData
Depende del miembro Style, como sigue.
| Estilo del pulsador | Uso de pData |
|---|---|
| PUSHBUTTON_TYPE_CALLBACK | Puntero a una función _CPSUICALLBACK. |
| PUSHBUTTON_TYPE_DLGPROC | Puntero DLGPROC a un procedimiento de cuadro de diálogo (consulte la documentación del SDK de Microsoft Windows). |
| PUSHBUTTON_TYPE_HTCLRADJ | Puntero a una estructura COLORADJUSTMENT (descrita en la documentación del SDK de Windows). |
| PUSHBUTTON_TYPE_HTSETUP | Puntero a una estructura DEVHTADJDATA. |
IconID
Identifica un icono que se asociará al pulsador.
lParam Depende del miembro Style, como se indica a continuación.
| Estilo del pulsador | Uso de lParam |
|---|---|
| PUSHBUTTON_TYPE_CALLBACK | No utilizado. |
| PUSHBUTTON_TYPE_DLGPROC | Identificador de recurso para un recurso DIALOG, o handle a una estructura DLGTEMPLATE (consulte la documentación del SDK de Windows). Depende del indicador DPF_USE_HDLGTEMPLATE del miembro Marcas de la estructura OPTPARAM. |
| PUSHBUTTON_TYPE_HTCLRADJ | No utilizado. |
| PUSHBUTTON_TYPE_HTSETUP | No utilizado. |
| Término | Descripción |
|---|---|
| Estilo | Especifica la operación a realizar por CPSUI cuando un usuario pulsa el botón. Puede ser uno de los siguientes valores: |
| PUSHBUTTON_TYPE_CALLBACK | CPSUI llama a la función de callback _CPSUICALLBACK de la aplicación para manejar eventos de botón, con el miembro Reason de la estructura CPSUICBPARAM establecido a CPSUICB_REASON_PUSHBUTTON. (CPSUI omite el valor devuelto de la función de devolución de llamada). |
| PUSHBUTTON_TYPE_DLGPROC | El procedimiento de cuadro de diálogo de la aplicación maneja los eventos de botón. (Para más información, consulte la sección Observaciones para DLGPAGE). Cuando la función recibe un mensaje WM_INITDIALOG, su argumento lParam apunta a una estructura CPSUICBPARAM con el miembro Reason establecido a CPSUICB_REASON_DLGPROC. |
| PUSHBUTTON_TYPE_HTCLRADJ | CPSUI muestra una caja de dialogo de ajuste de color de medios tonos. |
| PUSHBUTTON_TYPE_HTSETUP | CPSUI muestra un cuadro de diálogo de ajuste de medios tonos del dispositivo. |
Estructura OPTTYPE
Tipo TVOT_PUSHBUTTON
Cuenta 1
Estilo Se pueden especificar los siguientes indicadores de bits opcionales.
| Marca | Descripción |
|---|---|
| OTS_PUSH_ENABLE_ALWAYS | Si se establece, el botón pulsador siempre está habilitado, incluso si el usuario no puede modificar la página de la hoja de propiedades (es decir, incluso si CPSUIF_UPDATE_PERMISSION no está establecido en una estructura COMPROPSHEETUI). La función de devolución de llamada del botón pulsador debe mostrar su cuadro de diálogo, pero no debe permitir modificaciones por parte del usuario. Tenga en cuenta que también debe establecer este indicador en el miembro Marcas 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 suministrada por CPSUI, o si DlgTemplateID en DLGPAGE identifica una plantilla suministrada por CPSUI, BegCtrlID no se usa. De lo contrario, BegCtrlID debe contener el primer identificador de control de un conjunto de identificadores de control numerados secuencialmente. Los identificadores de control deben identificar los siguientes controles de Windows:
| Identificador de control | Control de Windows |
|---|---|
| Contenido de BegCtrlID | Cuadro de grupo |
| Contenido de BegCtrlID+1 | Título del texto |
| Contenido de BegCtrlID+2 | Caja de pulsadores |
| Contenido de BegCtrlID+3 | Icono de pulsador |
| Contenido de BegCtrlID+4 | Casilla de verificación extendida o botón pulsador extendido (opcional) |
| Contenido de BegCtrlID+5 | Icono de casilla de verificación extendida o botón pulsador extendido (opcional) |
Para información adicional, consulte Personalizar Controles de Ventana soportados por CPSUI.
Requisitos
Encabezado: compstui.h (incluye Compstui.h)