CPrintDialogEx osztály

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.

A Windows Print tulajdonságlap által biztosított szolgáltatásokat foglalja magában.

Szemantika

class CPrintDialogEx : public CCommonDialog

Tagok

Nyilvános konstruktorok

Név	Description
CPrintDialogEx::CPrintDialogEx	Egy CPrintDialogEx objektumot hoz létre.

Nyilvános metódusok

Név	Description
CPrintDialogEx::CreatePrinterDC	Nyomtatóeszköz-környezetet hoz létre a Nyomtatás párbeszédpanel megjelenítése nélkül.
CPrintDialogEx::D oModal	Megjeleníti a párbeszédpanelt, és lehetővé teszi a felhasználó számára a kijelöléseket.
CPrintDialogEx::GetCopies	Lekéri a kért másolatok számát.
CPrintDialogEx::GetDefaults	Párbeszédpanel megjelenítése nélkül kéri le az eszköz alapértelmezett értékeit.
CPrintDialogEx::GetDeviceName	Lekéri az aktuálisan kijelölt nyomtatóeszköz nevét.
CPrintDialogEx::GetDevMode	Lekéri a struktúrát DEVMODE .
CPrintDialogEx::GetDriverName	Lekéri a rendszer által definiált nyomtatóeszköz-illesztőprogram nevét.
CPrintDialogEx::GetPortName	Lekéri az aktuálisan kijelölt nyomtatóport nevét.
CPrintDialogEx::GetPrinterDC	Lekéri a fogópontot a nyomtatóeszköz környezetéhez.
CPrintDialogEx::P rintAll	Meghatározza, hogy a dokumentum minden oldalát ki kell-e nyomtatni.
CPrintDialogEx::P rintCollate	Meghatározza, hogy a rendszer kéri-e az átválogatott másolatokat.
CPrintDialogEx::P rintCurrentPage	Meghatározza, hogy nyomtatja-e a dokumentum aktuális lapját.
CPrintDialogEx::P rintRange	Meghatározza, hogy csak egy megadott oldaltartományt kell-e nyomtatni.
CPrintDialogEx::P rintSelection	Meghatározza, hogy csak az aktuálisan kijelölt elemeket kell-e nyomtatni.

Nyilvános adatok tagjai

Név	Description
CPrintDialogEx::m_pdex	Objektum testreszabására CPrintDialogEx használt struktúra.

Megjegyzések

A keretrendszerre támaszkodva kezelheti az alkalmazás nyomtatási folyamatának számos aspektusát. A keretrendszer nyomtatási feladatok kezelésére való használatával kapcsolatos további információkért lásd a Nyomtatás című cikket.

Ha azt szeretné, hogy az alkalmazás a keretrendszer közreműködése nélkül kezelje a nyomtatást, használhatja a CPrintDialogEx "ugyanúgy" osztályt a megadott konstruktorral, vagy saját párbeszédpanel-osztályt is létrehozhat, CPrintDialogEx és az igényeinek megfelelően konstruktort írhat. Mindkét esetben ezek a párbeszédpanelek szabványos MFC-párbeszédpanelekhez hasonlóan fognak viselkedni, mert osztályból CCommonDialogszármaznak.

Objektum használatához CPrintDialogEx először hozza létre az objektumot a CPrintDialogEx konstruktor használatával. A párbeszédpanel létrehozása után beállíthatja vagy módosíthatja a m_pdex struktúrában lévő értékeket a párbeszédpanel vezérlőinek értékeinek inicializálásához. A m_pdex struktúra PRINTDLGEX típusú. A struktúrával kapcsolatos további információkért lásd a Windows SDK-t.

Ha nem ad meg saját fogópontokat m_pdex a tagoknak és hDevNames a hDevMode tagoknak, mindenképpen hívja meg a Windows függvényt GlobalFree ezekhez a fogópontokhoz, amikor elkészült a párbeszédpanellel.

A párbeszédpanel vezérlőinek inicializálása után hívja meg a DoModal tagfüggvényt a párbeszédpanel megjelenítéséhez, és engedélyezze a felhasználónak a nyomtatási beállítások kiválasztását. Visszatéréskor DoModal meghatározhatja, hogy a felhasználó az OK, az Alkalmaz vagy a Mégse gombot választotta-e.

Ha a felhasználó lenyomta az OK gombot, a tagfüggvények használatával CPrintDialogExlekérheti a felhasználó által bevitt adatokat.

A CPrintDialogEx::GetDefaults tagfüggvény hasznos az aktuális nyomtató alapértelmezett értékeinek beolvasásához párbeszédpanel megjelenítése nélkül. Ez a módszer nem igényel felhasználói beavatkozást.

A Windows CommDlgExtendedError függvénnyel megállapíthatja, hogy hiba történt-e a párbeszédpanel inicializálása során, és további információt kaphat a hibáról. A függvényről további információt a Windows SDK-n talál.

A használatról CPrintDialogExtovábbi információt a Gyakori párbeszédpanel-osztályok című témakörben talál.

Öröklési hierarchia

CObject

CCmdTarget

CWnd

