PAGESETUPDLG

De PAGESETUPDLG structuur bevat informatie die de functie PageSetupDlg gebruikt voor het initialiseren van de Page Setup common dialog box. Nadat de gebruiker het dialoogvenster sluit, geeft het systeem informatie over de gebruiker gedefinieerde paginaparameters in deze structuur.

typedef struct tagPSD {/ / psd DWORD lStructSize; 
    HWND hwndOwner; 
    HGLOBAL hDevMode; 
    HGLOBAL hDevNames; 
    DWORD Vlaggen; 
    PUNT ptPaperSize; 
    RECT rtMinMargin; 
    RECT rtMargin; 
    HINSTANCE hInstance; 
    LPARAM lCustData; 
    LPPAGESETUPHOOK lpfnPageSetupHook; 
    LPPAGEPAINTHOOK lpfnPagePaintHook; 
    LPCTSTR lpPageSetupTemplateName; 
    HGLOBAL hPageSetupTemplate; 
} PAGESETUPDLG, * LPPAGESETUPDLG 
 

Leden

lStructSize
Geeft de grootte, in bytes, van deze structuur.
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 globale geheugen object dat bevat een DEVMODE -structuur. Op input, als een handvat is gegeven, worden de waarden in de bijbehorende DEVMODE -structuur gebruikt voor het initialiseren van de besturingselementen in het dialoogvenster. Op de uitvoer, het dialoogvenster box sets hDevMode aan een globale geheugen handvat voor een DEVMODE -structuur die waarden opgeven van de gebruiker selecties bevat. Als de gebruiker selecties zijn niet beschikbaar, het dialoogvenster hDevMode wordt ingesteld op NULL.
hDevNames
Ingang naar een globale geheugen object waarin een structuur DEVNAMES betrekking hebben . Deze structuur bevat drie tekenreeksen die de naam van het stuurprogramma, de naam van de printer en de naam van de uitgang-poort opgeven. Op input, als een handvat is gegeven, worden de tekenreeksen in de bijbehorende structuur DEVNAMES betrekking hebben gebruikt voor het initialiseren van besturingselementen in het dialoogvenster. Op de uitvoer, het dialoogvenster box sets hDevNames aan een globale geheugen handvat voor een structuur DEVNAMES die tekenreeksen opgeven van selecties van de gebruiker bevatten. Als de gebruiker selecties zijn niet beschikbaar, het dialoogvenster hDevNames wordt ingesteld op NULL.
Vlaggen
Een set van bits vlaggen die u gebruiken kunt voor het initialiseren van de Page Setup common dialog box. 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:
PSD_DEFAULTMINMARGINS
De minimumwaarden die de gebruiker voor de paginamarges van de opgeven kan om de minimale marges toegestaan door de printer worden ingesteld. Dit is de standaardinstelling. Deze vlag wordt genegeerd als de vlag PSD_MARGINS en PSD_MINMARGINS zijn ook opgegeven.
PSD_DISABLEMARGINS
Hiermee schakelt u de marge besturingselementen, te voorkomen dat de gebruiker de marges instellen.
PSD_DISABLEORIENTATION
Hiermee schakelt u de afdrukstand besturingselementen, te voorkomen dat de gebruiker de afdrukstand instellen.
PSD_DISABLEPAGEPAINTING
Hiermee voorkomt dat het dialoogvenster tekening van de inhoud van de voorbeeldpagina. Als u een PagePaintHook haak procedure inschakelt, kunt u nog steeds tekenen de inhoud van de voorbeeldpagina.
PSD_DISABLEPAPER
Hiermee schakelt u de besturingselementen op papier, de gebruiker verhinderen paginaparameters zoals het papierformaat en -bron instellen.
PSD_DISABLEPRINTER
Hiermee schakelt u de knop Printer , verhinderen dat de gebruiker een dialoogvenster met informatie over extra printer setup inroepen.
PSD_ENABLEPAGEPAINTHOOK
Laat de haak-procedure van de lpfnPagePaintHook lid.
PSD_ENABLEPAGESETUPHOOK
Laat de haak-procedure van de lpfnPageSetupHook lid.
PSD_ENABLEPAGESETUPTEMPLATE
Geeft aan dat de leden hInstance en lpPageSetupTemplateName een dialoogvenster vak sjabloon om te gebruiken in plaats van de standaardsjabloon opgeven.
PSD_ENABLEPAGESETUPTEMPLATEHANDLE
Geeft aan dat de hPageSetupTemplate lid identificeert een gegevensblok dat een voorgeladen dialoogvenster vak sjabloon bevat. Het systeem negeert de lpPageSetupTemplateName lid als deze vlag is opgegeven.
PSD_INHUNDREDTHSOFMILLIMETERS
Geeft aan dat honderdsten van millimeter de maateenheid voor marges zijn en papierformaat. De waarden in de rtMargin, rtMinMarginen ptPaperSize leden zijn in honderdsten van millimeter. U kunt deze vlag instellen op input voor het overschrijven van de standaardmaateenheid voor de landinstelling van de gebruiker. Wanneer de functie retourneert, het dialoogvenster box sets deze vlag om aan te geven de eenheden gebruikt.
PSD_INTHOUSANDTHSOFINCHES
Geeft aan dat duizendsten van een inch de maateenheid voor marges zijn en papierformaat. De waarden in de rtMargin, rtMinMarginen ptPaperSize leden zijn in duizendsten van een inch. U kunt deze vlag instellen op input voor het overschrijven van de standaardmaateenheid voor de landinstelling van de gebruiker. Wanneer de functie retourneert, het dialoogvenster box sets deze vlag om aan te geven de eenheden gebruikt.
PSD_INWININIINTLMEASURE
Niet ge´mplementeerd.
PSD_MARGINS
Het systeem gebruikt de waarden die zijn opgegeven in de rtMargin lid als de oorspronkelijke breedte voor de links, boven, rechts, en ondermarges veroorzaakt. Als PSD_MARGINS niet is ingesteld, het systeem de eerste breedte wordt ingesteld op ÚÚn inch voor alle marges.
PSD_MINMARGINS
Het systeem gebruikt de waarden die zijn opgegeven in de rtMinMargin lid als de minimum toegestane breedte voor de links, boven, rechts, en ondermarges veroorzaakt. Het systeem wordt voorkomen dat de gebruiker een breedte die kleiner is dan het opgegeven minimum invoeren. Als PSD_MINMARGINS niet is opgegeven, het systeem de minimale toegestane breedte wordt ingesteld op degenen toegestaan door de printer.
PSD_NONETWORKBUTTON
Wordt verborgen en wordt de knop netwerk uitgeschakeld.
PSD_NOWARNING
Voorkomt dat het systeem een waarschuwingsbericht worden weergegeven wanneer er geen standaardprinter is.
PSD_RETURNDEFAULT
PageSetupDlg weergegeven het dialoogvenster niet. 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. PageSetupDlg wordt een fout geretourneerd als hDevNames of hDevMode niet NULL is.
PSD_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.

