Třída CPrintDialog

Článek
03/04/2013

Zapouzdřuje služby poskytované dialogové okno společného systému Windows pro tisk.

class CPrintDialog : public CCommonDialog

Členy

Veřejné konstruktory

Název	Description
CPrintDialog::CPrintDialog	Konstrukce CPrintDialog objektu.

Veřejné metody

Název	Description
CPrintDialog::CreatePrinterDC	Vytváří kontext zařízení tiskárny bez zobrazení dialogového okna Tisk.
CPrintDialog::DoModal	Zobrazí dialogové okno a umožňuje uživateli provést výběr.
CPrintDialog::GetCopies	Zjišťuje počet požadovaných kopií.
CPrintDialog::GetDefaults	Obnoví výchozí nastavení zařízení bez zobrazení dialogového okna.
CPrintDialog::GetDeviceName	Načte název zařízení aktuálně vybranou tiskárnu.
CPrintDialog::GetDevMode	Načte DEVMODE struktury.
CPrintDialog::GetDriverName	Načte název aktuálně vybraného ovladače tiskárny.
CPrintDialog::GetFromPage	Obnoví počáteční stránky rozsah tisku.
CPrintDialog::GetPortName	Načte název portu aktuálně vybranou tiskárnu.
CPrintDialog::GetPrinterDC	Získá popisovač kontextu zařízení tiskárny.
CPrintDialog::GetToPage	Načte koncové stránky rozsah tisku.
CPrintDialog::PrintAll	Určuje, zda všechny stránky dokumentu.
CPrintDialog::PrintCollate	Určuje, zda Kompletovat kopie jsou požadovány.
CPrintDialog::PrintRange	Určuje, zda zadaný rozsah stránek vytisknout.
CPrintDialog::PrintSelection	Určuje, zda chcete vytisknout pouze aktuálně vybrané položky.

Veřejné datové členy

Název	Description
CPrintDialog::m_pd	Struktura se používají k přizpůsobení CPrintDialog objektu.

Poznámky

Společné tiskové v dialogových oknech snadno implementovat dialogových oknech Tisk a nastavení tisku v souladu s normami pro Windows.

[!POZNÁMKA]

CPrintDialogEx Třídy zapouzdří služeb poskytovaných vlastností tisku systému Windows 2000.Další informace naleznete CPrintDialogEx Přehled.

CPrintDialogv případě funkce programem z CPageSetupDialog, které je konstruováno poskytnout dialogové okno společné pro obě vytisknout nastavení a nastavení stránky.

Můžete se spolehnout na rámec zpracovat mnoho aspektů procesu tisku aplikace.V tomto případě rámci automaticky zobrazí Windows společné dialogovém okně pro tisk.Můžete také mají úchyt framework tisku aplikace však přepsat společné dialogové okno Tisk tiskové dialogové.Další informace o použití rozhraní pro zpracování tiskové úlohy naleznete v článku tisku.

Pokud chcete, aby aplikace pro tisk bez zapojení rámci, můžete CPrintDialog s konstruktorem podle třídy tak, jak je", nebo můžete vlastní dialogové okno třídy z CPrintDialog a zápis konstruktor podle svých potřeb.V obou případech budou chovat těchto dialogových jako standardní dialogová okna MFC protože jsou odvozeny od třídy CCommonDialog .

Použít CPrintDialog objekt, vytvořte nejprve pomocí objektu CPrintDialog konstruktor.Jakmile bylo vyrobeno dialogové okno, můžete nastavit nebo změnit všechny hodnoty v m_pd struktury inicializace hodnoty ovládacích prvků dialogové okno. m_pd Struktury je typu PRINTDLG.Další informace na této struktuře naleznete .

Pokud nezadáte vlastní úchyty v m_pd pro hDevMode a hDevNames je členů, volejte funkci Windows GlobalFree pro tyto úchyty po dokončení dialogového okna.Při použití nastavení tisku provádění rámci poskytované CWinApp::OnFilePrintSetup , není nutné uvolnit tyto úchyty.Úchyty udržuje CWinApp a jsou uvolněna v CWinApp 's destruktoru.Je nutné uvolnit tyto úchyty při použití pouze CPrintDialog samostatné.

Po inicializaci ovládacích prvků pole dialogového okna, zavolejte DoModal členské funkce zobrazíte dialogové okno, a umožní uživateli vybrat možnosti tisku.DoModalVrátí se, zda vybrané uživatele na tlačítko OK (IDOK) nebo zrušení (IDCANCEL) tlačítko.

Pokud DoModal vrátí IDOK, můžete použít jednu z CPrintDialog jeho funkce členů načíst informace o vstup uživatele.

CPrintDialog::GetDefaults Členské funkce je užitečná pro načítání aktuální výchozí nastavení tiskárny bez zobrazení dialogového okna.Tato funkce člena nevyžaduje zásah uživatele.

Pomocí systému Windows CommDlgExtendedError funkce určit, zda došlo k chybě při inicializaci dialogové okno a další informace o chybě.Další informace o této funkci naleznete .

CPrintDialogvyužívá COMMDLG.Soubor knihovny DLL dodávaný se systémem Windows verze 3.1 a vyšší.

Dialogové okno Upravit, odvození třídy z CPrintDialog , poskytují vlastní dialogové okno šablony a přidat mapování zprávu zpracovat oznámení z rozšířené ovládací prvky.Všechny nezpracované zprávy by měly být předány základní třídě.Přizpůsobení funkce zavěšení není vyžadováno.

Zpracovat stejné zprávy liší v závislosti na tom, zda je dialogové okno Tisk nebo nastavení tisku, musí odvodit třídu pro každý dialogové okno.Musí také přepsat Windows AttachOnSetup funkci, která zpracovává vytvoření nové dialogové okno vyberete tlačítko Nastavení tisku v dialogovém okně Tisk.

Další informace o použití CPrintDialog , viz Společných tříd dialogové okno.