CDialog

IObjectWithSite

IPrintDialogCallback

CCommonDialog

CPrintDialogEx

Requirements

Fejléc: afxdlgs.h

CPrintDialogEx::CPrintDialogEx

Windows Print tulajdonságlapot hoz létre.

CPrintDialogEx(
    DWORD dwFlags = PD_ALLPAGES | PD_USEDEVMODECOPIES | PD_NOPAGENUMS       | PD_HIDEPRINTTOFILE | PD_NOSELECTION | PD_NOCURRENTPAGE,
    CWnd* pParentWnd = NULL);

Paraméterek

dwFlags
A párbeszédpanel beállításainak testreszabásához használható egy vagy több jelző, a bitenkénti VAGY operátorral kombinálva. A PD_ALLPAGES jelző például a dokumentum minden oldalára beállítja az alapértelmezett nyomtatási tartományt. Ezekről a jelzőkről további információt a Windows SDK PRINTDLGEX struktúrájában talál.

pParentWnd
Mutató a párbeszédpanel szülő- vagy tulajdonosablakára.

Megjegyzések

Ez a tagfüggvény csak az objektumot hozza létre. DoModal A párbeszédpanel a tag függvénnyel jeleníthető meg.

CPrintDialogEx::CreatePrinterDC

Létrehoz egy nyomtatóeszköz-környezetet (DC) a DEVMODE és a DEVNAMES struktúrákból.

HDC CreatePrinterDC();

Visszaadott érték

Kezelje az újonnan létrehozott nyomtatóeszköz környezetét.

Megjegyzések

A visszaadott tartományvezérlőt a rendszer a hDCm_pdex tagjában is tárolja.

A rendszer feltételezi, hogy ez a tartományvezérlő az aktuális nyomtató tartományvezérlője, és minden más korábban beszerzett nyomtató-tartományvezérlőt törölni kell. Ez a függvény meghívható, és az eredményül kapott tartományvezérlőt használhatja anélkül, hogy valaha is megjelenítenie kellene a Nyomtatás párbeszédpanelt.

CPrintDialogEx::D oModal

Hívja meg ezt a függvényt a Windows Nyomtatás tulajdonságlapjának megjelenítéséhez, és engedélyezze a felhasználónak, hogy különböző nyomtatási lehetőségeket válasszon, például a példányok számát, az oldaltartományt és a másolatok szétválogatását.

virtual INT_PTR DoModal();

Visszaadott érték

A INT_PTR visszatérési érték valójában HRESULT. Lásd a Windows SDK PrintDlgEx Értékeinek visszaadása szakaszát.

Megjegyzések

Ha a különböző nyomtatási párbeszédpanel-beállításokat a struktúra tagjainak m_pdex beállításával szeretné inicializálni, ezt a hívás DoModalelőtt, de a párbeszédpanel-objektum létrehozása után kell elvégeznie.

A hívás DoModalután meghívhat más tagfüggvényeket, hogy lekérje a felhasználó által bevitt beállításokat vagy információkat a párbeszédpanelen.

Ha a hívás során DoModala PD_RETURNDC jelzőt használja, a rendszer egy nyomtató-tartományvezérlőt ad vissza a hDC m_pdex tagjában. Ezt a tartományvezérlőt a hívónak a DeleteDC hívásával kell felszabadítania CPrintDialogEx.

CPrintDialogEx::GetCopies

Hívás után DoModal hívja meg ezt a függvényt a kért példányok számának lekéréséhez.

int GetCopies() const;

Visszaadott érték

A kért másolatok száma.

CPrintDialogEx::GetDefaults

Hívja meg ezt a függvényt, hogy párbeszédpanel megjelenítése nélkül kérje le az alapértelmezett nyomtató alapértelmezett eszközbeállításait.

BOOL GetDefaults();

Visszaadott érték

IGAZ, ha sikeres, ellenkező esetben HAMIS.

Megjegyzések

Létrehoz egy nyomtatóeszköz-környezetet (DC) a DEVMODE és a DEVNAMES struktúrákból.

GetDefaults nem jelenik meg a Nyomtatási tulajdonságlap. Ehelyett a m_pdex és hDevMode tagjait hDevNames úgy állítja be, hogy a rendszer alapértelmezett nyomtatójához inicializált DEVMODE- és DEVNAMES-struktúrákat kezelje. Mindkettőnek hDevNameshDevMode null értékűnek kell lennie, vagy GetDefaults sikertelennek kell lennie.

Ha a PD_RETURNDC jelölő be van állítva, ez a függvény nem csak a hívónak ad vissza hDevNames és (benne és m_pdex.hDevNamesm_pdex.hDevMode) helyet, hanem egy nyomtató tartományvezérlőt is ad vissza a hívónak m_pdex.hDChDevMode . A hívó felelőssége, hogy törölje a nyomtató tartományvezérlőt, és meghívja a Windows GlobalFree függvényt a leírókon, amikor befejezte az CPrintDialogEx objektum használatát.

CPrintDialogEx::GetDeviceName

