PRINTDLG

De PRINTDLG structuur bevat informatie die de functie PrintDlg worden gebruikt voor het initialiseren van het dialoogvenster afdrukken . Nadat de gebruiker het dialoogvenster sluit, het systeem deze structuur gebruikt om informatie over selecties van de gebruiker retourneren.

typedef struct tagPD {/ / pd DWORD lStructSize; 
    HWND hwndOwner; 
    OMGAAN met hDevMode; 
    OMGAAN met hDevNames; 
    HDC hDC; 
    DWORD Vlaggen; 
    WORD nFromPage; 
    WORD nToPage; 
    WORD nMinPage; 
    WORD nMaxPage; 
    WORD nCopies; 
    HINSTANCE hInstance; 
    DWORD lCustData; 
    LPPRINTHOOKPROC lpfnPrintHook; 
    LPSETUPHOOKPROC lpfnSetupHook; 
    LPCTSTR lpPrintTemplateName; 
    LPCTSTR lpSetupTemplateName; 
    OMGAAN met hPrintTemplate; 
    OMGAAN met hSetupTemplate; 
} PRINTDLG 
 

Leden

lStructSize

Geeft de structuur grootte, in bytes.

hwndOwner

Identificeert het venster dat eigenaar is van het dialoogvenster. Dit lid kan elk geldig vensteringang, of het kan worden NULL als het dialoogvenster geen eigenaar heeft.

hDevMode

Ingang naar een object roerende globale geheugen dat bevat een DEVMODE -structuur. Als hDevMode niet nul op de input is, moet u een verplaatsbaar blok geheugen toewijzen voor de DEVMODE -structuur en initialiseren van haar leden. De PrintDlg functie gebruikt de input datato geïnitialiseerd de besturingselementen in het dialoogvenster. Wanneer PrintDlg wordt geretourneerd, de DEVMODE leden geeft aan dat de invoer van de gebruiker.

Als hDevMode NULL op input is, PrintDlg wijst geheugen toe voor de structuur DEVMODE , initialiseert haar leden om aan te geven de invoer van de gebruiker en geeft als resultaat een greep waarmee het.

Als het apparaatstuurprogramma voor de opgegeven printer geen uitgebreide apparaat modi ondersteunt, is hDevMode NULL wanneer PrintDlg geretourneerd.

Als de apparaatnaam (gespecificeerd door het lid dmDeviceName van de DEVMODE -structuur) wordt niet weergegeven in de sectie [devices] van WIN.INI, PrintDlg wordt een fout geretourneerd.

Zie de opmerkingen aan het einde van dit onderwerp voor meer informatie over de hDevMode en hDevNames leden,.

hDevNames

Ingang naar een object roerende globale geheugen waarin een structuur DEVNAMES betrekking hebben . Als hDevNames niet nul op de input is, moet u een verplaatsbaar blok geheugen toewijzen voor de structuur DEVNAMES betrekking hebben en initialiseren van haar leden. De PrintDlg functie gebruikt de input datato geïnitialiseerd de besturingselementen in het dialoogvenster. Wanneer PrintDlg wordt geretourneerd, bevatten de DEVNAMES leden informatie voor de printer gekozen door de gebruiker. U kunt deze informatie gebruiken om een device-context of een informatie-context te maken.

De hDevNames lid kunt worden NULL, in welk geval, PrintDlg wijst geheugen toe aan de structuur DEVNAMES betrekking hebben , de inbreng van haar leden om aan te geven van de gebruiker, wordt geïnitialiseerd en retourneert een handvat dat identificeert het.

Zie de opmerkingen aan het einde van dit onderwerp voor meer informatie over de hDevMode en hDevNames leden,.

hDC

Identificeert een device-context of een informatie-context, afhankelijk van of de vlaggen lid Hiermee geeft u de vlag PD_RETURNDC of PC_RETURNIC. Als geen van beide vlag is opgegeven, is de waarde van dit lid niet gedefinieerd. Als beide vlaggen worden opgegeven, heeft PD_RETURNDC prioriteit.

