Von MFC verwendete Rückruffunktionen

  • Artikel

In der Microsoft Foundation-Klassenbibliothek werden drei Rückruffunktionen angezeigt. Diese Rückruffunktionen werden an CDC::EnumObjects, CDC::GrayString und CDC::SetAbortProc übergeben. Beachten Sie, dass alle Rückruffunktionen MFC-Ausnahmen abfangen müssen, bevor sie zu Windows zurückkehren, da Ausnahmen nicht über Rückrufgrenzen hinweg ausgelöst werden können. Weitere Informationen zu Ausnahmen finden Sie im Artikel "Ausnahmen".

Rückruffunktion für CDC::EnumObjects
Rückruffunktion für CDC::GrayString
Rückruffunktion für CDC::SetAbortProc

Anforderungen

Header: afxwin.h

Rückruffunktion für CDC::EnumObjects

Der ObjectFunc-Name ist ein Platzhalter für den von der Anwendung bereitgestellten Funktionsnamen.

Syntax

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

Parameter

lpszLogObject
Verweist auf eine LOGPEN - oder LOGBRUSH-Datenstruktur , die Informationen zu den logischen Attributen des Objekts enthält.

lpData
Verweist auf die von der Anwendung bereitgestellten Daten, die an die EnumObjects Funktion übergeben werden.

Rückgabewert

Die Rückruffunktion gibt eine int. Der Wert dieser Rückgabe ist benutzerdefinierter Wert. Wenn die Rückruffunktion 0 zurückgibt, EnumObjects stoppt die Aufzählung frühzeitig.

Hinweise

Der tatsächliche Name muss exportiert werden.

Rückruffunktion für CDC::GrayString

OutputFunc ist ein Platzhalter für den vom Anwendung bereitgestellten Rückruffunktionsnamen.

Syntax

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

Parameter

hDC
Identifiziert einen Speichergerätekontext mit einer Bitmap mit mindestens der durch und nHeight bis GrayStringangegebenen nWidth Breite und Höhe.

lpData
Zeigt auf die zu zeichnende Zeichenfolge.

nCount
Gibt die Anzahl der auszuzugebenden Zeichen an.

Rückgabewert

Der Rückgabewert der Rückruffunktion muss WAHR sein, um den Erfolg anzuzeigen. andernfalls ist es FALSE.

Hinweise

Die Rückruffunktion (OutputFunc) muss ein Bild relativ zu den Koordinaten (0,0) und nicht (x, y) zeichnen.

Rückruffunktion für CDC::SetAbortProc

Der Name "AbortFunc " ist ein Platzhalter für den von der Anwendung bereitgestellten Funktionsnamen.

Syntax

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

Parameter

hPr
Identifiziert den Gerätekontext.

code
Gibt an, ob ein Fehler aufgetreten ist. Es ist 0, wenn kein Fehler aufgetreten ist. Es ist SP_OUTOFDISK, wenn der Druck-Manager zurzeit nicht genügend Speicherplatz hat und mehr Speicherplatz verfügbar wird, wenn die Anwendung wartet. Wenn Code SP_OUTOFDISK ist, muss die Anwendung den Druckauftrag nicht abbrechen. Wenn dies nicht der Fall ist, muss sie dem Druck-Manager durch Aufrufen der PeekMessage Funktion oder GetMessage Der Windows-Funktion zuweisen.

Rückgabewert

Der Rückgabewert der Abort-Handler-Funktion ist nicht null, wenn der Druckauftrag fortgesetzt werden soll, und 0, wenn er abgebrochen wird.

Hinweise

Der tatsächliche Name muss exportiert werden, wie im Abschnitt "Anmerkungen" von CDC::SetAbortProc beschrieben.

Siehe auch

Strukturen, Stile, Rückrufe und Meldungszuordnungen
CDC::EnumObjects
CDC::SetAbortProc
CDC::GrayString