TVOT_PUSHBUTTON
Importante
A plataforma de impressão moderna é o meio preferencial do Windows para se comunicar com as impressoras. Recomendamos que você use o driver de classe de caixa de entrada IPP da Microsoft juntamente com PSA (Aplicativos de Suporte à Impressão) para personalizar a experiência de impressão no Windows 10 e 11 para o desenvolvimento de dispositivos de impressora.
Para obter mais informações, consulte Plataformade impressão moderna e o Guia de design do aplicativo de suporte de impressão.
O tipo de opção TVOT_PUSHBUTTON consiste em um botão dentro de uma caixa de grupo.
Estrutura OPTITEM
Sel/pSel
Depende do membro Style da estrutura OPTPARAM, da seguinte maneira.
| Estilo de botão de pressão | Uso de Sel/pSel |
|---|---|
| PUSHBUTTON_TYPE_CALLBACK | Não usado. |
| PUSHBUTTON_TYPE_DLGPROC | O CPSUI armazena o valor retornado do procedimento da caixa de diálogo. |
| PUSHBUTTON_TYPE_HTCLRADJ | O CPSUI armazena o valor retornado da operação de meio-tom. |
| PUSHBUTTON_TYPE_HTSETUP | O CPSUI armazena o valor retornado da operação de meio-tom. |
Matriz de estrutura OPTPARAM (membro pOptParam de OPTTYPE)
pData
Depende do membro Style, da seguinte maneira.
| Estilo de botão de pressão | Uso de pData |
|---|---|
| PUSHBUTTON_TYPE_CALLBACK | Ponteiro para uma função de tipo _CPSUICALLBACK. |
| PUSHBUTTON_TYPE_DLGPROC | Ponteiro do tipo DLGPROC para um procedimento de caixa de diálogo (consulte a documentação do SDK do Microsoft Windows). |
| PUSHBUTTON_TYPE_HTCLRADJ | Ponteiro para a estrutura COLORADJUSTMENT (descrita na documentação do SDK do Windows). |
| PUSHBUTTON_TYPE_HTSETUP | Ponteiro para uma estrutura DEVHTADJDATA. |
IconID
Identifica um ícone a ser associado ao botão de pressão.
lParam Depende do membro Style, da seguinte maneira.
| Estilo de botão de pressão | Uso do lParam |
|---|---|
| PUSHBUTTON_TYPE_CALLBACK | Não usado. |
| PUSHBUTTON_TYPE_DLGPROC | Identificador de recurso para um recurso DIALOG ou identificador para uma estrutura DLGTEMPLATE (consulte a documentação do SDK do Windows). Depende do sinalizador DPF_USE_HDLGTEMPLATE no membro Flags da estrutura OPTPARAM. |
| PUSHBUTTON_TYPE_HTCLRADJ | Não usado. |
| PUSHBUTTON_TYPE_HTSETUP | Não usado. |
| Termo | Descrição |
|---|---|
| Estilo | Especifica a operação a ser executada pelo CPSUI quando um usuário clica no botão. Pode ser um dos seguintes valores: |
| PUSHBUTTON_TYPE_CALLBACK | O CPSUI chama a função de retorno de chamada do tipo _CPSUICALLBACK do aplicativo para lidar com eventos de botão, com o membroReason da estrutura CPSUICBPARAM definido como CPSUICB_REASON_PUSHBUTTON. (CPSUI ignora o valor retornado da função de retorno de chamada.) |
| PUSHBUTTON_TYPE_DLGPROC | O procedimento da caixa de diálogo do aplicativo manipula eventos de botão. (Para obter mais informações, consulte a seção Remarks para DLGPAGE.) Quando a função recebe uma mensagem WM_INITDIALOG, seu argumento lParam aponta para uma estrutura CPSUICBPARAM com o membro Reason definido como CPSUICB_REASON_DLGPROC. |
| PUSHBUTTON_TYPE_HTCLRADJ | O CPSUI exibe uma caixa de diálogo de ajuste de cor de meio-tom. |
| PUSHBUTTON_TYPE_HTSETUP | O CPSUI exibe uma caixa de diálogo de configuração de meio-tom do dispositivo. |
Estrutura OPTTYPE
Tipo TVOT_PUSHBUTTON
Count 1
Style Os seguintes sinalizadores de bits opcionais podem ser especificados.
| Sinalizador | Descrição |
|---|---|
| OTS_PUSH_ENABLE_ALWAYS | Se definido, o botão de pressão está sempre habilitado, mesmo que o usuário não possa modificar a página da folha de propriedades (ou seja, mesmo que CPSUIF_UPDATE_PERMISSION não esteja definido em uma estrutura COMPROPSHEETUI). A função de retorno de chamada do botão de push deve exibir sua caixa de diálogo, mas não deve permitir modificações do usuário. Observe que você também deve definir esse sinalizador no membro Flags da estrutura OPTTYPE. |
| OTS_PUSH_INCL_SETUP_TITLE | Se definido, o CPSUI incluirá a palavra "Setup" após a cadeia de caracteres de nome do botão (pName em OPTITEM). |
| OTS_PUSH_NO_DOT_DOT_DOT | Se definido, o CPSUI incluirá três pontos (...) após a cadeia de caracteres de nome do botão (pName em OPTITEM). |
BegCtrlID
Se pDlgPage em COMPROPSHEETUI iidentificar uma página fornecida pelo CPSUI ou se DlgTemplateID em DLGPAGE identificar um modelo fornecido pelo CPSUI, BegCtrlID não será usado. Caso contrário, BegCtrlID deve conter o primeiro identificador de controle de um conjunto numerado sequencialmente de identificadores de controle. Os identificadores de controle devem identificar os seguintes controles do Windows:
| Identificador do controle | Controle do Windows |
|---|---|
| Conteúdo do BegCtrlID | Caixa de grupo |
| Conteúdo+1 do BegCtrlID | Texto do título |
| Conteúdo+2 do BegCtrlID | Caixa de botão de pressão |
| Conteúdo+3 do BegCtrlID | Ícone de botão de pressão |
| Conteúdo+4 do BegCtrlID | Caixa de seleção estendida ou botão estendido (opcional) |
| Conteúdo+5 do BegCtrlID | Caixa de seleção estendida ou ícone do botão estendido (opcional) |
Para obter mais informações, consulte Personalizando controles de janela com suporte para CPSUI.
Requisitos
Cabeçalho: compstui.h (incluir Compstui.h)