Vlaggen

Een set van bits vlaggen die u gebruiken kunt voor het initialiseren van gemeenschappelijk in het dialoogvenster afdrukken . Als u in het dialoogvenster als resultaat geeft, wordt deze vlaggen om aan te geven de invoer van de gebruiker. Dit lid kan bestaan uit een combinatie van de volgende vlaggen:

PD_ALLPAGES
	De standaardvlag die aangeeft dat het keuzerondje alle in eerste instantie is geselecteerd. Deze vlag wordt gebruikt als een aanduiding om aan te geven dat de PD_PAGENUMS en PD_SELECTION flags niet zijn opgegeven.
PD_COLLATE
	Als deze vlag is ingesteld, is het selectievakje sorteren ingeschakeld. Als deze vlag is ingesteld wanneer de functie PrintDlg retourneert, moet de toepassing simuleren sortering van meerdere exemplaren. Voor meer informatie, zie de beschrijving van de vlag PD_USEDEVMODECOPIESANDCOLLATE.
PD_DISABLEPRINTTOFILE
	Hiermee schakelt u het selectievakje Afdrukken naar bestand.
PD_ENABLEPRINTHOOK
	Laat de haak in de lpfnPrintHook lid omschreven procedure. Hierdoor is de haak procedure voor het dialoogvenster afdrukken.
PD_ENABLEPRINTTEMPLATE
	Geeft aan dat de leden hInstance en lpPrintTemplateName een vervanging voor de standaard afdrukken dialoogvenster vak sjabloon opgeven.
PD_ENABLEPRINTTEMPLATEHANDLE
	Geeft aan dat de hPrintTemplate lid identificeert een gegevensblok dat een voorgeladen dialoogvenster vak sjabloon bevat. Deze sjabloon vervangt de standaardsjabloon voor in het dialoogvenster afdrukken . Het systeem negeert de lpPrintTemplateName lid als deze vlag is opgegeven.
PD_ENABLESETUPHOOK
	Laat de haak in de lpfnSetupHook lid omschreven procedure. Hierdoor is de haak procedure voor het dialoogvenster Printerinstelling.
PD_ENABLESETUPTEMPLATE
	Geeft aan dat de leden hInstance en lpSetupTemplateName een vervanging voor de standaard Print Setup dialog box sjabloon opgeven.
PD_ENABLESETUPTEMPLATEHANDLE
	Geeft aan dat de hSetupTemplate lid identificeert een gegevensblok dat een voorgeladen dialoogvenster vak sjabloon bevat. Deze sjabloon vervangt de standaardsjabloon voor het dialoogvenster Printerinstelling . Het systeem negeert de lpSetupTemplateName lid als deze vlag is opgegeven.
PD_HIDEPRINTTOFILE
	Verbergt het selectievakje Afdrukken naar bestand.
PD_NONETWORKBUTTON
	Wordt verborgen en wordt de knop netwerk uitgeschakeld.
PD_NOPAGENUMS
	De knop pagina's radio en de bijbehorende bewerken besturingselementen uitgeschakeld.
PD_NOSELECTION
	Hiermee schakelt u de knop selectie radio.
PD_NOWARNING
	Voorkomt dat het waarschuwingsbericht worden weergegeven wanneer er geen standaardprinter is.
PD_PAGENUMS
	Als deze vlag is ingesteld, is de pagina's radio knop geselecteerd. Als deze vlag is ingesteld wanneer de functie PrintDlg retourneert, de nFromPage en nFromPage leden geven aan het eerste en laatste pagina's door de gebruiker opgegeven.
PD_PRINTSETUP
	Het systeem om het dialoogvenster Printerinstelling in plaats van het dialoogvenster afdrukken weergeven.
