Klasa CPrintInfo

Przechowuje informacje o zadaniu drukowania lub drukowania w wersji zapoznawczej.

Składnia

struct CPrintInfo

Elementy członkowskie

Metody publiczne

Nazwa/nazwisko	opis
CPrintInfo::GetFromPage	Zwraca liczbę wydrukowanych pierwszych stron.
CPrintInfo::GetMaxPage	Zwraca liczbę ostatniej strony dokumentu.
CPrintInfo::GetMinPage	Zwraca liczbę pierwszej strony dokumentu.
CPrintInfo::GetOffsetPage	Zwraca liczbę stron poprzedzających pierwszą stronę elementu DocObject drukowanego w połączonym zadaniu drukowania obiektu DocObject.
CPrintInfo::GetToPage	Zwraca liczbę wydrukowanych ostatnio stron.
CPrintInfo::SetMaxPage	Ustawia liczbę ostatniej strony dokumentu.
CPrintInfo::SetMinPage	Ustawia liczbę pierwszej strony dokumentu.

Publiczne elementy członkowskie danych

Nazwa/nazwisko	opis
CPrintInfo::m_bContinuePrinting	Zawiera flagę wskazującą, czy struktura powinna kontynuować pętlę drukowania.
CPrintInfo::m_bDirect	Zawiera flagę wskazującą, czy dokument jest drukowany bezpośrednio (bez wyświetlania okna dialogowego Drukowanie).
CPrintInfo::m_bDocObject	Zawiera flagę wskazującą, czy drukowany dokument jest obiektem DocObject.
CPrintInfo::m_bPreview	Zawiera flagę wskazującą, czy dokument jest podgląd.
CPrintInfo::m_dwFlags	Określa operacje drukowania w obiekcie DocObject.
CPrintInfo::m_lpUserData	Zawiera wskaźnik do struktury utworzonej przez użytkownika.
CPrintInfo::m_nCurPage	Określa numer aktualnie drukowanej strony.
CPrintInfo::m_nJobNumber	Określa numer zadania przypisany przez system operacyjny dla bieżącego zadania drukowania
CPrintInfo::m_nNumPreviewPages	Określa liczbę stron wyświetlanych w oknie podglądu; 1 lub 2.
CPrintInfo::m_nOffsetPage	Określa przesunięcie pierwszej strony obiektu DocObject w połączonym zadaniu drukowania docObject.
CPrintInfo::m_pPD	Zawiera wskaźnik do obiektu używanego CPrintDialog w oknie dialogowym Drukowanie.
CPrintInfo::m_rectDraw	Określa prostokąt definiujący bieżący obszar strony do użytku.
CPrintInfo::m_strPageDesc	Zawiera ciąg formatu dla wyświetlania numeru strony.

Uwagi

CPrintInfo jest strukturą i nie ma klasy bazowej.

Struktura tworzy obiekt CPrintInfo za każdym razem, gdy jest wybierane polecenie Drukuj lub Podgląd wydruku i niszczy go po zakończeniu polecenia.

CPrintInfo Zawiera informacje o zadaniu drukowania jako całości, na przykład o zakresie stron do wydrukowania, oraz o bieżącym stanie zadania drukowania, takim jak aktualnie drukowana strona. Niektóre informacje są przechowywane w skojarzonym obiekcie CPrintDialog . Ten obiekt zawiera wartości wprowadzone przez użytkownika w oknie dialogowym Drukowanie.

CPrintInfo Obiekt jest przekazywany między strukturą a klasą widoków podczas procesu drukowania i służy do wymiany informacji między nimi. Na przykład struktura informuje klasę widoku, która strona dokumentu ma zostać wydrukowana, przypisując wartość do m_nCurPage elementu członkowskiego CPrintInfo; klasa widoku pobiera wartość i wykonuje rzeczywiste drukowanie określonej strony.

Innym przykładem jest przypadek, w którym długość dokumentu nie jest znana, dopóki nie zostanie wydrukowana. W takiej sytuacji klasy widoku testuje koniec dokumentu za każdym razem, gdy strona jest drukowana. Po osiągnięciu końca klasa view ustawia m_bContinuePrinting element członkowski CPrintInfo wartości FALSE. Informuje to platformę o zatrzymaniu pętli wydruku.

CPrintInfojest używany przez funkcje CView składowe wymienione w obszarze "Zobacz również". Aby uzyskać więcej informacji na temat architektury drukowania dostarczonej przez bibliotekę klas programu Microsoft Foundation, zobacz Frame Windows and Document/View Architecture (Architektura ramek i dokumentów/widoków) oraz artykuły Drukowanie i drukowanie: Dokumenty wielostronicowe.

Hierarchia dziedziczenia

CPrintInfo

Wymagania

Nagłówek: afxext.h

CPrintInfo::GetFromPage

Wywołaj tę funkcję, aby pobrać numer pierwszej strony do wydrukowania.

UINT GetFromPage() const;

Wartość zwracana

Numer pierwszej strony do wydrukowania.

Uwagi

