PRINTDLG

PRINTDLG štruktúra obsahuje informácie, ktoré používa funkciu PrintDlg inicializovať dialógové okno Tlač . Po používateľ zavrie dialógové okno, systém použije túto štruktúru vrátiť informácie o používateľovi výbery.

tYPEDEF struct tagPD {/ / pd DWORD lStructSize; 
    HWND hwndOwner; 
    ZVLÁDNUŤ parameter hDevMode; 
    ZVLÁDNUŤ hDevNames; 
    HDC hDC; 
    DWORD Vlajky; 
    SLOVO nFromPage; 
    SLOVO nToPage; 
    SLOVO nMinPage; 
    SLOVO nMaxPage; 
    SLOVO nCopies; 
    HINSTANCE hInstance; 
    DWORD lCustData; 
    LPPRINTHOOKPROC lpfnPrintHook; 
    LPSETUPHOOKPROC lpfnSetupHook; 
    LPCTSTR lpPrintTemplateName; 
    LPCTSTR lpSetupTemplateName; 
    ZVLÁDNUŤ hPrintTemplate; 
    ZVLÁDNUŤ hSetupTemplate; 
} PRINTDLG 
 

Členovia

lStructSize
Určuje veľkosť štruktúry v bajtoch.
hwndOwner
Identifikuje okna, že vlastní dialógového okna. Tento člen môže byť akékoľvek platné okno rukoväť, alebo môže mať hodnotu NULL, ak dialógovom okne žiadne vlastníka.
parameter hDevMode
Rukoväť na hnuteľný globálne pamäťového objektu, ktorý obsahuje štruktúry DEVMODE . Ak parameter hDevMode nie je NULL na vstupoch, musíte prideliť pohyblivými blok pamäte pre štruktúru DEVMODE a inicializovať svojich členov. Funkcia PrintDlg využíva vstupné datato inicializovať ovládacie prvky v dialógovom okne. Keď PrintDlg vráti, členovia DEVMODE uviesť vstup používateľa.

Ak parameter hDevMode je NULL na vstupoch, PrintDlg alokuje pamäť pre štruktúru DEVMODE , inicializuje svojich členov označovať vstup používateľa a vráti rukoväť, ktorá označuje ho.

Ak ovládač zariadenia pre zadaný tlačiareň nepodporuje režimoch rozšíreného zariadenie, parameter hDevMode má hodnotu NULL, ak PrintDlg vracia.

Ak názov zariadenia (špecifikované v dmDeviceName štruktúry DEVMODE ) sa nezobrazí v sekcii [devices] WIN.INI, PrintDlg vráti chybu.

Ďalšie informácie o parameter hDevMode a hDevNames členov nájdete v sekcii poznámky na konci tejto témy.

hDevNames
Rukoväť na hnuteľný globálne pamäte objekt, ktorý obsahuje DEVNAMES konštrukciu. Ak hDevNames nie je NULL na vstupoch, musíte prideliť pohyblivými blok pamäte pre štruktúru DEVNAMES a inicializovať svojich členov. Funkcia PrintDlg využíva vstupné datato inicializovať ovládacie prvky v dialógovom okne. Keď PrintDlg vráti, DEVNAMES členmi obsahujú informácie pre tlačiareň, užívateľ zvolil. Tieto informácie môžete použiť na vytvorenie zariadenie kontext alebo kontext informácie.

HDevNames člen môže mať hodnotu NULL, v tomto prípade, PrintDlg alokuje pamäť pre štruktúru DEVNAMES initializes vstupného svojich členov, aby uvádzať užívateľa, a vracia a rukoväte ktorá identifikuje.

Ďalšie informácie o parameter hDevMode a hDevNames členov nájdete v sekcii poznámky na konci tejto témy.

hDC
Identifikuje zariadenie kontext alebo kontext informácie, v závislosti od toho, či vlajky členských určuje PD_RETURNDC alebo PC_RETURNIC príznak. Ak je zadaná ani vlajkou, hodnota tohto člena je nedefinovaný. Ak sú oba príznaky, PD_RETURNDC má prednosť.
Príznaky
Množina bitové príznaky, ktoré môžete použiť pri inicializácii spoločnej dialógové okno Tlačiť . Keď dialógovom okne vráti, stanovuje tieto príznaky označovať vstup používateľa. Tento člen môže byť kombináciou nasledovné príznaky:
PD_ALLPAGES
Predvolené príznak, ktorý určuje pôvodne vybraným všetky prepínacie tlačidlo. Tento príznak sa používa na naznačujú, že príznaky PD_PAGENUMS a PD_SELECTION nie sú špecifikované ako zástupný symbol.
PD_COLLATE
Ak je nastavená táto vlajka je začiarknuté začiarkavacie políčko Zoradiť.