PD_PRINTTOFILE
	Als deze vlag is ingesteld, is het selectievakje Afdrukken naar bestand geselecteerd. Als deze vlag is ingesteld wanneer de functie PrintDlg retourneert, de offset aangegeven door het lid wOutputOffset van de structuur DEVNAMES bevat de tekenreeks "bestand:". Wanneer u belt de StartDoc functie om de afdrukken bewerking, te starten dit opgeven "bestand:" tekenreeks in het lid lpszOutput van de DOCINFO structuur. Het afdruksubsysteem opvragen van de gebruiker voor de naam van het uitvoerbestand opgeeft deze tekenreeks, wordt.
PD_RETURNDC
	Veroorzaakt PrintDlg om terug te keren een apparaatcontext die overeenkomen met de selecties van de gebruiker heeft aangebracht in het dialoogvenster. De device-context wordt geretourneerd in hDC.
PD_RETURNDEFAULT
	Als deze vlag is ingesteld, wordt de functie PrintDlg niet in het dialoogvenster weergegeven. In plaats daarvan, de hDevNames en hDevMode leden stelt deze ingangen naar DEVMODE en DEVNAMES structuren die voor de standaardprinter van systeem zijn geïnitialiseerd. Zowel hDevNames als hDevMode moet NULL of PrintDlg wordt een fout geretourneerd. Als de standaardprinter van systeem wordt ondersteund door een oude printer driver (eerder dan Windows versie 3.0), wordt alleen hDevNames geretourneerd; hDevMode is NULL.
PD_RETURNIC
	Vergelijkbaar met de vlag PD_RETURNDC, behalve deze vlag een context voor informatie in plaats van een device-context retourneert. Als noch PD_RETURNDC noch PD_RETURNIC is opgegeven, is hDC undefined op uitgang.
PD_SELECTION
	Als deze vlag is ingesteld, is de knop selectie radio geselecteerd. Als noch PD_PAGENUMS noch PD_SELECTION is ingesteld, is het keuzerondje alle geselecteerd.
PD_SHOWHELP
	Het dialoogvenster weergeven op de knop Help wordt. De hwndOwner lid moet opgeven het venster voor het ontvangen van de HELPMSGSTRING geregistreerd berichten die in het dialoogvenster worden verzonden wanneer de gebruiker op de knop Help.
PD_USEDEVMODECOPIES
	Hetzelfde als PD_USEDEVMODECOPIESANDCOLLATE
PD_USEDEVMODECOPIESANDCOLLATE
	Deze vlag geeft aan of uw toepassing meerdere exemplaren en sortering ondersteunt. Deze vlag instellen op input om aan te geven dat uw toepassing biedt geen ondersteuning voor meerdere exemplaren en sortering. In dit geval het lid nCopies van de PRINTDLG -structuur geeft altijd 1 als resultaat, en PD_COLLATE is nooit ingesteld in de vlaggen lid. Als deze vlag niet is ingesteld, is de toepassing verantwoordelijk voor het afdrukken en meerdere exemplaren sorteren. In dit geval het lid nCopies van de PRINTDLG -structuur geeft het aantal exemplaren die de gebruiker wil afdrukken, en de PD_COLLATE vlag in de vlaggen lid geeft aan of de gebruiker wil sortering. Ongeacht of deze vlag is ingesteld, een toepassing kunt bepalen van nCopies en PD_COLLATE hoeveel exemplaren u wilt renderen en of u wilt afdrukken van hen gesorteerd. Als deze vlag is ingesteld en het printerstuurprogramma biedt geen ondersteuning voor meerdere exemplaren, is het besturingselement kopieën bewerken uitgeschakeld. Evenzo, als deze vlag is ingesteld en het printerstuurprogramma biedt geen ondersteuning voor sortering, het selectievakje sorteren is uitgeschakeld. De dmCopies en dmCollate leden van de DEVMODE -structuur de kopieën bevatten en verzamelen van informatie door het printerstuurprogramma gebruikt. Als deze vlag is ingesteld en het printerstuurprogramma meerdere kopieën ondersteunt, geeft lid van de dmCopies het aantal kopieën dat door de gebruiker is aangevraagd. Als deze vlag is ingesteld en het printerstuurprogramma sortering ondersteunt, het lid dmCollate van de structuur DEVMODE geeft aan of de gebruiker wil sortering. Als deze vlag niet is ingesteld, lid van de dmCopies retourneert altijd 1, en lid van de dmCollate is altijd nul.

