Condividi tramite


TVOT_PUSHBUTTON

Importante

La piattaforma di stampa moderna è il mezzo preferito di Windows per comunicare con le stampanti. Ti consigliamo di usare il driver di classe IPP di Microsoft, insieme a Print Support Apps (PSA), per personalizzare l'esperienza di stampa in Windows 10 e 11 per lo sviluppo di dispositivi per stampanti.

Per altre informazioni, vedere Piattaforma di stampa moderna e guida alla progettazione dell'app di supporto per la stampa.

Il tipo di opzione TVOT_PUSHBUTTON è costituito da un pulsante di scelta all'interno di una casella di gruppo.

Struttura OPTITEM

Sel/pSel
Dipende dal membro Style della struttura OPTPARAM, come indicato di seguito.

Stile pulsante di selezione Utilizzo di Sel/pSel
PUSHBUTTON_TYPE_CALLBACK Non utilizzato.
PUSHBUTTON_TYPE_DLGPROC CPSUI archivia il valore restituito della routine della finestra di dialogo.
PUSHBUTTON_TYPE_HTCLRADJ CPSUI archivia il valore restituito dell'operazione di halftoning.
PUSHBUTTON_TYPE_HTSETUP CPSUI archivia il valore restituito dell'operazione di halftoning.

Matrice di strutture OPTPARAM (membro pOptParam di OPTTYPE)

pData
Dipende dal membro Style , come indicato di seguito.

Stile pulsante di selezione Utilizzo di pData
PUSHBUTTON_TYPE_CALLBACK Puntatore a una funzione tipizzata _CPSUICALLBACK.
PUSHBUTTON_TYPE_DLGPROC Puntatore tipizzato DLGPROC a una procedura di finestra di dialogo (vedere la documentazione di Microsoft Windows SDK).
PUSHBUTTON_TYPE_HTCLRADJ Puntatore alla struttura COLORADJUSTMENT (descritta nella documentazione di Windows SDK).
PUSHBUTTON_TYPE_HTSETUP Puntatore a una struttura DEVHTADJDATA.

IconID
Identifica un'icona da associare al pulsante di pressione.

lParam Dipende dal membro Style , come indicato di seguito.

Stile pulsante di selezione Utilizzo di lParam
PUSHBUTTON_TYPE_CALLBACK Non utilizzato.
PUSHBUTTON_TYPE_DLGPROC Identificatore di risorsa per una risorsa DIALOG o handle per una struttura DLGTEMPLATE (vedere la documentazione di Windows SDK). Dipende dal flag DPF_USE_HDLGTEMPLATE nel membro Flags della struttura OPTPARAM.
PUSHBUTTON_TYPE_HTCLRADJ Non utilizzato.
PUSHBUTTON_TYPE_HTSETUP Non utilizzato.
Termine Descrizione
Stile Specifica l'operazione da eseguire da CPSUI quando un utente fa clic sul pulsante di pressione. I possibili valori sono i seguenti:
PUSHBUTTON_TYPE_CALLBACK CPSUI chiama la funzione di callback _CPSUICALLBACK tipizzata dell'applicazione per gestire gli eventi dei pulsanti, con il membro Reason della struttura CPSUICBPARAM impostato su CPSUICB_REASON_PUSHBUTTON. CPSUI ignora il valore restituito della funzione di callback.
PUSHBUTTON_TYPE_DLGPROC La routine della finestra di dialogo dell'applicazione gestisce gli eventi del pulsante. Per altre informazioni, vedere Sezione Osservazioni per DLGPAGE. Quando la funzione riceve un messaggio di WM_INITDIALOG, il relativo argomento lParam punta a una struttura CPSUICBPARAM con il membro Reason impostato su CPSUICB_REASON_DLGPROC.
PUSHBUTTON_TYPE_HTCLRADJ CPSUI visualizza una finestra di dialogo di regolazione del colore a metàtone.
PUSHBUTTON_TYPE_HTSETUP CPSUI visualizza una finestra di dialogo di configurazione halftone del dispositivo.

Struttura OPTTYPE

Tipo TVOT_PUSHBUTTON

Conteggio 1

Style È possibile specificare i flag di bit facoltativi seguenti.

Flag Descrizione
OTS_PUSH_ENABLE_ALWAYS Se impostato, il pulsante di pressione è sempre abilitato, anche se l'utente non può modificare la pagina della finestra delle proprietà, ovvero se CPSUIF_UPDATE_PERMISSION non è impostata in una struttura COMPROPSHEETUI.

La funzione di callback del pulsante di pressione deve visualizzarne la finestra di dialogo, ma non deve consentire modifiche dell'utente.

Si noti che è necessario impostare anche questo flag nel membro Flags della struttura OPTTYPE .
OTS_PUSH_INCL_SETUP_TITLE Se impostato, CPSUI include la parola "Setup" dopo la stringa del nome del pulsante (pName in OPTITEM).
OTS_PUSH_NO_DOT_DOT_DOT Se impostato, CPSUI include tre punti (...) dopo la stringa del nome del pulsante (pName in OPTITEM).

BegCtrlID
Se pDlgPage in COMPROPSHEETUI identifica una pagina fornita da CPSUI o se DlgTemplateID in DLGPAGE identifica un modello fornito da CPSUI, BegCtrlID non viene utilizzato. In caso contrario, BegCtrlID deve contenere il primo identificatore di controllo di un set numerato sequenziale di identificatori di controllo. Gli identificatori di controllo devono identificare i controlli Di Windows seguenti:

Identificatore di controllo Controllo Windows
Contenuto di BegCtrlID Casella di gruppo
Contenuto di BegCtrlID +1 Testo titolo
Contenuto di BegCtrlID +2 Casella pulsante di selezione
Contenuto di BegCtrlID +3 Icona pulsante di selezione
Contenuto di BegCtrlID +4 Casella di controllo estesa o pulsante di scelta estesa (facoltativo)
Contenuto di BegCtrlID +5 Casella di controllo estesa o icona del pulsante di scelta estesa (facoltativo)

Per altre informazioni, vedere Personalizzazione dei controlli finestra supportati da CPSUI.

Requisiti

Intestazione: compstui.h (include Compstui.h)

Vedi anche

OPTITEM

OPTPARAM

OPTTYPE