_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.

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