nFromPage

Hiermee geeft u de initiële waarde voor het besturingselement start pagina bewerken.

Wanneer PrintDlg wordt geretourneerd, is nFromPage de beginpagina door de gebruiker opgegeven. Als de pagina's radio knop is geselecteerd wanneer de gebruiker op de knop oke , PrintDlg sets de PD_PAGENUMS vlag en niet tot invoert de gebruiker een beginwaarde van pagina die binnen het minimum aan maximale paginabereik.

Windows 95: Als de invoerwaarde voor nFromPage of nToPage buiten het bereik van nMinPage en nMaxPage is, PrintDlg een fout geretourneerd.

Windows NT: Als de invoerwaarde voor nFromPage of nToPage is buiten de minimum/maximum bereik, PrintDlg geeft als resultaat een fout alleen als de vlag PD_PAGENUMS is opgegeven; anders, het dialoogvenster wordt weergegeven, maar verandert de waarde uit het bereik de minimale of maximale waarde.

nToPage

Hiermee geeft u de initiële waarde voor de einddatum besturingselement pagina bewerken.

Wanneer PrintDlg wordt geretourneerd, is nToPage de laatste pagina die wordt opgegeven door de gebruiker. Als de pagina's radio knop is geselecteerd wanneer het gebruik klikt op de knop oke , PrintDlg sets de PD_PAGENUMS vlag en niet tot de gebruiker invoert een einddatum pagina waarde die is binnen het minimum aan maximale paginabereik.

nMinPage

Hiermee geeft u de minimumwaarde voor de paginabereik dat is opgegeven in de besturingselementen van en naar pagina bewerken. Als nMinPage gelijk is aan nMaxPage, zijn de knop pagina's radio en het eerste en laatste pagina bewerken besturingselementen uitgeschakeld.

nMaxPage

Hiermee geeft u de maximumwaarde voor de paginabereik dat is opgegeven in de besturingselementen van en naar pagina bewerken.

nCopies

Bevat het eerste nummer van kopieën voor de invoervakken kopieën als hDevMode NULL is; anders, het lid dmCopies van de DEVMODE -structuur bevat de initiële waarde. Wanneer PrintDlg wordt geretourneerd, bevat nCopies het werkelijke aantal af te drukken exemplaren. Deze waarde is afhankelijk van of de toepassing of het printerstuurprogramma verantwoordelijk is voor het afdrukken van meerdere exemplaren. Als de vlag PD_USEDEVMODECOPIESANDCOLLATE is ingesteld in de vlaggen lid, nCopies is altijd 1 op terugkeer, en het printerstuurprogramma is verantwoordelijk voor het afdrukken van meerdere exemplaren. Als de vlag niet is ingesteld, is de toepassing verantwoordelijk voor het afdrukken van het aantal opgegeven door nCopiesexemplaren. Voor meer informatie, zie de beschrijving van de vlag PD_USEDEVMODECOPIESANDCOLLATE.

hInstance

Als de vlag PD_ENABLEPRINTTEMPLATE of PD_ENABLESETUPTEMPLATE is ingesteld in de vlaggen lid, is hInstance de greep van de toepassing of het exemplaar van de module waarin de dialoogvenster vak sjabloon genaamd door het lid lpPrintTemplateName of lpSetupTemplateName.

lCustData