ptPaperSize
Hiermee geeft u de afmetingen van het papier geselecteerd door de gebruiker. De PSD_INTHOUSANDTHSOFINCHES of PSD_INHUNDREDTHSOFMILLIMETERS vlag geeft aan de meeteenheden.
rtMinMargin
Hiermee geeft u de minimale toegestane breedte voor de links, boven, rechts, en ondermarges. Het systeem negeert dit lid als de vlag PSD_MINMARGINS is niet ingesteld. Deze waarden moeten kleiner dan of gelijk aan de waarden die zijn opgegeven in de rtMargin lid. De PSD_INTHOUSANDTHSOFINCHES of PSD_INHUNDREDTHSOFMILLIMETERS vlag geeft aan de meeteenheden.
rtMargin
Hiermee geeft u de breedte van de links, boven, rechts en ondermarges. Als u de vlag PSD_MARGINS instelt, geeft rtMargin de initiŰle margewaarden. Wanneer PageSetupDlg wordt geretourneerd, bevat rtMargin de breedte van de marge die de gebruiker selecteert. De PSD_INHUNDREDTHSOFMILLIMETERS of PSD_INTHOUSANDTHSOFINCHES vlag geeft aan de meeteenheden.
hInstance
Als de vlag PSD_ENABLEPAGESETUPTEMPLATE is ingesteld in de vlaggen lid, is hInstance de greep van de toepassing of het exemplaar van de module die het dialoogvenster vak sjabloon met de naam door de lpPageSetupTemplateName lid bevat.
lCustData
Hiermee geeft u de toepassing gedefinieerde gegevens het systeem doorgeeft aan de haak procedure ge´dentificeerd door het lid lpfnPageSetupHook . Wanneer het systeem het bericht WM_INITDIALOG naar de haak procedure verzendt, is van het bericht lParam parameter dat een aanwijzer naar de PAGESETUPDLG structuur opgegeven toen het dialoogvenster werd gemaakt. De haak procedure kunt deze aanwijzer gebruiken om de waarde van lCustData.
lpfnPageSetupHook
Pointer naar een PageSetupHook haak procedure die kan verwerken berichten die bestemd zijn voor het dialoogvenster. Dit lid wordt genegeerd, tenzij de PSD_ENABLEPAGESETUPHOOK vlag is ingesteld in de vlaggen lid.
lpfnPagePaintHook
Pointer naar een PagePaintHook haak procedure die WM_PSD_-berichten ontvangt van het dialoogvenster wanneer de voorbeeldpagina wordt opnieuw getekend. Door het verwerken van de berichten, kunt de haak procedure het uiterlijk van de voorbeeldpagina. Dit lid wordt genegeerd, tenzij de PSD_ENABLEPAGEPAINTHOOK vlag is ingesteld in de vlaggen lid.
lpPageSetupTemplateName
Aanwijzer naar een op null eindigende tekenreeks that names de dialoogvenster vak sjabloon resource in de module ge´dentificeerd door het lid hInstance . Deze sjabloon vervangen door de standaard dialoogvenster vak sjabloon. Voor genummerde dialoogvenster vak resources kunnen lpPageSetupTemplateName een waarde die wordt geretourneerd door de macro MAKEINTRESOURCE . Dit lid wordt genegeerd, tenzij de PSD_ENABLEPAGESETUPTEMPLATE vlag is ingesteld in de vlaggen lid.
hPageSetupTemplate
Als de vlag PSD_ENABLEPAGESETUPTEMPLATEHANDLE is ingesteld in de vlaggen lid, is hPageSetupTemplate het handvat van een geheugen-object met een dialoogvenster vak sjabloon.

