Condividi tramite


_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 di messaggi CPSUI.

Sintassi

_CPSUICALLBACK Cpsuicallback;

LONG Cpsuicallback(
  PCPSUICBPARAM pCPSUICBParam
)
{...}

Parametri

pCPSUICBParam

Puntatore fornito da CPSUI a una struttura CPSUICBPARAM .

Valore restituito

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

Codice restituito Descrizione
CPSUICB_ACTION_ITEMS_APPLIED Il membro della struttura CPSUICBPARAM è 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 Motivodella struttura CPSUICBPARAM è 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 indica all'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 un altro flag con prefisso OPTIF è cambiato.
CPSUICB_ACTION_REINIT_ITEMS La funzione di callback ha impostato il flag OPTIF_CHANGED in una struttura OPTITEM per indicare che i membri Flag o pData della struttura OPTPARAM o OPTPARAM associati sono stati modificati.

Commenti

Le funzioni di callback specificate usando il tipo di funzione _CPSUICALLBACK vengono fornite dalle applicazioni che usano CPSUI per gestire le pagine del foglio delle proprietà. Se una di queste funzioni di callback è associata a una pagina del foglio 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 il clic su OK.

Una funzione di callback _CPSUICALLBACK tipizzata viene assegnata a una pagina del foglio delle proprietà, incluso il relativo indirizzo in una struttura COMPROPSHEETUI , 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 una di queste funzioni di callback viene chiamata, 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 alla 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 ricreata o reinizializzata.

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

Requisiti

Requisito Valore
Piattaforma di destinazione Desktop
Intestazione compstui.h (include Compstui.h)