PRINTDLGEX

[Je to predbežné dokumentácie a s výhradou zmeniť.]

PRINTDLGEX štruktúra obsahuje informácie, ktoré používa funkciu PrintDlgEx inicializovať Tlačiť hárok vlastností. Po používateľ zavrie hárok vlastností, systém použije túto štruktúru vrátiť informácie o používateľovi výbery.

tYPEDEF struct tagPDEX {
    DWORD lStructSize;
    HWND hwndOwner;
    HGLOBAL parameter hDevMode;
    HGLOBAL hDevNames;
    HDC hDC;
    DWORD Vlajky;
    DWORD Flags2;
    DWORD ExclusionFlags;
    DWORD nPageRanges;
    DWORD nMaxPageRanges;
    LPPRINTPAGERANGE lpPageRanges;
    DWORD nMinPage;
    DWORD nMaxPage;
    DWORD nCopies;
    HINSTANCE hInstance;
    LPCTSTR lpPrintTemplateName;
    LPUNKNOWN lpCallback;
    DWORD nPropertyPages;
    HPROPSHEETPAGE * lphPropertyPages;
    DWORD nStartPage;
    DWORD dwResultAction;
} PRINTDLGEX, * LPPRINTDLGEX 

Členovia

lStructSize
Určuje veľkosť štruktúry v bajtoch.
hwndOwner
Spracovať do okna, ktoré vlastní hárok vlastností. Tento člen musí byť platný okno rukoväť; to nemôže mať hodnotu NULL.
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. PrintDlgEx funkcia používa Inicializácia vstupné datato ovládacie prvky v hárku vlastností. Keď PrintDlgEx vráti, členovia DEVMODE uviesť vstup používateľa.

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

Ď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. PrintDlgEx funkcia používa Inicializácia vstupné datato ovládacie prvky v hárku vlastností. Keď PrintDlgEx 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, PrintDlgEx 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
Rukoväť na 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 Tlačiť hárok vlastností. Ak funkcia PrintDlgEx vráti, nastaví 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 PD_PAGENUMS, PD_SELECTION a PD_CURRENTPAGE príznaky 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 PrintDlgEx vráti, žiadosť musí simulovať zoradenie viacero kópií. Ďalšie informácie nájdete v popise príznak PD_USEDEVMODECOPIESANDCOLLATE.

PD_CURRENTPAGE
Ak tento vlajky je nastavený prepínač Aktuálna stránka je začiarknuté. Ak žiadny z PD_PAGENUMS, PD_SELECTION alebo PD_CURRENTPAGE vlajky je nastavený, je vybratá položka všetky prepínacie tlačidlo.
PD_DISABLEPRINTTOFILE
Vypne začiarknutie políčka Tlačiť do súboru.
PD_ENABLEPRINTTEMPLATE
Udáva, hInstance a lpPrintTemplateName členovia špecifikovať náhradu Predvolená šablóna dialógové okno pole v dolnej časti strany všeobecnej . Predvolená šablóna obsahuje ovládacie prvky môžu podobať krivkám dialógové okno Tlač . Systém používa zadaná šablóna vytvoriť okno, v ktorom je dieťa Všeobecné stránky.
PD_ENABLEPRINTTEMPLATEHANDLE
Označuje členský hInstance identifikuje dátový blok obsahuje šablóny předpjatý dialógové okno pole. Táto šablóna nahrádza predvolenú šablónu dialógové okno pole v dolnej časti Všeobecné stránky. Systém používa zadaná šablóna vytvoriť okno, v ktorom je dieťa Všeobecné stránky. Systém ignoruje členské lpPrintTemplateName ak táto vlajka je zadaná.
PD_EXCLUSIONFLAGS
Označuje členský ExclusionFlags identifikuje položky vylúčiť zo stránok vlastností ovládač tlačiarne. Ak nie je tento príznak, položky budú vylúčené v predvolenom nastavení zo stránok vlastností ovládač tlačiarne. Výnimky, ktoré umožňujú znemožňovali duplicitu položiek medzi Všeobecné stránky, všetky žiadosti uvedené stránky a stránky ovládača tlačiarne.
PD_HIDEPRINTTOFILE
Skryje začiarknutie políčka Tlačiť do súboru.
PD_NOCURRENTPAGE
Vypne Aktuálnu stránku prepínacie tlačidlo.
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 upozorňujúce hlásenie sa zobrazí, keď sa vyskytne chyba.
PD_PAGENUMS
Ak je nastavená táto vlajka, prepínacie tlačidlo stránok je zvolené. Ak žiadny z PD_PAGENUMS, PD_SELECTION alebo PD_CURRENTPAGE vlajky je nastavený, je vybratá položka všetky prepínacie tlačidlo.

