CPrintInfo-structuur

Opmerking

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

Slaat informatie op over een afdruk- of afdrukvoorbeeldtaak.

Syntaxis

struct CPrintInfo

Leden

Openbare methoden

Naam	Description
CPrintInfo::GetFromPage	Retourneert het nummer van de eerste pagina die wordt afgedrukt.
CPrintInfo::GetMaxPage	Retourneert het nummer van de laatste pagina van het document.
CPrintInfo::GetMinPage	Retourneert het nummer van de eerste pagina van het document.
CPrintInfo::GetOffsetPage	Retourneert het aantal pagina's voorafgaand aan de eerste pagina van een DocObject-item dat wordt afgedrukt in een gecombineerde DocObject-afdruktaak.
CPrintInfo::GetToPage	Retourneert het nummer van de laatste pagina die wordt afgedrukt.
CPrintInfo::SetMaxPage	Hiermee stelt u het nummer van de laatste pagina van het document in.
CPrintInfo::SetMinPage	Hiermee stelt u het nummer van de eerste pagina van het document in.

Leden van openbare gegevens

Naam	Description
CPrintInfo::m_bContinuePrinting	Bevat een vlag die aangeeft of het framework de afdruklus moet voortzetten.
CPrintInfo::m_bDirect	Bevat een vlag die aangeeft of het document rechtstreeks wordt afgedrukt (zonder het dialoogvenster Afdrukken weer te geven).
CPrintInfo::m_bDocObject	Bevat een vlag die aangeeft of het document dat wordt afgedrukt een DocObject is.
CPrintInfo::m_bPreview	Bevat een vlag die aangeeft of het document wordt bekeken.
CPrintInfo::m_dwFlags	Hiermee geeft u DocObject-afdrukbewerkingen op.
CPrintInfo::m_lpUserData	Bevat een aanwijzer naar een door de gebruiker gemaakte structuur.
CPrintInfo::m_nCurPage	Hiermee wordt het aantal pagina's aangegeven dat momenteel wordt afgedrukt.
CPrintInfo::m_nJobNumber	Hiermee geeft u het taaknummer dat is toegewezen door het besturingssysteem voor de huidige afdruktaak
CPrintInfo::m_nNumPreviewPages	Identificeert het aantal pagina's dat wordt weergegeven in het voorbeeldvenster; ofwel 1 of 2.
CPrintInfo::m_nOffsetPage	Hiermee geeft u verschuiving van de eerste pagina van een bepaald DocObject in een gecombineerde DocObject-afdruktaak.
CPrintInfo::m_pPD	Bevat een aanwijzer naar het CPrintDialog object dat wordt gebruikt voor het dialoogvenster Afdrukken.
CPrintInfo::m_rectDraw	Hiermee geeft u een rechthoek op waarmee het huidige bruikbare paginagebied wordt gedefinieerd.
CPrintInfo::m_strPageDesc	Bevat een notatietekenreeks voor het weergeven van paginanummers.

Opmerkingen

CPrintInfo is een structuur en heeft geen basisklasse.

Het framework maakt een object van CPrintInfo elke keer dat de opdracht Afdrukken of Afdrukvoorbeeld wordt gekozen en vernietigt het wanneer de opdracht is voltooid.

CPrintInfo bevat informatie over zowel de afdruktaak als geheel, zoals het aantal pagina's dat moet worden afgedrukt en de huidige status van de afdruktaak, zoals de pagina die momenteel wordt afgedrukt. Sommige informatie wordt opgeslagen in een gekoppeld CPrintDialog-object ; dit object bevat de waarden die door de gebruiker zijn ingevoerd in het dialoogvenster Afdrukken.

Een CPrintInfo object wordt doorgegeven tussen het framework en uw weergaveklasse tijdens het afdrukproces en wordt gebruikt om informatie tussen de twee uit te wisselen. Het framework informeert bijvoorbeeld de weergaveklasse welke pagina van het document moet worden afgedrukt door een waarde toe te wijzen aan het m_nCurPage lid van CPrintInfo; de weergaveklasse haalt de waarde op en voert het werkelijke afdrukken van de opgegeven pagina uit.

