CPrintInfo struktúra

Megjegyzés:

A Microsoft Foundation Classes (MFC) könyvtár továbbra is támogatott. A továbbiakban azonban nem adunk hozzá funkciókat, és nem frissítjük a dokumentációt.

Egy nyomtatási vagy nyomtatási előnézeti feladat adatait tárolja.

Szemantika

struct CPrintInfo

Tagok

Nyilvános metódusok

Név	Description
CPrintInfo::GetFromPage	Az első nyomtatandó oldal számát adja vissza.
CPrintInfo::GetMaxPage	A dokumentum utolsó oldalának számát adja vissza.
CPrintInfo::GetMinPage	A dokumentum első oldalának számát adja vissza.
CPrintInfo::GetOffsetPage	A DocObject elem első oldalát megelőző lapok számát adja vissza, amelyek egy kombinált DocObject nyomtatási feladatban jelennek meg.
CPrintInfo::GetToPage	Az utolsó nyomtatandó oldal számát adja vissza.
CPrintInfo::SetMaxPage	Beállítja a dokumentum utolsó oldalának számát.
CPrintInfo::SetMinPage	Beállítja a dokumentum első oldalának számát.

Nyilvános adatok tagjai

Név	Description
CPrintInfo::m_bContinuePrinting	Egy jelzőt tartalmaz, amely jelzi, hogy a keretrendszernek folytatnia kell-e a nyomtatási ciklust.
CPrintInfo::m_bDirect	Egy jelölőt tartalmaz, amely jelzi, hogy a dokumentum nyomtatása közvetlenül történik-e (a Nyomtatás párbeszédpanel megjelenítése nélkül).
CPrintInfo::m_bDocObject	Egy jelölőt tartalmaz, amely jelzi, hogy a nyomtatandó dokumentum DocObject-e.
CPrintInfo::m_bPreview	Egy jelzőt tartalmaz, amely jelzi, hogy a dokumentum előnézete folyamatban van-e.
CPrintInfo::m_dwFlags	A DocObject nyomtatási műveleteit adja meg.
CPrintInfo::m_lpUserData	Egy felhasználó által létrehozott struktúrára mutató mutatót tartalmaz.
CPrintInfo::m_nCurPage	A jelenleg kinyomtatott lap számát azonosítja.
CPrintInfo::m_nJobNumber	Az operációs rendszer által az aktuális nyomtatási feladathoz hozzárendelt feladatszámot adja meg
CPrintInfo::m_nNumPreviewPages	Az előnézeti ablakban megjelenített lapok számát azonosítja; vagy 1 vagy 2.
CPrintInfo::m_nOffsetPage	Egy adott DocObject első oldalának eltolását adja meg egy kombinált DocObject nyomtatási feladatban.
CPrintInfo::m_pPD	A Nyomtatás párbeszédpanelhez használt objektumra mutató mutatót CPrintDialog tartalmaz.
CPrintInfo::m_rectDraw	Az aktuális használható oldalterületet meghatározó téglalapot adja meg.
CPrintInfo::m_strPageDesc	Egy formátumsztringet tartalmaz az oldalszám megjelenítéséhez.

Megjegyzések

CPrintInfo egy struktúra, és nem rendelkezik alaposztálysal.

A keretrendszer minden alkalommal létrehoz egy objektumot CPrintInfo , amikor a Nyomtatási kép vagy a Nyomtatás előnézete parancsot választja, és megsemmisíti azt a parancs végrehajtásakor.

CPrintInfo A nyomtatási feladat egészére, például a nyomtatandó lapok tartományára és a nyomtatási feladat aktuális állapotára, például a nyomtatandó lapra vonatkozó információkat tartalmaz. A rendszer bizonyos információkat egy társított CPrintDialog-objektumban tárol; Ez az objektum a felhasználó által a Nyomtatás párbeszédpanelen megadott értékeket tartalmazza.