Hiermee geeft u de toepassing gedefinieerde gegevens het systeem doorgeeft aan de haak procedure geïdentificeerd door het lid lpfnPrintHook of lpfnSetupHook . Wanneer het systeem het bericht WM_INITDIALOG naar de haak procedure verzendt, is van het bericht lParam parameter dat een aanwijzer naar de PRINTDLG structuur opgegeven toen het dialoogvenster werd gemaakt. De haak procedure kunt deze aanwijzer gebruiken om de waarde van lCustData.

lpfnPrintHook

Pointer naar een PrintHookProc haak procedure die kan verwerken berichten die bestemd zijn voor in het dialoogvenster afdrukken . Dit lid wordt genegeerd, tenzij de PD_ENABLEPRINTHOOK vlag is ingesteld in de vlaggen lid.

lpfnSetupHook

Pointer naar een SetupHookProc haak procedure die berichten die bestemd zijn voor het dialoogvenster Printerinstelling kunt verwerken. Dit lid wordt genegeerd, tenzij de PD_ENABLESETUPHOOK vlag is ingesteld in de vlaggen lid.

lpPrintTemplateName

Aanwijzer naar een op null eindigende tekenreeks that names een dialoogvenster vak sjabloon resource in de module geïdentificeerd door het lid hInstance . Deze sjabloon vervangt de standaard afdrukken dialoogvenster vak sjabloon. Dit lid wordt genegeerd, tenzij de PD_ENABLEPRINTTEMPLATE vlag is ingesteld in de vlaggen lid.

lpSetupTemplateName

Aanwijzer naar een op null eindigende tekenreeks that names een dialoogvenster vak sjabloon resource in de module geïdentificeerd door het lid hInstance . Deze sjabloon vervangt de standaardsjabloon Print Setup dialog box. Dit lid wordt genegeerd, tenzij de PD_ENABLESETUPTEMPLATE vlag is ingesteld in de vlaggen lid.

hPrintTemplate

Als de vlag PD_ENABLEPRINTTEMPLATEHANDLE is ingesteld in de vlaggen lid, is hPrintTemplate het handvat van een geheugen-object met een dialoogvenster vak sjabloon. Deze sjabloon vervangt de standaard afdrukken dialoogvenster vak sjabloon.

hSetupTemplate

Als de vlag PD_ENABLESETUPTEMPLATEHANDLE is ingesteld in de vlaggen lid, is hSetupTemplate het handvat van een geheugen-object met een dialoogvenster vak sjabloon. Deze sjabloon vervangt de standaardsjabloon Print Setup dialog box.

Opmerkingen

Wanneer u de PrintDlg functie aanroepen, zorg ervoor dat het lid wDeviceOffset van de structuur DEVNAMES betrekking hebben is identiek aan het lid dmDeviceName van de de structuur DEVMODE . Als deze leden niet dezelfde printer opgeeft, initialiseert PrintDlg het dialoogvenster gebruik van de printer opgegeven door de wDeviceOffset lid.

Meestal, als zowel hDevMode als hDevNames NULL, PrintDlg initialiseert het dialoogvenster met behulp van de huidige standaardprinter. Als echter de vlag PD_RETURNDEFAULT is ingesteld en zowel hDevMode als hDevNames NULL zijn, PrintDlg gebruikt de hDevNames en hDevMode leden om informatie te retourneren over de huidige standaardprinter zonder het dialoogvenster weer te geven.

Syntaxisinfo

nbsp; Windows &NT: versie 3.1 of hoger vereist.
Windows:Windows 95 of hoger vereist.
Windows CE:Versie 1.0 of hoger vereist.
Header:Verklaard in winspool.h.
Unicode:Gedefinieerd als Unicode en ANSI structuren.

Zie ook

Overzicht van bibliotheek het gemeenschappelijk dialoogvenster, gemeenschappelijke dialoogvenster vak structuren, CreateDC, CreateIC, PrintDlg, WM_INITDIALOG DEVMODE, DEVNAMES betrekking hebben,

Index