Een ander voorbeeld is het geval waarin de lengte van het document pas bekend is als het wordt afgedrukt. In dit geval test de weergaveklasse voor het einde van het document telkens wanneer een pagina wordt afgedrukt. Wanneer het einde is bereikt, stelt de weergaveklasse het m_bContinuePrinting lid van CPrintInfo ONWAAR in. Hiermee wordt het framework geïnformeerd om de afdruklus te stoppen.

CPrintInfo wordt gebruikt door de lidfuncties die CView worden vermeld onder 'Zie ook'. Zie De architectuur van Frame Windows en Document/View en de artikelen Afdrukken en Afdrukken: Documenten met meerdere pagina's voor meer informatie over de afdrukarchitectuur van de Microsoft Foundation Class Library.

Overnamehiërarchie

CPrintInfo

Requirements

Koptekst: afxext.h

CPrintInfo::GetFromPage

Roep deze functie aan om het nummer van de eerste pagina op te halen dat moet worden afgedrukt.

UINT GetFromPage() const;

Retourwaarde

Het nummer van de eerste pagina die moet worden afgedrukt.

Opmerkingen

Dit is de waarde die is opgegeven door de gebruiker in het dialoogvenster Afdrukken en wordt opgeslagen in het CPrintDialog object waarnaar wordt verwezen door het m_pPD lid. Als de gebruiker geen waarde heeft opgegeven, is de standaardwaarde de eerste pagina van het document.

CPrintInfo::GetMaxPage

Roep deze functie aan om het nummer van de laatste pagina van het document op te halen.

UINT GetMaxPage() const;

Retourwaarde

Het nummer van de laatste pagina van het document.

Opmerkingen

Deze waarde wordt opgeslagen in het CPrintDialog object waarnaar wordt verwezen door het m_pPD lid.

CPrintInfo::GetMinPage

Roep deze functie aan om het nummer van de eerste pagina van het document op te halen.

UINT GetMinPage() const;

Retourwaarde

Het nummer van de eerste pagina van het document.

Opmerkingen

Deze waarde wordt opgeslagen in het CPrintDialog object waarnaar wordt verwezen door het m_pPD lid.

CPrintInfo::GetOffsetPage

Roep deze functie aan om de offset op te halen bij het afdrukken van meerdere DocObject-items van een DocObject-client.

UINT GetOffsetPage() const;

Retourwaarde

Het aantal pagina's voorafgaand aan de eerste pagina van een DocObject-item dat wordt afgedrukt in een gecombineerde DocObject-afdruktaak.

Opmerkingen

Naar deze waarde wordt verwezen door het m_nOffsetPage lid. De eerste pagina van uw document wordt genummerd op de m_nOffsetPage waarde + 1 wanneer deze wordt afgedrukt als een DocObject met andere actieve documenten. Het m_nOffsetPage lid is alleen geldig als de m_bDocObject waarde WAAR is.

CPrintInfo::GetToPage

Roep deze functie aan om het nummer op te halen van de laatste pagina die moet worden afgedrukt.

UINT GetToPage() const;

Retourwaarde

Het nummer van de laatste pagina die moet worden afgedrukt.

Opmerkingen

Dit is de waarde die is opgegeven door de gebruiker in het dialoogvenster Afdrukken en wordt opgeslagen in het CPrintDialog object waarnaar wordt verwezen door het m_pPD lid. Als de gebruiker geen waarde heeft opgegeven, is de standaardwaarde de laatste pagina van het document.

CPrintInfo::m_bContinuePrinting

Bevat een vlag die aangeeft of het framework de afdruklus moet voortzetten.

Opmerkingen