Opmerkingen

Als de PSD_INHUNDREDTHSOFMILLIMETERS en PSD_INTHOUSANDTHSOFINCHES flags niet zijn opgegeven, het systeem query uitgevoerd op de LOCALE_IMEASURE waarde van de standaardlandinstelling van de gebruiker om te bepalen van de eenheid (honderdsten van millimeter) of duizendsten van een inch voor de marges en papierformaat.

Als zowel hDevNames als hDevMode geldig zijn grepen en naam van de printer opgegeven door het lid wDeviceOffset van de structuur DEVNAMES betrekking hebben is niet hetzelfde als de naam opgegeven door het lid dmDeviceName van de structuur DEVMODE, het systeem maakt gebruik van de naam die is opgegeven door wDeviceOffset standaard.

Syntaxisinfo

nbsp;áWindows &NT: versie 3.51 of hoger vereist.
Windows:Windows 95 of hoger vereist.
Windows CE:Niet-ondersteunde.
Header:Verklaard in commdlg.h.
Unicode:Gedefinieerd als Unicode en ANSI structuren.

Zie ook

Overzicht van bibliotheek het gemeenschappelijk dialoogvenster, gemeenschappelijke dialoogvenster vak structuren, DEVMODE, DEVNAMES betrekking hebben, MAKEINTRESOURCE, PagePaintHook, PageSetupDlg, PageSetupHook, WM_INITDIALOG

Index