Jest to wartość określona przez użytkownika w oknie dialogowym Drukowanie i jest przechowywana w CPrintDialog obiekcie, do których odwołuje się element członkowski m_pPD . Jeśli użytkownik nie określił wartości, wartość domyślna to pierwsza strona dokumentu.

CPrintInfo::GetMaxPage

Wywołaj tę funkcję, aby pobrać numer ostatniej strony dokumentu.

UINT GetMaxPage() const;

Wartość zwracana

Numer ostatniej strony dokumentu.

Uwagi

Ta wartość jest przechowywana w CPrintDialog obiekcie, do których odwołuje się element członkowski m_pPD .

CPrintInfo::GetMinPage

Wywołaj tę funkcję, aby pobrać numer pierwszej strony dokumentu.

UINT GetMinPage() const;

Wartość zwracana

Numer pierwszej strony dokumentu.

Uwagi

Ta wartość jest przechowywana w CPrintDialog obiekcie, do których odwołuje się element członkowski m_pPD .

CPrintInfo::GetOffsetPage

Wywołaj tę funkcję, aby pobrać przesunięcie podczas drukowania wielu elementów docObject z klienta docObject.

UINT GetOffsetPage() const;

Wartość zwracana

Liczba stron poprzedzających pierwszą stronę elementu DocObject drukowanego w połączonym zadaniu drukowania docObject.

Uwagi

Ta wartość jest przywołyowana przez element członkowski m_nOffsetPage . Pierwsza strona dokumentu zostanie ponumerowana m_nOffsetPage jako wartość + 1 po wydrukowaniu jako obiekt DocObject z innymi aktywnymi dokumentami. Element m_nOffsetPage członkowski jest prawidłowy tylko wtedy, gdy m_bDocObject wartość ma wartość TRUE.

CPrintInfo::GetToPage

Wywołaj tę funkcję, aby pobrać numer ostatniej strony do wydrukowania.

UINT GetToPage() const;

Wartość zwracana

Numer ostatniej strony do wydrukowania.

Uwagi

Jest to wartość określona przez użytkownika w oknie dialogowym Drukowanie i jest przechowywana w CPrintDialog obiekcie, do których odwołuje się element członkowski m_pPD . Jeśli użytkownik nie określił wartości, wartość domyślna to ostatnia strona dokumentu.

CPrintInfo::m_bContinuePrinting

Zawiera flagę wskazującą, czy struktura powinna kontynuować pętlę drukowania.

Uwagi

Jeśli wykonujesz stronicowanie w czasie drukowania, możesz ustawić ten element członkowski na wartość FALSE w zastąpieniu CView::OnPrepareDC po osiągnięciu końca dokumentu. Nie musisz modyfikować tej zmiennej, jeśli określono długość dokumentu na początku zadania drukowania przy użyciu funkcji składowej SetMaxPage . Element m_bContinuePrinting członkowski jest publiczną zmienną typu BOOL.

CPrintInfo::m_bDirect

Platforma ustawia ten element członkowski na wartość TRUE, jeśli okno dialogowe Drukowanie zostanie pominięte w przypadku drukowania bezpośredniego; FAŁSZ w przeciwnym razie.

Uwagi

Okno dialogowe Drukowanie jest zwykle pomijane podczas drukowania z powłoki lub podczas drukowania przy użyciu identyfikatora polecenia ID_FILE_PRINT_DIRECT.

Zwykle nie zmieniasz tego elementu członkowskiego, ale jeśli go zmienisz, zmień go przed wywołaniem CView::D oPreparePrinting w zastąpieniu CView::OnPreparePrinting.

CPrintInfo::m_bDocObject

Zawiera flagę wskazującą, czy drukowany dokument jest obiektem DocObject.

Uwagi

Składowe m_dwFlags danych i m_nOffsetPage są nieprawidłowe, chyba że ta flaga ma wartość TRUE.

CPrintInfo::m_bPreview

Zawiera flagę wskazującą, czy dokument jest podgląd.

Uwagi

Jest to ustawiane przez strukturę w zależności od tego, które polecenie zostało wykonane przez użytkownika. Okno dialogowe Drukowanie nie jest wyświetlane dla zadania podglądu wydruku. Element m_bPreview członkowski jest publiczną zmienną typu BOOL.

CPrintInfo::m_dwFlags

Zawiera kombinację flag określających operacje drukowania w obiekcie DocObject.

Uwagi

Prawidłowe tylko wtedy, gdy element członkowski m_bDocObject danych ma wartość TRUE.

Flagi mogą być co najmniej jedną z następujących wartości:

• PRINTFLAG_MAYBOTHERUSER

• PRINTFLAG_PROMPTUSER

• PRINTFLAG_USERMAYCHANGEPRINTER

• PRINTFLAG_RECOMPOSETODEVICE

• PRINTFLAG_DONTACTUALLYPRINT

• PRINTFLAG_FORCEPROPERTIES

• PRINTFLAG_PRINTTOFILE

CPrintInfo::m_lpUserData

Zawiera wskaźnik do struktury utworzonej przez użytkownika.

Uwagi

