_CPSUICALLBACK funzione di callback (compstui.h)

Il tipo di funzione _CPSUICALLBACK viene usato dalle applicazioni CPSUI (incluse le DLL dell'interfaccia della stampante) per definire una funzione di callback destinata all'uso come gestore messaggi CPSUI .

Sintassi

_CPSUICALLBACK Cpsuicallback;

LONG Cpsuicallback(
  PCPSUICBPARAM pCPSUICBParam
)
{...}

Parametri

pCPSUICBParam

Puntatore fornito da CPSUI a una strutturaCPSUICBPARAM.

Valore restituito

Una funzione di callback tipizzata _CPSUICALLBACK deve restituire uno dei valori elencati nella tabella seguente. Ogni valore indica un'azione che deve essere eseguita da CPSUI.

Codice restituito	Descrizione
CPSUICB_ACTION_ITEMS_APPLIED	Il membro CPSUICBPARAM struttura Reason è stato impostato su CPSUICB_REASON_APPLYNOW e la funzione di callback ha elaborato correttamente i valori delle opzioni correnti.
CPSUICB_ACTION_NO_APPLY_EXIT	Il membro Reason della struttura CPSUICBPARA M è stato impostato su CPSUICB_REASON_APPLYNOW, ma la funzione di callback ha rilevato valori di opzione non validi o incompatibili. La funzione di callback deve visualizzare una finestra di dialogo che informa l'utente del problema.
CPSUICB_ACTION_NONE	Non è necessaria alcuna azione da CPSUI.
CPSUICB_ACTION_OPTIF_CHANGED	La funzione di callback ha impostato il flag OPTIF_CHANGED in una struttura OPTITEM per indicare che l'opzione selezionata è stata modificata o che è stato modificato un altro flag con prefisso OPTIF.
CPSUICB_ACTION_REINIT_ITEMS	La funzione di callback ha impostato il flag di OPTIF_CHANGED in una struttura di OPTITEM per indicare che Flag o membri del OPTTYPE associato o struttura OPTPARAM.

Osservazioni

Le funzioni di callback specificate utilizzando il tipo di funzione _CPSUICALLBACK vengono fornite dalle applicazioni che usano CPSUI per gestire le pagine della finestra delle proprietà. Se una di queste funzioni di callback è associata a una pagina della finestra delle proprietà, CPSUI lo chiama quando viene rilevata l'attività dell'utente, ad esempio la modifica dello stato attivo del controllo della pagina, la modifica dei valori delle opzioni o la scelta di OK).

Una funzione di callback tipizzata _CPSUICALLBACK viene assegnata a una pagina della finestra delle proprietà includendo il relativo indirizzo in una strutturaCOMPROPSHEETUI, che viene passata alla funzione ComPropSheet di CPSUI quando il codice della funzione è CPSFUNC_ADD_PCOMPROPSHEETUI.

Inoltre, le funzioni di callback possono essere assegnate ai pulsanti push estesi tramite l'uso di strutture EXTPUSH.

Quando viene chiamata una di queste funzioni di callback, riceve un puntatore a una struttura CPSUICBPARAM. Questa struttura descrive le impostazioni di opzione correnti per la pagina e indica l'evento utente che ha causato la chiamata della funzione. La funzione di callback è responsabile della convalida e dell'elaborazione delle impostazioni. Dovrebbe essere visualizzata una finestra di dialogo se un'impostazione (o una combinazione di impostazioni) non è valida. Il valore restituito della funzione indica a CPSUI se la pagina deve essere rivisualizzata o reinizializzata.

Le funzioni di callback specificate con questo tipo di funzione non possono essere utilizzate se il membro DlgProc della struttura DLGPAGE specifica una routine della finestra di dialogo fornita dall'applicazione. Ciò è dovuto al fatto che i callback tipizzato _CPSUICALLBACK vengono chiamati dalle procedure della finestra di dialogo CPSUI, che non vengono usate se l'applicazione fornisce le proprie procedure.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Desktop
intestazione	compstui.h (include Compstui.h)