A CPrintInfo rendszer egy objektumot ad át a keretrendszer és a nézetosztály között a nyomtatási folyamat során, és a kettő közötti információk cseréjére szolgál. A keretrendszer például úgy tájékoztatja a nézetosztályt, hogy a dokumentum melyik oldalát nyomtatja ki egy érték hozzárendelésével a m_nCurPage dokumentum tagjának CPrintInfo; a nézetosztály lekéri az értéket, és elvégzi a megadott oldal tényleges nyomtatását.

Egy másik példa az az eset, amikor a dokumentum hossza nem ismert, amíg ki nem nyomtatják. Ebben az esetben a megtekintési osztály minden egyes lap nyomtatásakor teszteli a dokumentum végét. A befejezés elérésekor a nézetosztály HAMIS értékre állítja a m_bContinuePrinting tagot CPrintInfo . Ez tájékoztatja a keretrendszert a nyomtatási ciklus leállításáról.

CPrintInfo a "Lásd még" listában szereplő tagfüggvények CView használják. A Microsoft Foundation osztálykönyvtára által biztosított nyomtatási architektúrával kapcsolatos további információkért tekintse meg a Keret windowsos és dokumentum/nézet architektúrája , valamint a Nyomtatás és nyomtatás: Többoldalas dokumentumok című cikket.

Öröklési hierarchia

CPrintInfo

Requirements

Fejléc: afxext.h

CPrintInfo::GetFromPage

Hívja meg ezt a függvényt a nyomtatandó első oldal számának lekéréséhez.

UINT GetFromPage() const;

Visszaadott érték

Az első nyomtatandó oldal száma.

Megjegyzések

Ez a felhasználó által a Nyomtatás párbeszédpanelen megadott érték, amelyet a rendszer a CPrintDialog tag által m_pPD hivatkozott objektumban tárol. Ha a felhasználó nem adott meg értéket, az alapértelmezett érték a dokumentum első oldala.

CPrintInfo::GetMaxPage

Hívja meg ezt a függvényt a dokumentum utolsó oldalának számának lekéréséhez.

UINT GetMaxPage() const;

Visszaadott érték

A dokumentum utolsó oldalának száma.

Megjegyzések

Ezt az értéket a rendszer a CPrintDialog tag által m_pPD hivatkozott objektumban tárolja.

CPrintInfo::GetMinPage

Hívja meg ezt a függvényt a dokumentum első oldalának számának lekéréséhez.

UINT GetMinPage() const;

Visszaadott érték

A dokumentum első oldalának száma.

Megjegyzések

Ezt az értéket a rendszer a CPrintDialog tag által m_pPD hivatkozott objektumban tárolja.

CPrintInfo::GetOffsetPage

Hívja meg ezt a függvényt, hogy lekérje az eltolást, amikor több DocObject-elemet nyomtat egy DocObject-ügyfélből.

UINT GetOffsetPage() const;

Visszaadott érték

A DocObject elem első oldalát megelőző lapok száma, amelyek egy kombinált DocObject nyomtatási feladatban jelennek meg.

Megjegyzések

Erre az értékre a tag hivatkozik m_nOffsetPage . A dokumentum első oldalának számozása + m_nOffsetPage 1 lesz, ha más aktív dokumentumokkal együtt docObjectként nyomtatja ki. A m_nOffsetPage tag csak akkor érvényes, ha az m_bDocObject érték IGAZ.

CPrintInfo::GetToPage

Hívja meg ezt a függvényt az utolsó nyomtatandó oldal számának lekéréséhez.

UINT GetToPage() const;

Visszaadott érték

Az utolsó nyomtatandó oldal száma.

Megjegyzések

Ez a felhasználó által a Nyomtatás párbeszédpanelen megadott érték, amelyet a rendszer a CPrintDialog tag által m_pPD hivatkozott objektumban tárol. Ha a felhasználó nem adott meg értéket, az alapértelmezett érték a dokumentum utolsó oldala.

CPrintInfo::m_bContinuePrinting

Egy jelzőt tartalmaz, amely jelzi, hogy a keretrendszernek folytatnia kell-e a nyomtatási ciklust.