Ak táto vlajka je nastavený pri funkcia PrintDlgEx vráti, člen lpPageRanges označuje rozsahy stránok stanovenú používateľom.

PD_PRINTTOFILE
Ak je nastavená táto vlajka je začiarknuté políčko tlač do súboru.

Ak táto vlajka je nastavený, keď PrintDlgEx 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 PrintDlgEx vrátiť zariadenie kontexte zodpovedajúce výbery používateľa v hárku vlastností. Kontexte zariadením vrátené v hDC.
PD_RETURNDEFAULT NEBOL
Ak je nastavená táto vlajka funkciu PrintDlgEx nezobrazuje hárok vlastností. 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 PrintDlgEx vráti chybu.
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 žiadny z PD_PAGENUMS, PD_SELECTION alebo PD_CURRENTPAGE vlajky je nastavený, je vybratá položka všetky prepínacie tlačidlo.

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 PRINTDLGEX 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 PRINTDLGEX š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.


Flags2
Vyhradené; musí byť nulový.
ExclusionFlags
Množina bitové príznaky, ktoré môžu vylúčiť položky zo stránok vlastností ovládača tlačiarne v hárku vlastností tlače . Táto hodnota sa používa len vtedy, ak v členských štátoch vlajky je nastavený príznak PD_EXCLUSIONFLAGS. Vylúčenie príznaky by mali používať len, ak položky vylúčiť budú zahrnuté na ktorejkoľvek stránke Všeobecné alebo stránke definovanom aplikáciou v hárku vlastností tlače . Tento člen môže určiť nasledovné príznak.
PD_EXCL_COPIESANDCOLLATE
Vylučuje kópií a Zoradiť ovládacie prvky zo stránok vlastností ovládača tlačiarne v hárku vlastností tlače . Táto vlajka by mala byť stanovená vždy, keď aplikácia používa predvolené kópií a Zoradiť kontrolám stanoveným v dolnej časti Všeobecné stránky Tlačiť hárok vlastností.

nPageRanges
Na vstup, nastaviť tento člen počiatočné číslo strany rozsahoch špecifikovaných v lpPageRanges poli. Keď funkcia PrintDlgEx vráti, nPageRanges označuje počet rozsahov používateľ zadal stránky uložené v lpPageRanges poli. Ak je určený príznak PD_NOPAGENUMS, táto hodnota nie je platná.
nMaxPageRanges
Určuje veľkosť array prvky lpPageRanges medzipamäte. Táto hodnota označuje maximálny počet rozsahy stránok, ktoré môžu byť uložené v poli. Ak je určený príznak PD_NOPAGENUMS, táto hodnota nie je platná. Ak nie je určený príznak PD_NOPAGENUMS, táto hodnota musí byť väčšia ako nula.
lpPageRanges
Ukazovateľ do medzipamäte obsahujúce zprovoznit PRINTPAGERANGE štruktúry. Na vstup, pole obsahuje úvodnú stránku rozsahy chcete zobraziť v ovládacom prvku editovať stránky . Keď je funkcia PrintDlgEx vráti, pole obsahuje rozsahy stránok stanovenú používateľom.

Ak je určený príznak PD_NOPAGENUMS, táto hodnota nie je platná. Ak nie je zadaná PD_NOPAGENUMS vlajkou, lpPageRanges musí byť NENULOVÝCH.

nMinPage
Určuje minimálnu hodnotu pre stránku rozsahoch špecifikovaných v ovládacom prvku editovať stránky . Ak je určený príznak PD_NOPAGENUMS, táto hodnota nie je platná.
nMaxPage
Určuje maximálnu hodnotu pre stránku rozsahoch špecifikovaných v ovládacom prvku editovať stránky . Ak je určený príznak PD_NOPAGENUMS, táto hodnota nie je platná.
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 PrintDlgEx vracia, nCopies obsahuje skutočný počet kópií žiadosti musí vytlačiť. 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, hInstance je rukoväť prihlášky alebo modul inštanciu, ktorá obsahuje dialógové okno pole šablónu s názvom členskými lpPrintTemplateName . Ak v členských štátoch vlajky je nastavený príznak PD_ENABLEPRINTTEMPLATEHANDLE, hInstance je rukoväť pamäte objekt obsahujúci šablónu dialógové okno pole. Ak ani šablóna vlajky je nastavený v členských štátoch vlajok , hInstance by mala byť NULL.
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 dialógové okno pole v dolnej časti Všeobecné stránky. Predvolená šablóna obsahuje ovládacie prvky môžu podobať krivkám dialógové okno Tlač . Tento člen sa ignoruje, pokiaľ nie je v členských štátoch vlajky je nastavený príznak PD_ENABLEPRINTTEMPLATE.
lpCallback
Ukazovateľ k objektu aplikácie definované spätné volanie.