Służy do przechowywania danych specyficznych dla drukowania, które nie mają być przechowywane w klasie widoków. Element m_lpUserData członkowski jest publiczną zmienną typu LPVOID.

CPrintInfo::m_nCurPage

Zawiera liczbę bieżącej strony.

Uwagi

Struktura wywołuje wywołania CView::OnPrepareDC i CView::OnPrint raz dla każdej strony dokumentu, określając inną wartość dla tego elementu członkowskiego za każdym razem; jego wartości wahają się od wartości zwracanej przez GetFromPage GetToPageelement . Użyj tego elementu członkowskiego w przesłonięciach CView::OnPrepareDC i CView::OnPrint , aby wydrukować określoną stronę dokumentu.

Po pierwszym wywołaniu trybu podglądu platforma odczytuje wartość tego elementu członkowskiego, aby określić, która strona dokumentu powinna być początkowo przeglądana. Wartość tego elementu członkowskiego można ustawić w CView::OnPreparePrinting zastąpieniu, aby zachować bieżące położenie użytkownika w dokumencie podczas wprowadzania trybu podglądu. Element m_nCurPage członkowski jest zmienną publiczną typu UINT.

CPrintInfo::m_nJobNumber

Wskazuje numer zadania przypisany przez system operacyjny dla bieżącego zadania drukowania.

Uwagi

Ta wartość może być SP_ERROR, jeśli zadanie nie zostało jeszcze wydrukowane (czyli jeśli CPrintInfo obiekt jest nowo skonstruowany i nie został jeszcze użyty do drukowania) lub jeśli wystąpił błąd podczas uruchamiania zadania.

CPrintInfo::m_nNumPreviewPages

Zawiera liczbę stron wyświetlanych w trybie podglądu; może to być wartość 1 lub 2.

Uwagi

Element m_nNumPreviewPages członkowski jest zmienną publiczną typu UINT.

CPrintInfo::m_nOffsetPage

Zawiera liczbę stron poprzedzających pierwszą stronę określonego obiektu DocObject w połączonym zadaniu drukowania docObject.

CPrintInfo::m_pPD

Zawiera wskaźnik do obiektu używanego CPrintDialog do wyświetlania okna dialogowego Drukowanie zadania drukowania.

Uwagi

Element m_pPD członkowski jest zmienną publiczną zadeklarowaną jako wskaźnik na CPrintDialog.

CPrintInfo::m_rectDraw

Określa użyteczny obszar rysunku strony we współrzędnych logicznych.

Uwagi

Możesz odwołać się do tego w przesłonięcie .CView::OnPrint Możesz użyć tego elementu członkowskiego, aby śledzić, jaki obszar pozostaje używany po wydrukowaniu nagłówków, stopek itd. Element m_rectDraw członkowski jest publiczną zmienną typu CRect.

CPrintInfo::m_strPageDesc

Zawiera ciąg formatu używany do wyświetlania numerów stron podczas podglądu wydruku; Ten ciąg składa się z dwóch podciągów, jeden dla wyświetlania jednostronicowego i jeden dla wyświetlania dwustronicowego, każdy zakończony znakiem "\n".

Uwagi

Struktura używa wartości domyślnej "Page %u\nPages %u-%u\n". Jeśli chcesz użyć innego formatu dla numerów stron, określ ciąg formatu w przesłonięciu .CView::OnPreparePrinting Element m_strPageDesc członkowski jest publiczną zmienną typu CString.

CPrintInfo::SetMaxPage

Wywołaj tę funkcję, aby określić numer ostatniej strony dokumentu.

void SetMaxPage(UINT nMaxPage);

Parametry

nMaxPage
Numer ostatniej strony dokumentu.

Uwagi

Ta wartość jest przechowywana w CPrintDialog obiekcie, do których odwołuje się element członkowski m_pPD . Jeśli długość dokumentu jest znana przed jego wydrukowaniem, wywołaj tę funkcję z przesłonięcia elementu CView::OnPreparePrinting. Jeśli długość dokumentu zależy od ustawienia określonego przez użytkownika w oknie dialogowym Drukowanie, wywołaj tę funkcję z przesłonięcia .CView::OnBeginPrinting Jeśli długość dokumentu nie jest znana, dopóki nie zostanie wydrukowany, użyj m_bContinuePrinting elementu członkowskiego do sterowania pętlą wydruku.

Przykład

Zobacz przykład CView ::OnPreparePrinting.

CPrintInfo::SetMinPage

Wywołaj tę funkcję, aby określić liczbę pierwszej strony dokumentu.

void SetMinPage(UINT nMinPage);

Parametry

nMinPage
Numer pierwszej strony dokumentu.

Uwagi

Numery stron zwykle zaczynają się od 1. Ta wartość jest przechowywana w CPrintDialog obiekcie, do których odwołuje się element członkowski m_pPD .

Zobacz też

Przykład MFC DIBLOOK
Wykres hierarchii
CView::OnBeginPrinting
CView::OnEndPrinting
CView::OnEndPrintPreview
CView::OnPrepareDC
CView::OnPreparePrinting
CView::OnPrint