Funkcje wywołania zwrotnego używane przez MFC

W bibliotece klas programu Microsoft Foundation są wyświetlane trzy funkcje wywołania zwrotnego. Te funkcje wywołania zwrotnego są przekazywane do obiektów CDC::EnumObjects, CDC::GrayString i CDC::SetAbortProc. Należy pamiętać, że wszystkie funkcje wywołania zwrotnego muszą wychwycić wyjątki MFC przed powrotem do systemu Windows, ponieważ wyjątki nie mogą być zgłaszane przez granice wywołania zwrotnego. Aby uzyskać więcej informacji na temat wyjątków, zobacz artykuł Wyjątki.

Funkcja wywołania zwrotnego dla CDC::EnumObjects
Funkcja wywołania zwrotnego dla CDC::GrayString
Funkcja wywołania zwrotnego dla CDC::SetAbortProc

Wymagania

Nagłówek: afxwin.h

Funkcja wywołania zwrotnego dla CDC::EnumObjects

Nazwa ObjectFunc jest symbolem zastępczym nazwy funkcji dostarczonej przez aplikację.

Składnia

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

Parametry

lpszLogObject
Wskazuje strukturę danych LOGPEN lub LOGBRUSH zawierającą informacje o atrybutach logicznych obiektu.

lpData
Wskazuje dane dostarczone przez aplikację EnumObjects przekazane do funkcji.

Wartość zwracana

Funkcja wywołania zwrotnego zwraca wartość int. Wartość tego zwracania jest zdefiniowana przez użytkownika. Jeśli funkcja wywołania zwrotnego zwróci wartość 0, EnumObjects zatrzymuje wyliczenie wcześnie.

Uwagi

Należy wyeksportować rzeczywistą nazwę.

Funkcja wywołania zwrotnego dla CDC::GrayString

OutputFunc jest symbolem zastępczym nazwy funkcji wywołania zwrotnego dostarczonej przez aplikację.

Składnia

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

Parametry

hDC
Identyfikuje kontekst urządzenia pamięci z mapą bitową o co najmniej szerokości i wysokości określonej przez nWidth i nHeight do GrayString.

lpData
Wskazuje ciąg znaków do rysowania.

nCount
Określa liczbę znaków do danych wyjściowych.

Wartość zwracana

Wartość zwracana funkcji wywołania zwrotnego musi mieć wartość TRUE, aby wskazać powodzenie; w przeciwnym razie jest to FAŁSZ.

Uwagi

Funkcja wywołania zwrotnego (OutputFunc) musi narysować obraz względem współrzędnych (0,0), a nie (x, y).

Funkcja wywołania zwrotnego dla CDC::SetAbortProc

Nazwa AbortFunc jest symbolem zastępczym nazwy funkcji dostarczonej przez aplikację.

Składnia

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

Parametry

hPr
Identyfikuje kontekst urządzenia.

kod
Określa, czy wystąpił błąd. Wartość 0 jest 0, jeśli wystąpił błąd. Jest to SP_OUTOFDISK, jeśli Menedżer wydruku jest obecnie poza miejscem na dysku, a więcej miejsca na dysku stanie się dostępne, jeśli aplikacja czeka. Jeśli kod jest SP_OUTOFDISK, aplikacja nie musi przerwać zadania drukowania. Jeśli tak nie jest, musi zwrócić się do Menedżera wydruku przez wywołanie PeekMessage funkcji lub GetMessage Windows.

Wartość zwracana

Wartość zwracana funkcji obsługi abort-handler jest niezerowa, jeśli zadanie drukowania ma być kontynuowane, a 0, jeśli zostało anulowane.

Uwagi

Rzeczywista nazwa musi zostać wyeksportowana zgodnie z opisem w sekcji Uwagi CDC ::SetAbortProc.

Zobacz też

Struktury, style, wywołania zwrotne i mapy komunikatów
CDC::EnumObjects
CDC::SetAbortProc
CDC::GrayString