Objekt by mal obsahovať IPrintDialogCallback triedy hlásenia pre dialógové okno dieťa v dolnej časti Všeobecné stránky.

Objekt spätného volania by mala tiež obsahovať IObjectWithSite triedy prijímať smerník na rozhranie IPrintDialogServices . Volanie funkcie PrintDlgEx Funkcia QueryInterface pre objekt spätného volania IID_IPrintDialogCallback aj IID_IObjectWithSite , určiť, ktoré rozhrania sú podporované.

Ak nechcete získavať informácie spätného volania lpCallback nastavená na hodnotu NULL.

nPropertyPages
Určuje počet popisovačov vlastnosť stránky v lphPropertyPages poli.
lphPropertyPages
Obsahuje pole kľučiek vlastnosť stránky chcete Tlačiť hárok vlastností. Ďalšie stránky vlastností sledovať Všeobecné stránky. Použitie CreatePropertySheetPage funkciu vytvoriť tieto ďalšie stránky. Ak nPropertyPages je nula, lphPropertyPages by mala byť NULL.
nStartPage
Určuje vlastnosť stránku, ktorá je počiatočne zobrazený. Ak chcete zobraziť Všeobecné stránky, zadajte START_PAGE_GENERAL. V opačnom prípade určiť zero-based index stránky vlastností poľa špecifikované v členských lphPropertyPages . Pre konzistencie sa odporúča, aby hárok vlastností byť vždy začal na stránke Všeobecné.
dwResultAction
Na vstup, tento člen nastavia na nulu. Ak funkcia PrintDlgEx vráti S_OK, dwResultAction obsahuje výsledok dialógového okna. Ak PrintDlgEx vráti chybu, tento člen sa ignoruje. DwResultAction člen môže mať tieto hodnoty.
Hodnota Význam
PD_RESULT_APPLY Používateľ klikol na tlačidlo použiť a neskôr klikli na tlačidlo zrušiť . Naznačuje, že používateľ chce uplatnia zmeny vykonané na hárku vlastností, ale nechcete vytlačiť ešte. PRINTDLGEX štruktúra obsahuje informácie špecifikované používateľom v čase bol klikli na tlačidlo použiť.
PD_RESULT_CANCEL Užívateľ klikne na tlačidlo zrušiť . Informácie v štruktúre PRINTDLGEX sa nezmení.
PD_RESULT_PRINT Užívateľ klikne na tlačidlo Tlačiť . PRINTDLGEX štruktúra obsahuje informácie špecifikované používateľom.

Poznámky

Keď budete volať funkciu PrintDlgEx 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ň, PrintDlgEx inicializuje hárok vlastností tlaeiarni špecifikované členskými wDeviceOffset.

Zvyčajne, ak parameter hDevMode a hDevNames sú NULL, PrintDlgEx inicializuje hárok vlastností pomocou aktuálneho predvolenej tlačiarne. Avšak ak parameter hDevMode a hDevNames sú NULL, Príznak PD_RETURNDEFAULT nebol nastavený, PrintDlgEx používa hDevNames a parameter hDevMode členov vrátiť informácie o aktuálne predvolenú tlačiareň bez zobrazovania hárok vlastností.

Počas realizácie PrintDlgEx hodnoty DEVMODE a DEVNAMES štruktúr, ktoré ste zadali v štruktúre PRINTDLGEX nie vždy obsahujú aktuálne údaje. Z tohto dôvodu mali ASIC vlastnosť stránky, rovnako ako IPrintDialogCallback rutiny pre úvodnú stránku používať rozhranie IPrintDialogServices na získanie informácií o stave súčasných tlačiarne.

Stručné informácie

nbsp; Systém Windows &NT: vyžaduje verzia 5.0 alebo novšia.
Windows:Nepodporované.
Windows CE:Nepodporované.
Hlavičky:Deklarovaný v commdlg.h.
Importovať knižnica:Použiť comdlg32.lib.
Unicode:Definovaný formát Unicode a ANSI štruktúry.

Pozri tiež

Common Dialog Box Library Overview, Common Dialog Box Structures, CreateDC, CreateIC, CreatePropertySheetPage, DEVMODE, DEVNAMES, IObjectWithSite, IPrintDialogCallback, IPrintDialogServices, PrintDlgEx

Index