Ak táto vlajka je nastavený pri funkcia PrintDlg vráti, žiadosť musí simulovať zoradenie viacero kópií. Ďalšie informácie nájdete v popise príznak PD_USEDEVMODECOPIESANDCOLLATE.

PD_DISABLEPRINTTOFILE
Vypne začiarknutie políčka Tlačiť do súboru.
PD_ENABLEPRINTHOOK
Umožňuje háku postupom špecifikovaným v členských lpfnPrintHook . Toto umožňuje príslušná procedúra dialógového okna Tlač.
PD_ENABLEPRINTTEMPLATE
Označuje, že členovia hInstance a lpPrintTemplateName určiť náhrada za predvolenú šablónu pre pole Print dialógové okno.
PD_ENABLEPRINTTEMPLATEHANDLE
Označuje členský hPrintTemplate identifikuje dátový blok obsahuje šablóny předpjatý dialógové okno pole. Táto šablóna nahrádza predvolenú šablónu pre dialógové okno Tlač . Systém ignoruje členské lpPrintTemplateName ak táto vlajka je zadaná.
PD_ENABLESETUPHOOK
Umožňuje háku postupom špecifikovaným v členských lpfnSetupHook . Toto umožňuje príslušná procedúra pre dialógové okno Nastavenie tlače.
PD_ENABLESETUPTEMPLATE
Označuje, že hInstance a lpSetupTemplateName členov určiť náhradné pre predvolenéNastavenie tlačedialógové okno pole šablónu .
PD_ENABLESETUPTEMPLATEHANDLE
Označuje členský hSetupTemplate identifikuje dátový blok obsahuje šablóny předpjatý dialógové okno pole. Táto šablóna nahrádza predvolenú šablónu pre dialógové okno Nastavenie tlače . Systém ignoruje členské lpSetupTemplateName ak táto vlajka je zadaná.
PD_HIDEPRINTTOFILE
Skryje začiarknutie políčka Tlačiť do súboru.
PD_NONETWORKBUTTON
Kože a vypína tlačidlo sieť.
PD_NOPAGENUMS
Vypne prepínacie tlačidlo stránky a súvisiace úpravy kontroly.
PD_NOSELECTION
Vypne Výber prepínacie tlačidlo.
PD_NOWARNING
Zabraňuje zobrazeniu pri predvolenej tlačiarne upozorňujúce hlásenie.
PD_PAGENUMS
Ak táto vlajka je nastavený, je vybratý prepínač stránky.

Ak táto vlajka je nastavený pri funkcia PrintDlg vráti, nFromPage a nFromPage členovia naznačujú počiatočný a koncový stránky stanovenú používateľom.

PD_PRINTSETUP
Spôsobí, že systém zobrazíte dialógové okno Nastavenie tlače skôr ako dialógové okno Tlač.
PD_PRINTTOFILE
Ak je nastavená táto vlajka je začiarknuté políčko tlač do súboru.

Ak táto vlajka je nastavený pri funkcia PrintDlg vráti, kompenzovať indikované wOutputOffset členského DEVNAMES štruktúra obsahuje reťazec „súbor: ". 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.

PD_RETURNDC
Spôsobuje PrintDlg vrátiť zariadenie kontexte zodpovedajúce výbery vykonané v dialógovom okne používateľom. Kontexte zariadením vrátené v hDC.
PD_RETURNDEFAULT NEBOL
Ak je nastavená táto vlajka funkciu PrintDlg dialógovom okne nezobrazí. Namiesto toho ju nastaví členov hDevNames a parameter hDevMode popisovače hodnoty DEVMODE a DEVNAMES štruktúry, ktoré sú inicializovaný pre predvolenú systémovú tlačiareň. HDevNames a parameter hDevMode musí byť NULL alebo PrintDlg vráti chybu.

Ak predvolenú systémovú tlačiareň je podporovaná (staršie ako systém Windows verzie 3.0) staré ovládač, vráti sa len hDevNames ; parameter hDevMode má hodnotu NULL.

PD_RETURNIC
Podobne ako PD_RETURNDC vlajkou, okrem tento príznak vráti informácie kontexte skôr ako zariadenie kontexte. Ak je zadaná PD_RETURNDC ani PD_RETURNIC hDC je neurčený na výstupe.
PD_SELECTION
Ak táto vlajka je nastavený, je vybratý prepínač výberu.

Ak je nastavený PD_PAGENUMS ani PD_SELECTION, všetky prepínacie tlačidlo je začiarknuté.

