Dialógové okno Tlačiť umožní užívateľovi vybrať možnosti pre konkrétne tlačovú úlohu. Napríklad používateľ zadať tlačiareň používať, rozsah stránok určených na tlač a počet kópií.
Systém Windows NT, verzia 5.0 a vyššia: Ak chcete zobraziť hárok vlastností tlače , ktorá má všeobecný stránky obsahujúce podobné dialógového okna Tlačiť Vyberte ovládacie prvky môžete použiť funkciu PrintDlgEx . Hárok vlastností môže mať dodatočné špecifické pre aplikáciu a špecifické pre ovládač property pages po stránke Všeobecné.
Vytvoriť a zobraziť dialógové okno Tlač inicializuje PRINTDLG štruktúra a preženiete štruktúru s funkciou PrintDlg.
Nasledujúci obrázok znázorňuje typickú dialógové okno Tlačiť.
Ak používateľ klikne na tlačidlo OK , PrintDlg vráti hodnotu TRUE, a používa PRINTDLG štruktúra vrátiť informácie o používateľovi výbery. Napríklad parameter hDevMode a hDevNames členov zvyčajne vráti globálne pamäte rukoväte pre štruktúry DEVMODE a DEVNAMES . Informácie v týchto štruktúr môžu použiť na vytvorenie zariadenie kontext alebo kontext informácie pre vybratú tlačiareň.
Ak používateľ zruší dialógové okno Tlačiť alebo vyskytne chyba, PrintDlg vráti hodnotu FALSE. Môžete určiť príčinu chybu pomocou funkcie CommDlgExtendedError na získanie predĺženej chybové hodnoty.
Dialógové okno Tlačiť obsahuje Rozsah tlače skupinu prepínacích tlačidiel, ktoré určujú, či používateľ chce tlačiť všetky strany, rozsah strán alebo len vybratý text. Pred volaním PrintDlg, môžete nastaviť PD_ALLPAGES, PD_SELECTION alebo PD_PAGENUMS vlajky uviesť, ktoré tlačidlo je pôvodne vybratá. Ak PrintDlg Vracia TRUE, funkcia nastavuje jedným z týchto príznakov označovať používateľa výbery. Ak je nastavený PD_PAGENUMS, nFromPage a nToPage členovia PRINTDLG štruktúra obsahovať počiatočný a koncový stránky stanovenú používateľom. Chcete vypnúť stránky prepínacie tlačidlo jej pridružené z a na úpravy kontroly, nastaviť príznak PD_NOPAGENUMS. Chcete vypnúť prepínacie tlačidlo Výber , nastaviť príznak PD_NOSELECTION.
Okno obsahuje ovládací prvok upraviť, v ktorom používateľ môžete zadať počet kópií na vytlačenie. Ak sa člen parameter hDevMode štruktúry PRINTDLG NENULOVÝCH, člen dmCopies štruktúry DEVMODE určuje počiatočnú hodnotu pre túto kontrolu upraviť. Ak parameter hDevMode má hodnotu NULL, nCopies člen štruktúre PRINTDLG určuje počiatočnú hodnotu. Keď PrintDlg vráti, nCopies zvyčajne označuje počet kópií stanovenú používateľom. Však ak ste nastavili príznak PD_USEDEVMODECOPIESANDCOLLATE pri vytváraní dialógového okna, nCopies je vždy nastavený na hodnotu 1 o návrate a dmCopies člen DEVMODE označuje počet kópií na vytlačenie.
Začiarkavacie políčko Zoradiť označuje, či používateľ chce zoradení strán, ak je tlačíte viac kópií. Je nastavený príznak PD_COLLATE, ak je začiarknuté začiarkavacie políčko Zoradiť . Ak vaša aplikácia nepodporuje viac kópií alebo simulovanej zoradenie, nastaviť príznak PD_USEDEVMODECOPIESANDCOLLATE vlajky členských PRINTDLG štruktúru. Vypne začiarkavacie políčko Zoradiť a Počet kópií ovládanie úprav, ak ovládač tlačiarne podporuje viacero kópií a zoradenie.
Políčko Tlač do súboru signalizuje, či používateľ chce odoslať výstupný súbor ako tlačiareň. Môžete nastaviť príznak PD_PRINTTOFILE tak pôvodne začiarknuté začiarkavacie políčko. Ak chcete skryť políčko, nastaviť príznak PD_HIDEPRINTTOFILE. Ak chcete vypnúť, nastaviť príznak PD_DISABLEPRINTTOFILE. Ak používateľ vyberie možnosť Tlačiť do súboru , PrintDlg nastaví príznak PD_PRINTTOFILE a vráti "súbor:" na odsadení indikované wOutputOffset členského DEVNAMES štruktúru. Keď budete volať StartDoc funkciu chcete spustiť tlač operáciu, zadajte to "súbor:" reťazec v lpszOutput člen DOCINFO štruktúru. Uvedením tohto reťazca spôsobuje tlače subsystému dotaz používateľa pre názov výstupného súboru.
Podľa predvoleného nastavenia dialógového okna Tlačiť vyberte najprv zobrazuje informácie o aktuálne predvolenú tlačiareň. Zabezpečíte priame zobrazíte informácie o inom nainštalovanej tlačiarne podľa inicializuje DEVMODE alebo DEVNAMES štruktúra a pridelenie globálneho pamäte spracovanie štruktúry členovi parameter hDevMode alebo hDevNames . Zariadenie názov, ktorý zadáte v členských štátoch dmDeviceName štruktúry DEVMODE alebo vo wDriverOffset členských DEVNAMES štruktúra musí identifikovať tlačiareň zariadenie, ktoré je tiež zaradená v sekcii [Devices] vyhrať.Súbor INI. PrintDlg vráti chybu, ak sa zariadenie nenachádza v zozname,.
Môžete priamo PrintDlg vytvoriť zariadenie kontext alebo kontext informácie pre tlačiareň stanovením PD_RETURNDC alebo PD_RETURNIC príznak vlajky členských PRINTDLG štruktúru. Funkcia vráti popisovač zariadenia kontext alebo kontext informácie v členských štátoch hDC . Ak používate PD_RETURNDC vlajkou, môžete použiť zariadenie kontexte generovať výstup tlačiarne.
Získavať informácie o predvolenej tlačiarne bez zobrazenia dialógového okna Tlačiť vyberte nastaviť príznak PD_RETURNDEFAULT nebol. V tomto prípade PrintDlg vráti hneď po nastavení členov parameter hDevMode a hDevNames do popisovačov štruktúry obsahujúci informácie.
V predvolenom nastavení zobrazuje PrintDlg hláseniami pri výskyte chyby. Napríklad, funkcia zobrazí chybové hlásenie, ak sú nainštalované žiadne tlačiarne. Chcete zabrániť funkciu zobrazovanie tieto upozorňujúce hlásenia, nastaviť príznak PD_NOWARNING.