Megjegyzések

Ha nyomtatási idő szerinti lapozást végez, ezt a tagot false (HAMIS) értékre állíthatja a dokumentum végének felülbírálásakor CView::OnPrepareDC . Nem kell módosítania ezt a változót, ha a dokumentum hosszát a nyomtatási feladat elején adta meg a SetMaxPage tagfüggvény használatával. A m_bContinuePrinting tag egy BOOL típusú nyilvános változó.

CPrintInfo::m_bDirect

A keretrendszer true (IGAZ) értékre állítja ezt a tagot, ha a Nyomtatás párbeszédpanelt megkerüli a közvetlen nyomtatáshoz; HAMIS egyéb esetben.

Megjegyzések

A Nyomtatás párbeszédpanelt általában megkerüli a rendszerhéjból való nyomtatáskor, vagy ha a nyomtatás a parancsazonosító ID_FILE_PRINT_DIRECT használatával történik.

Ezt a tagot általában nem módosítja, de ha mégis módosítja, módosítsa, mielőtt meghívja a CView::D oPreparePrinting parancsot a CView::OnPreparePrinting felülbírálásában.

CPrintInfo::m_bDocObject

Egy jelölőt tartalmaz, amely jelzi, hogy a nyomtatandó dokumentum DocObject-e.

Megjegyzések

Az adattagok m_dwFlagsm_nOffsetPage érvénytelenek, kivéve, ha ez a jelző IGAZ.

CPrintInfo::m_bPreview

Egy jelzőt tartalmaz, amely jelzi, hogy a dokumentum előnézete folyamatban van-e.

Megjegyzések

Ezt a keretrendszer állítja be attól függően, hogy a felhasználó melyik parancsot hajtotta végre. A Nyomtatás párbeszédpanel nem jelenik meg nyomtatási képhez. A m_bPreview tag egy BOOL típusú nyilvános változó.

CPrintInfo::m_dwFlags

A DocObject nyomtatási műveleteket meghatározó jelzők kombinációját tartalmazza.

Megjegyzések

Csak akkor érvényes, ha az adattag m_bDocObject IGAZ.

A jelzők a következő értékek közül egy vagy több lehetnek:

• PRINTFLAG_MAYBOTHERUSER

• PRINTFLAG_PROMPTUSER

• PRINTFLAG_USERMAYCHANGEPRINTER

• PRINTFLAG_RECOMPOSETODEVICE

• PRINTFLAG_DONTACTUALLYPRINT

• PRINTFLAG_FORCEPROPERTIES

• PRINTFLAG_PRINTTOFILE

CPrintInfo::m_lpUserData

Egy felhasználó által létrehozott struktúrára mutató mutatót tartalmaz.

Megjegyzések

Ezzel olyan nyomtatási adatokat tárolhat, amelyeket nem szeretne a nézetosztályban tárolni. A m_lpUserData tag egy LPVOID típusú nyilvános változó.

CPrintInfo::m_nCurPage

Az aktuális oldal számát tartalmazza.

Megjegyzések

A keretrendszer meghívja CView::OnPrepareDC és CView::OnPrint egyszer a dokumentum minden oldalára, és minden alkalommal más értéket ad meg ennek a tagnak; az értékei a visszaadotttól GetFromPage a visszaadott GetToPageértékig terjednek. Használja ezt a tagot a dokumentum felülbírálásaiban CView::OnPrepareDC , és CView::OnPrint nyomtassa ki a dokumentum megadott oldalát.

Az előzetes verziójú mód első meghívásakor a keretrendszer beolvassa ennek a tagnak az értékét annak meghatározásához, hogy a dokumentum melyik oldalát kell először megtekinteni. Ennek a tagnak az értékét beállíthatja a felülbírálásban CView::OnPreparePrinting , hogy fenntartsa a felhasználó aktuális pozícióját a dokumentumban az előnézeti mód megadásakor. A m_nCurPage tag egy UINT típusú nyilvános változó.

