Callback-functies die door MFC worden gebruikt

Opmerking

De Microsoft Foundation Classes-bibliotheek (MFC) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.

Er worden drie callback-functies weergegeven in de Microsoft Foundation Class Library. Deze callback-functies worden doorgegeven aan CDC::EnumObjects, CDC::GrayString en CDC::SetAbortProc. Houd er rekening mee dat alle callback-functies MFC-uitzonderingen moeten ondervangen voordat ze terugkeren naar Windows, omdat er geen uitzonderingen kunnen worden gegenereerd binnen callback-grenzen. Zie het artikel Uitzonderingen voor meer informatie over uitzonderingen.

Callback-functie voor CDC::EnumObjects
Callback-functie voor CDC::GrayString
Callback-functie voor CDC::SetAbortProc

Requirements

Koptekst: afxwin.h

Callback-functie voor CDC::EnumObjects

De ObjectFunc-naam is een tijdelijke aanduiding voor de door de toepassing opgegeven functienaam.

Syntaxis

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

Parameterwaarden

lpszLogObject
Verwijst naar een LOGPEN - of LOGBRUSH-gegevensstructuur die informatie bevat over de logische kenmerken van het object.

lpData
Verwijst naar de door de toepassing geleverde gegevens die aan de EnumObjects functie zijn doorgegeven.

Retourwaarde

De callback-functie retourneert een int. De waarde van deze retour is door de gebruiker gedefinieerd. Als de callback-functie 0 retourneert, EnumObjects stopt u de opsomming vroeg.

Opmerkingen

De werkelijke naam moet worden geëxporteerd.

Callback-functie voor CDC::GrayString

OutputFunc is een tijdelijke aanduiding voor de naam van de door de toepassing geleverde callback-functie.

Syntaxis

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

Parameterwaarden

Hdc
Identificeert een geheugenapparaatcontext met een bitmap van ten minste de breedte en hoogte die is opgegeven door nWidth en nHeight aan GrayString.

lpData
Verwijst naar de tekenreeks die moet worden getekend.

nCount
Hiermee geeft u het aantal tekens dat moet worden uitgevoerd.

Retourwaarde

De retourwaarde van de callback-functie moet WAAR zijn om aan te geven dat de functie is geslaagd; anders is het ONWAAR.

Opmerkingen

De callback-functie (OutputFunc) moet een afbeelding tekenen ten opzichte van de coördinaten (0,0) in plaats van (x, y).

Callback-functie voor CDC::SetAbortProc

De naam AbortFunc is een tijdelijke aanduiding voor de door de toepassing opgegeven functienaam.

Syntaxis

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

Parameterwaarden

hPr
Identificeert de apparaatcontext.

code
Hiermee geeft u op of er een fout is opgetreden. Dit is 0 als er geen fout is opgetreden. Het is SP_OUTOFDISK als printbeheer momenteel geen schijfruimte meer heeft en er meer schijfruimte beschikbaar komt als de toepassing wacht. Als code is SP_OUTOFDISK, hoeft de toepassing de afdruktaak niet af te breken. Als dit niet het geval is, moet deze naar het afdrukbeheer gaan door de PeekMessage functie Of GetMessage Windows aan te roepen.

Retourwaarde

De retourwaarde van de functie abort-handler is niet nul als de afdruktaak moet worden voortgezet en 0 als deze wordt geannuleerd.

Opmerkingen

De werkelijke naam moet worden geëxporteerd zoals beschreven in de sectie Opmerkingen van CDC::SetAbortProc.

Zie ook

Structuren, stijlen, callbacks en berichttoewijzingen
CDC::EnumObjects
CDC::SetAbortProc
CDC::GrayString