PD_SHOWHELP
Spôsobuje dialógovom okne zobraziť tlačidlo Pomocník . HwndOwner člen musí špecifikovať okno prijímať HELPMSGSTRING registrované správy, že keď používateľ klikne na tlačidlo Pomocník sa pošle dialógového okna.
PD_USEDEVMODECOPIES
Rovnaké ako PD_USEDEVMODECOPIESANDCOLLATE
PD_USEDEVMODECOPIESANDCOLLATE
Tento príznak udáva, či vaša aplikácia podporuje viacero kópií a zoradenie. Nastaviť túto vlajku na vstupe označiť vaša aplikácia nepodporuje viaceré kópie a zoradenie. V tomto prípade nCopies člen štruktúre PRINTDLG vždy vráti 1 a PD_COLLATE sa nikdy sada do zástavy členských.

Ak nie je tento príznak, aplikácia je zodpovedné za tlač a porovnávaním viacero kópií. V tomto prípade nCopies členského PRINTDLG štruktúra označuje počet kópií užívateľ chce tlač a PD_COLLATE príznak v členských štátoch vlajok udáva, či používateľ chce zoradenie.

Bez ohľadu na to či je nastaviť túto vlajku, žiadosť môžete určiť z nCopies a PD_COLLATE, koľko kópií chcete vykresliť a či sa majú tlačiť ich usporiadať.

Ak je nastavená táto vlajka a ovládač tlačiarne nepodporuje viacero kópií, upraviť kontrolných kópií je vypnutá. Podobne, ak je nastavená táto vlajka a ovládač tlačiarne nepodporuje zoradenie, začiarkavacie políčko Zoradiť je vypnuté.

DmCopies a dmCollate členov štruktúry DEVMODE obsahovať kópie a porovnávať informácie používa ovládač tlačiarne. Ak je nastavená táto vlajka a ovládač tlačiarne podporuje viacero kópií, člen dmCopies označuje počet kópií, ktoré požaduje užívateľ. Ak je nastavená táto vlajka a ovládač tlačiareň podporuje zoradenie, dmCollate člen štruktúry DEVMODE označuje, či používateľ chce zoradenie. Ak nie je nastavená táto vlajka, členské dmCopies vždy vráti 1 a dmCollate člen bude vždy nula.


nFromPage
Určuje počiatočnú hodnotu kontrolu počiatočný upraviť stránku.

Ak PrintDlg vracia, nFromPage je Východisková stránka stanovenú používateľom. Ak prepínač stránky sa vyberie, keď používateľ klikne na tlačidlo v pohodě , PrintDlg súpravy PD_PAGENUMS vlajky a nevráti do používateľ zadá východiskový stránky hodnotu, ktorá je v rozmedzí minimálneho maximálne stranu rozsahu.

Systém Windows 95: PrintDlg vráti chybu, ak vstupné hodnoty pre nFromPage alebo nToPage je mimo rozsah určený nMinPage a nMaxPage,.

Systém Windows NT: Ak vstupná hodnota pre nFromPage alebo nToPage je mimo rozsahu minimálna a maximálna PrintDlg vráti chybu iba vtedy, ak je určený príznak PD_PAGENUMS; v opačnom prípade zobrazí dialógové okno, ale zmení hodnota mimo rozsahu na minimálnej alebo na maximálnej hodnote.

nToPage
Určuje počiatočnú hodnotu kontrolu koncový upraviť stránku.

Keď PrintDlg vráti, nToPage je koncový stránka stanovenú používateľom. Ak stránky prepínacie tlačidlo je vybratá použitie klikne na tlačidlo v pohodě , PrintDlg súpravy PD_PAGENUMS vlajky a nevráti dovtedy, kým používateľ zadá koncovú stranu hodnotu, ktorá je v rozmedzí minimálneho maximálne stranu rozsahu.