CPrintInfo::m_nJobNumber

Az operációs rendszer által az aktuális nyomtatási feladathoz hozzárendelt feladatszámot jelzi.

Megjegyzések

Ez az érték akkor lehet SP_ERROR, ha a feladat még nem lett kinyomtatva (vagyis ha az CPrintInfo objektum újonnan lett létrehozva, és még nem lett felhasználva nyomtatásra), vagy ha hiba történt a feladat indításakor.

CPrintInfo::m_nNumPreviewPages

Az előnézeti módban megjelenített lapok számát tartalmazza; 1 vagy 2 lehet.

Megjegyzések

A m_nNumPreviewPages tag egy UINT típusú nyilvános változó.

CPrintInfo::m_nOffsetPage

Egy adott DocObject első oldalát megelőző lapok számát tartalmazza egy kombinált DocObject nyomtatási feladatban.

CPrintInfo::m_pPD

A nyomtatási feladat Nyomtatás párbeszédpaneljének megjelenítéséhez használt objektumra mutató mutatót CPrintDialog tartalmaz.

Megjegyzések

A m_pPD tag egy nyilvános változó, amely mutatóként van deklarálva.CPrintDialog

CPrintInfo::m_rectDraw

A lap használható rajzterületét logikai koordinátákban adja meg.

Megjegyzések

Érdemes lehet erre hivatkozni a felülbírálásában CView::OnPrint. Ezzel a tagtal nyomon követheti, hogy az élőfejek, élőlábak stb. nyomtatása után mely terület marad használható. A m_rectDraw tag egy nyilvános változó típusú CRect.

CPrintInfo::m_strPageDesc

Egy formátumsztringet tartalmaz, amellyel megjelenítheti az oldalszámokat a nyomtatási kép alatt; ez a sztring két részszűrést tartalmaz, egyet az egyoldalas megjelenítéshez, egyet pedig a kétoldalas megjelenítéshez, amelyeket egy "\n" karakter zár le.

Megjegyzések

A keretrendszer alapértelmezett értékként a "Page %u\nPages %u–%u\n" értéket használja. Ha más formátumot szeretne az oldalszámokhoz, adjon meg egy formátumsztringet a felülbírálásában CView::OnPreparePrinting. A m_strPageDesc tag egy nyilvános változó típusú CString.

CPrintInfo::SetMaxPage

Hívja meg ezt a függvényt a dokumentum utolsó oldalának számának megadásához.

void SetMaxPage(UINT nMaxPage);

Paraméterek

nMaxPage
A dokumentum utolsó oldalának száma.

Megjegyzések

Ezt az értéket a rendszer a CPrintDialog tag által m_pPD hivatkozott objektumban tárolja. Ha a dokumentum hossza ismert a nyomtatás előtt, hívja meg ezt a függvényt a felülbírálásából CView::OnPreparePrinting. Ha a dokumentum hossza a felhasználó által a Nyomtatás párbeszédpanelen megadott beállítástól függ, hívja meg ezt a függvényt a felülbírálásából CView::OnBeginPrinting. Ha a dokumentum hossza nem ismert, amíg ki nem nyomtatja, használja a m_bContinuePrinting tagot a nyomtatási ciklus vezérléséhez.

Example

Lásd a CView::OnPreparePrinting példát.

CPrintInfo::SetMinPage

Hívja meg ezt a függvényt a dokumentum első oldalának számának megadásához.

void SetMinPage(UINT nMinPage);

Paraméterek

nMinPage
A dokumentum első oldalának száma.

Megjegyzések

Az oldalszámok általában 1-nél kezdődnek. Ezt az értéket a rendszer a CPrintDialog tag által m_pPD hivatkozott objektumban tárolja.

Lásd még

MFC-minta DIBLOOK
hierarchiadiagram
CView::OnBeginPrinting
CView::OnEndPrinting
CView::OnEndPrintPreview
CView::OnPrepareDC
CView::OnPreparePrinting
CView::OnPrint