Hívja meg ezt a függvényt a DoModal meghívása után az aktuálisan kijelölt nyomtató nevének lekéréséhez, vagy a GetDefaults meghívása után az alapértelmezett nyomtató nevének lekéréséhez.

CString GetDeviceName() const;

Visszaadott érték

Az aktuálisan kijelölt nyomtató neve.

Megjegyzések

A CDC::CreateDC hívás értékeként lpszDeviceName visszaadott GetDeviceName objektumra mutató mutatót CString használjon.

CPrintDialogEx::GetDevMode

Hívja meg ezt a függvényt a DoModal vagy a GetDefaults hívása után a nyomtatóeszköz adatainak lekéréséhez.

LPDEVMODE GetDevMode() const;

Visszaadott érték

A DEVMODE adatstruktúra, amely információkat tartalmaz a nyomtatóillesztő eszköz inicializálásáról és környezetéről. A windowsos SDK-ban leírt Windows GlobalUnlock függvénnyel fel kell oldania a struktúra által felvett memóriát.

CPrintDialogEx::GetDriverName

A DoModal vagy a GetDefaults hívása után hívja meg ezt a függvényt a rendszer által definiált nyomtatóeszköz-illesztőprogram nevének lekéréséhez.

CString GetDriverName() const;

Visszaadott érték

A CString rendszer által definiált illesztőprogram nevét megadva.

Megjegyzések

A CDC::CreateDC hívásában az lpszDriverName értékeként visszaadott GetDriverName objektumra mutató mutatót CString használjon.

CPrintDialogEx::GetPortName

Hívja meg ezt a függvényt a DoModal vagy a GetDefaults hívása után az aktuálisan kijelölt nyomtatóport nevének lekéréséhez.

CString GetPortName() const;

Visszaadott érték

Az aktuálisan kijelölt nyomtatóport neve.

CPrintDialogEx::GetPrinterDC

Egy fogópontot ad vissza a nyomtatóeszköz környezetének.

HDC GetPrinterDC() const;

Visszaadott érték

A nyomtatóeszköz környezetének fogópontja.

Megjegyzések

A Windows DeleteDC függvény meghívásával törölheti az eszközkörnyezetet, amikor végzett vele.

CPrintDialogEx::m_pdex

PRINTDLGEX-struktúra, amelynek tagjai a párbeszédpanel-objektum jellemzőit tárolják.

PRINTDLGEX m_pdex;

Megjegyzések

Az objektum m_pdex létrehozása CPrintDialogEx után beállíthatja a párbeszédpanel különböző aspektusait, mielőtt meghívja a DoModal tagfüggvényt. A szerkezettel kapcsolatos további információkért lásd: m_pdexPRINTDLGEX a Windows SDK-ban.

Ha közvetlenül módosítja az m_pdex adattagot, felülbírálja az alapértelmezett viselkedést.

CPrintDialogEx::P rintAll

Hívás után DoModal hívja meg ezt a függvényt, és állapítsa meg, hogy a dokumentum összes lapját ki szeretné-e nyomtatni.

BOOL PrintAll() const;

Visszaadott érték

IGAZ, ha a dokumentum minden oldalát ki szeretné nyomtatni; egyéb esetben HAMIS.

CPrintDialogEx::P rintCollate

Hívás után DoModal hívja meg ezt a függvényt annak megállapításához, hogy a nyomtatónak össze kell-e rendeznie a dokumentum összes nyomtatott példányát.

BOOL PrintCollate() const;

Visszaadott érték

IGAZ, ha a felhasználó bejelöli a rendezés jelölőnégyzetet a párbeszédpanelen; egyéb esetben HAMIS.

CPrintDialogEx::P rintCurrentPage

Hívás után DoModal hívja meg ezt a függvényt, hogy eldöntse, nyomtatja-e az aktuális lapot a dokumentumban.

BOOL PrintCurrentPage() const;

Visszaadott érték

IGAZ, ha az aktuális lap nyomtatása ki van jelölve a nyomtatási párbeszédpanelen; egyéb esetben HAMIS.

CPrintDialogEx::P rintRange

Hívás után DoModal hívja meg ezt a függvényt annak megállapításához, hogy csak egy oldaltartományt szeretne-e nyomtatni a dokumentumban.

BOOL PrintRange() const;

Visszaadott érték

IGAZ, ha csak a dokumentum egy oldaltartományát szeretné kinyomtatni; egyéb esetben HAMIS.

Megjegyzések

A megadott oldaltartományok a m_pdex (lásd nPageRanges, nMaxPageRangesés lpPageRanges a Windows SDK PRINTDLGEX struktúrájában) határozhatók meg.

CPrintDialogEx::P rintSelection

Hívja meg ezt a függvényt a hívás DoModal után, és állapítsa meg, hogy csak az aktuálisan kijelölt elemeket szeretné-e kinyomtatni.

BOOL PrintSelection() const;

Visszaadott érték

IGAZ, ha csak a kijelölt elemeket szeretné kinyomtatni; egyéb esetben HAMIS.

Lásd még

CCommonDialog osztály
hierarchiadiagram
CPrintInfo struktúra