Als u afdruktijdpaginering uitvoert, kunt u dit lid instellen op FALSE in uw overschrijving van CView::OnPrepareDC zodra het einde van het document is bereikt. U hoeft deze variabele niet te wijzigen als u de lengte van het document aan het begin van de afdruktaak hebt opgegeven met behulp van de SetMaxPage lidfunctie. Het m_bContinuePrinting lid is een openbare variabele van het type BOOL.

CPrintInfo::m_bDirect

Het framework stelt dit lid in op TRUE als het dialoogvenster Afdrukken wordt omzeild voor direct afdrukken; ANDERS ONWAAR.

Opmerkingen

Het dialoogvenster Afdrukken wordt normaal gesproken overgeslagen wanneer u afdrukt vanuit de shell of wanneer het afdrukken wordt uitgevoerd met behulp van de opdracht-id ID_FILE_PRINT_DIRECT.

Normaal gesproken wijzigt u dit lid niet, maar als u dit wel wijzigt, wijzigt u het voordat u CView::D oPreparePrinting aanroept in uw onderdrukking van CView::OnPreparePrinting.

CPrintInfo::m_bDocObject

Bevat een vlag die aangeeft of het document dat wordt afgedrukt een DocObject is.

Opmerkingen

Gegevensleden m_dwFlags en m_nOffsetPage zijn ongeldig, tenzij deze vlag WAAR is.

CPrintInfo::m_bPreview

Bevat een vlag die aangeeft of het document wordt bekeken.

Opmerkingen

Dit wordt ingesteld door het framework, afhankelijk van de opdracht die de gebruiker heeft uitgevoerd. Het dialoogvenster Afdrukken wordt niet weergegeven voor een afdrukvoorbeeldtaak. Het m_bPreview lid is een openbare variabele van het type BOOL.

CPrintInfo::m_dwFlags

Bevat een combinatie van vlaggen die DocObject-afdrukbewerkingen opgeven.

Opmerkingen

Alleen geldig als het gegevenslid m_bDocObject WAAR is.

De vlaggen kunnen een of meer van de volgende waarden zijn:

• PRINTFLAG_MAYBOTHERUSER

• PRINTFLAG_PROMPTUSER

• PRINTFLAG_USERMAYCHANGEPRINTER

• PRINTFLAG_RECOMPOSETODEVICE

• PRINTFLAG_DONTACTUALLYPRINT

• PRINTFLAG_FORCEPROPERTIES

• PRINTFLAG_PRINTTOFILE

CPrintInfo::m_lpUserData

Bevat een aanwijzer naar een door de gebruiker gemaakte structuur.

Opmerkingen

U kunt dit gebruiken om afdrukspecifieke gegevens op te slaan die u niet wilt opslaan in uw weergaveklasse. Het m_lpUserData lid is een openbare variabele van het type LPVOID.

CPrintInfo::m_nCurPage

Bevat het nummer van de huidige pagina.

Opmerkingen

Het framework roept CView::OnPrepareDC aan en CView::OnPrint één keer voor elke pagina van het document, waarbij telkens een andere waarde voor dit lid wordt opgegeven; de waarden variëren van de waarde die wordt geretourneerd door GetFromPage die door GetToPage. Gebruik dit lid in uw onderdrukkingen van CView::OnPrepareDC en CView::OnPrint om de opgegeven pagina van het document af te drukken.

Wanneer de preview-modus voor het eerst wordt aangeroepen, leest het framework de waarde van dit lid om te bepalen welke pagina van het document in eerste instantie moet worden bekeken. U kunt de waarde van dit lid instellen in uw onderdrukking om CView::OnPreparePrinting de huidige positie van de gebruiker in het document te behouden wanneer u de preview-modus opent. Het m_nCurPage lid is een openbare variabele van het type UINT.

CPrintInfo::m_nJobNumber

Geeft het taaknummer aan dat is toegewezen door het besturingssysteem voor de huidige afdruktaak.

