Fonctions de rappel utilisées par MFC

  • Article

Trois fonctions de rappel apparaissent dans la bibliothèque de classes Microsoft Foundation. Ces fonctions de rappel sont passées à CDC ::EnumObjects, CDC ::GrayString et CDC ::SetAbortProc. Notez que toutes les fonctions de rappel doivent intercepter les exceptions MFC avant de revenir à Windows, car les exceptions ne peuvent pas être levées entre les limites de rappel. Pour plus d’informations sur les exceptions, consultez l’article Exceptions.

Fonction de rappel pour CDC::EnumObjects
Fonction de rappel pour CDC::GrayString
Fonction de rappel pour CDC::SetAbortProc

Spécifications

En-tête : afxwin.h

Fonction de rappel pour CDC::EnumObjects

Le nom ObjectFunc est un espace réservé pour le nom de la fonction fournie par l’application.

Syntaxe

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

Paramètres

lpszLogObject
Pointe vers une structure de données LOGPEN ou LOGBRUSH qui contient des informations sur les attributs logiques de l’objet.

lpData
Pointe vers les données fournies par l’application transmises à la EnumObjects fonction.

Valeur de retour

La fonction de rappel retourne un int. La valeur de ce retour est définie par l’utilisateur. Si la fonction de rappel retourne 0, EnumObjects arrête l’énumération tôt.

Notes

Le nom réel doit être exporté.

Fonction de rappel pour CDC::GrayString

OutputFunc est un espace réservé pour le nom de la fonction de rappel fournie par l’application.

Syntaxe

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

Paramètres

hDC
Identifie un contexte d’appareil mémoire avec une bitmap d’au moins la largeur et la hauteur spécifiées par nWidth et nHeight vers GrayString.

lpData
Pointe vers la chaîne de caractères à ajouter.

nCount
Spécifie le nombre de caractères à générer.

Valeur de retour

La valeur de retour de la fonction de rappel doit être TRUE pour indiquer la réussite ; sinon, il s’agit de FALSE.

Notes

La fonction de rappel (OutputFunc) doit dessiner une image par rapport aux coordonnées (0,0) plutôt que (x, y).

Fonction de rappel pour CDC::SetAbortProc

Le nom AbortFunc est un espace réservé pour le nom de la fonction fournie par l’application.

Syntaxe

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

Paramètres

hPr
Identifie le contexte de l’appareil.

code
Spécifie si une erreur s’est produite. Il s’agit de 0 si aucune erreur n’a eu lieu. Il est SP_OUTOFDISK si le Gestionnaire d’impression est actuellement hors de l’espace disque et qu’un plus grand espace disque sera disponible si l’application attend. Si le code est SP_OUTOFDISK, l’application n’a pas besoin d’abandonner la tâche d’impression. Si ce n’est pas le cas, elle doit être remise au Gestionnaire d’impression en appelant la fonction Windows ou GetMessage la PeekMessage fonction Windows.

Valeur de retour

La valeur de retour de la fonction abort-handler n’est pas nulle si le travail d’impression doit continuer, et 0 s’il est annulé.

Notes

Le nom réel doit être exporté comme décrit dans la section Notes de CDC ::SetAbortProc.

Voir aussi

Structures, styles, rappels et tables de messages
CDC ::EnumObjects
CDC ::SetAbortProc
CDC ::GrayString