nMinPage
Určuje minimálnu hodnotu pre rozsah strán uvedených v kontrolách upraviť stránku od a do . Ak nMinPage rovná nMaxPage, prepínacie tlačidlo stránky a počiatočný a konečný ovládacích prvkoch na úpravu stránky sú vypnuté.
nMaxPage
Určuje maximálnu hodnotu pre rozsah strán uvedených v kontrolách upraviť stránku z a do.
nCopies
Obsahuje počiatočné číslo kópie upraviť kontrolu kópie Ak parameter hDevMode má hodnotu NULL; v opačnom prípade člen dmCopies DEVMODE štruktúra obsahuje počiatočnú hodnotu. Ak PrintDlg vracia, nCopies obsahuje skutočný počet kópií na vytlačenie. Táto hodnota závisí od toho, či aplikácia alebo ovládač tlačiarne je zodpovedné za tlač viacerých kópií. Ak v členských štátoch vlajky je nastavený príznak PD_USEDEVMODECOPIESANDCOLLATE, nCopies je vždy 1 o návrate a ovládač tlačiarne je zodpovedné za tlač viacerých kópií. Ak nie je nastavený príznak, aplikácia je zodpovedné za tlač počet kópií špecifikuje nCopies. Ďalšie informácie nájdete v popise príznak PD_USEDEVMODECOPIESANDCOLLATE.
hInstance
Ak v členských štátoch vlajky je nastavený príznak PD_ENABLEPRINTTEMPLATE alebo PD_ENABLESETUPTEMPLATE, hInstance je rukoväť prihlášky alebo modul inštanciu, ktorá obsahuje dialógové okno pole šablónu s názvom lpPrintTemplateName alebo lpSetupTemplateName člen.
lCustData
Určuje definovanom aplikáciou údaje, ktoré systém odovzdá príslušná procedúra identifikované členskými lpfnPrintHook alebo lpfnSetupHook . Keď systém odošle hlásenie WM_INITDIALOG príslušná procedúra, správu lParam parameter je smerník na štruktúru PRINTDLG uvedené, kedy bol vytvorený dialógového okna. Príslušná procedúra môžete použiť tento ukazovateľ na získanie hodnoty lCustData.
lpfnPrintHook
Smerník na PrintHookProc háku postup, ktorý môže spracovávať správy určené pre dialógové okno Tlač . Tento člen sa ignoruje, pokiaľ nie je v členských štátoch vlajky je nastavený príznak PD_ENABLEPRINTHOOK.
lpfnSetupHook
Smerník na SetupHookProc háku postup, ktorý môže spracovávať správy určené pre dialógové okno Nastavenie tlače . Tento člen sa ignoruje, pokiaľ nie je v členských štátoch vlajky je nastavený príznak PD_ENABLESETUPHOOK.
lpPrintTemplateName
Ukazovateľ na reťazec zakončený, že názvy prostriedok dialógové okno pole Šablóna v module identifikované členskými hInstance . Táto šablóna nahrádza predvolenú šablónu pre pole Print dialógové okno. Tento člen sa ignoruje, pokiaľ nie je v členských štátoch vlajky je nastavený príznak PD_ENABLEPRINTTEMPLATE.
lpSetupTemplateName
Ukazovateľ na reťazec zakončený, že názvy prostriedok dialógové okno pole Šablóna v module identifikované členskými hInstance . Táto šablóna nahrádza predvolené Nastavenie tlače dialógové okno políčka šablóny. Tento člen sa ignoruje, pokiaľ nie je v členských štátoch vlajky je nastavený príznak PD_ENABLESETUPTEMPLATE.
hPrintTemplate
Ak v členských štátoch vlajky je nastavený príznak PD_ENABLEPRINTTEMPLATEHANDLE, hPrintTemplate je rukoväť pamäte objekt obsahujúci šablónu dialógové okno pole. Táto šablóna nahrádza predvolenú šablónu pre pole Print dialógové okno.
hSetupTemplate
Ak v členských štátoch vlajky je nastavený príznak PD_ENABLESETUPTEMPLATEHANDLE, hSetupTemplate je rukoväť pamäte objekt obsahujúci šablónu dialógové okno pole. Táto šablóna nahrádza predvolené Nastavenie tlače dialógové okno políčka šablóny.

Poznámky

Keď budete volať funkciu PrintDlg mať istotu, či wDeviceOffset členského DEVNAMES štruktúra je identická s členom dmDeviceName štruktúry DEVMODE . Ak títo členovia nezadávajte rovnakú tlačiareň, PrintDlg inicializuje dialógovým oknom tlaeiarni špecifikované členskými wDeviceOffset.

Zvyčajne, ak parameter hDevMode a hDevNames sú NULL, PrintDlg inicializuje dialógové aktuálnu predvolenú tlačiareň. Avšak, ak parameter hDevMode a hDevNames sú NULL, Príznak PD_RETURNDEFAULT nebol nastavený, PrintDlg používa hDevNames a parameter hDevMode členov vrátiť informácie o aktuálnej predvolenej tlačiarne bez zobrazenia dialógového okna.

Stručné informácie

nbsp; Systém Windows &NT: vyžaduje verzia 3.1 alebo novšia.
Windows:Vyžaduje systém Windows 95 alebo novším.
Windows CE:Vyžaduje verziu 1.0 alebo novšiu verziu.
Hlavičky:Deklarovaný v winspool.h.
Unicode:Definovaný formát Unicode a ANSI štruktúry.

Pozri tiež

Spoločné Prehľad dialógového okna Knižnica, spoločné Dialog Box štruktúry, CreateDC CreateIC, PrintDlg, DEVMODE, DEVNAMES, WM_INITDIALOG

Index