Opmerkingen

Deze waarde kan worden SP_ERROR als de taak nog niet is afgedrukt (dat wil gezegd, als het CPrintInfo object nieuw is gemaakt en nog niet is gebruikt om af te drukken), of als er een fout is opgetreden bij het starten van de taak.

CPrintInfo::m_nNumPreviewPages

Bevat het aantal pagina's dat wordt weergegeven in de preview-modus; het kan 1 of 2 zijn.

Opmerkingen

Het m_nNumPreviewPages lid is een openbare variabele van het type UINT.

CPrintInfo::m_nOffsetPage

Bevat het aantal pagina's dat voorafgaat aan de eerste pagina van een bepaald DocObject in een gecombineerde DocObject-afdruktaak.

CPrintInfo::m_pPD

Bevat een aanwijzer naar het CPrintDialog object dat wordt gebruikt om het dialoogvenster Afdrukken voor de afdruktaak weer te geven.

Opmerkingen

Het m_pPD lid is een openbare variabele die als aanwijzer CPrintDialogwordt gedeclareerd.

CPrintInfo::m_rectDraw

Hiermee geeft u het bruikbare tekengebied van de pagina in logische coördinaten.

Opmerkingen

U kunt dit raadplegen in uw onderdrukking van CView::OnPrint. U kunt dit lid gebruiken om bij te houden welk gebied bruikbaar blijft nadat u kopteksten, voetteksten enzovoort hebt afgedrukt. Het m_rectDraw lid is een openbare variabele van het type CRect.

CPrintInfo::m_strPageDesc

Bevat een notatietekenreeks die wordt gebruikt om de paginanummers weer te geven tijdens het afdrukvoorbeeld; deze tekenreeks bestaat uit twee subtekenreeksen, één voor weergave met één pagina en één voor weergave met twee pagina's, die elk worden beëindigd door het teken '\n'.

Opmerkingen

Het framework maakt gebruik van 'Page %u\nPages %u-%u\n' als de standaardwaarde. Als u een andere notatie voor de paginanummers wilt, geeft u een notatietekenreeks op in de onderdrukking van CView::OnPreparePrinting. Het m_strPageDesc lid is een openbare variabele van het type CString.

CPrintInfo::SetMaxPage

Roep deze functie aan om het nummer van de laatste pagina van het document op te geven.

void SetMaxPage(UINT nMaxPage);

Parameterwaarden

nMaxPage
Nummer van de laatste pagina van het document.

Opmerkingen

Deze waarde wordt opgeslagen in het CPrintDialog object waarnaar wordt verwezen door het m_pPD lid. Als de lengte van het document bekend is voordat het wordt afgedrukt, roept u deze functie aan vanaf de onderdrukking van CView::OnPreparePrinting. Als de lengte van het document afhankelijk is van een instelling die is opgegeven door de gebruiker in het dialoogvenster Afdrukken, roept u deze functie aan vanaf de onderdrukking van CView::OnBeginPrinting. Als de lengte van het document pas bekend is wanneer het wordt afgedrukt, gebruikt u het m_bContinuePrinting lid om de afdruklus te beheren.

Example

Zie het voorbeeld voor CView::OnPreparePrinting.

CPrintInfo::SetMinPage

Roep deze functie aan om het nummer van de eerste pagina van het document op te geven.

void SetMinPage(UINT nMinPage);

Parameterwaarden

nMinPage
Nummer van de eerste pagina van het document.

Opmerkingen

Paginanummers beginnen normaal bij 1. Deze waarde wordt opgeslagen in het CPrintDialog object waarnaar wordt verwezen door het m_pPD lid.

Zie ook

MFC-voorbeeld-DIBLOOK
Hiërarchiegrafiek
CView::OnBeginPrinting
CView::OnEndPrinting
CView::OnEndPrintPreview
CView::OnPrepareDC
CView::OnPreparePrinting
CView::OnPrint