TVOT_PUSHBUTTON

Artigo
03/08/2023

Importante

Recomendamos que você use o driver de classe de caixa de entrada IPP da Microsoft, juntamente com aplicativos de suporte de impressão (PSA), para personalizar a experiência de impressão em Windows 10 e 11 para o desenvolvimento de dispositivos de impressora.

Para obter mais informações, consulte o Guia de design do aplicativo de suporte de impressão.

O tipo de opção TVOT_PUSHBUTTON consiste em um botão de push 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 push	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 halftoning.
PUSHBUTTON_TYPE_HTSETUP	O CPSUI armazena o valor retornado da operação de halftoning.

Matriz de estrutura OPTPARAM (membro pOptParam de OPTTYPE)

pData
Depende do membro Style , da seguinte maneira.

Estilo de botão de push	uso de pData
PUSHBUTTON_TYPE_CALLBACK	Ponteiro para uma função do tipo _CPSUICALLBACK.
PUSHBUTTON_TYPE_DLGPROC	Ponteiro do tipo DLGPROC para um procedimento de caixa de diálogo (consulte a documentação 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 push.

Lparam Depende do membro Style , da seguinte maneira.

Estilo de botão de push	Uso de 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 de push. 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 manipular eventos de botão, com o membro Reason 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 Comentários 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

Contagem 1

Estilo Os sinalizadores de bits opcionais a seguir podem ser especificados.

Sinalizador	Descrição
OTS_PUSH_ENABLE_ALWAYS	Se definido, o botão de push sempre estará 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, CPSUI inclui a palavra "Instalação" após a cadeia de caracteres de nome do botão (pName no OPTITEM).
OTS_PUSH_NO_DOT_DOT_DOT	Se definido, CPSUI inclui três pontos (...) após a cadeia de caracteres de nome do botão (pName no OPTITEM).

BegCtrlID
Se pDlgPage em COMPROPSHEETUI identificar uma página fornecida por CPSUI ou se DlgTemplateID em DLGPAGE identificar um modelo fornecido por CPSUI, BegCtrlID não será usado. Caso contrário, BegCtrlID deve conter o primeiro identificador de controle de um conjunto sequencialmente numerado de identificadores de controle. Os identificadores de controle devem identificar os seguintes controles do Windows:

Identificador de controle	Controle do Windows
Conteúdo begCtrlID	Caixa de grupo
Conteúdo begCtrlID +1	Texto do título
Conteúdo begCtrlID +2	Caixa de botão Push
Conteúdo begCtrlID +3	Ícone do botão Desativar
Conteúdo begCtrlID +4	Caixa de seleção estendida ou botão de push estendido (opcional)
Conteúdo begCtrlID +5	Caixa de seleção estendida ou ícone de botão de push estendido (opcional)