Funzioni di callback utilizzate da MFC

  • Articolo

Nella libreria di classi Microsoft Foundation vengono visualizzate tre funzioni di callback. Queste funzioni di callback vengono passate a CDC::EnumObjects, CDC::GrayString e CDC::SetAbortProc. Si noti che tutte le funzioni di callback devono intercettare le eccezioni MFC prima di tornare a Windows, perché le eccezioni non possono essere generate attraverso i limiti di callback. Per altre informazioni sulle eccezioni, vedere l'articolo Eccezioni.

Funzione di callback per CDC::EnumObjects
Funzione di callback per CDC::GrayString
Funzione di callback per CDC::SetAbortProc

Requisiti

Intestazione: afxwin.h

Funzione di callback per CDC::EnumObjects

Il nome ObjectFunc è un segnaposto per il nome della funzione fornita dall'applicazione.

Sintassi

int CALLBACK EXPORT ObjectFunc(
    LPSTR lpszLogObject,
    LPSTR* lpData);

Parametri

lpszLogObject
Punta a una struttura di dati LOGPEN o LOGBRUSH che contiene informazioni sugli attributi logici dell'oggetto.

lpData
Punta ai dati forniti dall'applicazione passati alla funzione EnumObjects.

Valore restituito

La funzione di callback restituisce un oggetto int. Il valore di questa restituzione è definito dall'utente. Se la funzione di callback restituisce 0, EnumObjects arresta l'enumerazione prima.

Osservazioni:

Il nome effettivo deve essere esportato.

Funzione di callback per CDC::GrayString

OutputFunc è un segnaposto per il nome della funzione di callback fornita dall'applicazione.

Sintassi

BOOL CALLBACK EXPORT OutputFunc(
    HDC hDC,
    LPARAM lpData,
    int nCount);

Parametri

hDC
Identifica un contesto di dispositivo di memoria con una bitmap di almeno la larghezza e l'altezza specificate da nWidth e nHeight a GrayString.

lpData
Punta alla stringa di caratteri da tracciare.

nCount
Specifica il numero di caratteri da restituire.

Valore restituito

Il valore restituito della funzione di callback deve essere TRUE per indicare l'esito positivo; in caso contrario, è FALSE.

Osservazioni:

La funzione di callback (OutputFunc) deve disegnare un'immagine rispetto alle coordinate (0,0) anziché (x, y).

Funzione di callback per CDC::SetAbortProc

Il nome AbortFunc è un segnaposto per il nome della funzione fornita dall'applicazione.

Sintassi

BOOL CALLBACK EXPORT AbortFunc(
    HDC hPr,
    int code);

Parametri

hPr
Identifica il contesto del dispositivo.

code
Specifica se si è verificato un errore. È 0 se non si è verificato alcun errore. È SP_OUTOFDISK se Gestione stampa è attualmente fuori spazio su disco e lo spazio su disco diventa disponibile se l'applicazione attende. Se il codice è SP_OUTOFDISK, l'applicazione non deve interrompere il processo di stampa. In caso contrario, deve restituire a Print Manager chiamando la PeekMessage funzione o GetMessage Windows.

Valore restituito

Il valore restituito della funzione del gestore di interruzione è diverso da zero se il processo di stampa deve continuare e 0 se viene annullato.

Osservazioni:

Il nome effettivo deve essere esportato come descritto nella sezione Osservazioni di CDC::SetAbortProc.

Vedi anche

Strutture, stili, callback e mappe messaggi
CDC::EnumObjects
CDC::SetAbortProc
CDC::GrayString