PAGESETUPDLG

PAGESETUPDLG -strukturen inneholder informasjon som PageSetupDlg -funksjonen bruker til å initialisere Pagefelles dialogboksen . Når brukeren lukker dialogboksen, returnerer systemet informasjon om parameterne brukerdefinerte siden i denne strukturen .

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

 

Medlemmer

lStructSize
Angir størrelsen, i byte, på denne strukturen.
hwndOwner
Identifiserer vinduet som eier dialogboksen. Dette medlemmet kan være en hvilken som helst gyldig vindus-handle, eller det kan være NULL Hvis dialogboksen har ingen eier.
hDevMode
Håndtere til en global minne-objekt som inneholder en strukturen DEVMODE . Hvis en referanse er gitt, brukes verdiene i den definerte strukturen DEVMODE tilsvarende for inndata som initialiserer kontrollene i dialogboksen. På en utdataene håndtere dialogboksen angir hDevMode til en global minne for en DEVMODE -struktur som inneholder verdier som angir brukerens valg. Hvis brukerens valg ikke er tilgjengelig, angir dialogboksen hDevMode til NULL.
hDevNames
Håndtere til en global minne-objekt som inneholder en DEVNAMES struktur. Denne strukturen inneholder tre strenger som angir drivernavnet skrivernavnet og portnavnet for utdata. Hvis en referanse er gitt, brukes strengene i tilsvarende DEVNAMES strukturen på inndata, initialisere kontroller i dialogboksen. På en utdataene håndtere dialogboksen angir hDevNames til en global minne for en DEVNAMES struktur som inneholder strenger som angir brukerens valg. Hvis brukerens valg ikke er tilgjengelig, angir dialogboksen hDevNames til NULL.
Flagg
Et sett med Bitflagg som du kan bruke til å initialisere Pagefelles dialogboksen . Når dialogboksen returnerer, setter det disse flaggene for å angi brukerens inndata. Dette medlemmet kan være en kombinasjon av følgende flagg :
PSD_DEFAULTMINMARGINS
Angir minste verdiene som brukeren kan angi for sidemargene, å være til minimumsverdiene for margene tillatt av skriveren. Dette er standard. Dette flagget ignoreres hvis flaggene PSD_MARGINS og PSD_MINMARGINS er også angitt.
PSD_DISABLEMARGINS
Deaktiverer margkontrollene, hindrer brukeren i å angi margene.
PSD_DISABLEORIENTATION
Deaktiverer retning kontrollene, hindrer brukeren i å angi retningen på.
PSD_DISABLEPAGEPAINTING
Hindrer at dialogboksen tegning innholdet av eksempelsiden. Hvis du aktiverer en PagePaintHook hook-prosedyre, kan du fortsatt tegne innholdet av eksempelsiden.
PSD_DISABLEPAPER
Deaktiverer papir kontrollene, hindrer brukeren i å angi parametere for siden, for eksempel papirstørrelse og -kilde.
PSD_DISABLEPRINTER
Deaktiverer skriver -knappen, og hindre brukeren i å kjøre en dialogboks som inneholder oppsettinformasjon for tilleggsdrivere for utskrift.
PSD_ENABLEPAGEPAINTHOOK
Aktiverer hook-prosedyre som er angitt i lpfnPagePaintHook -medlem.
PSD_ENABLEPAGESETUPHOOK
Aktiverer hook-prosedyre som er angitt i lpfnPageSetupHook -medlem.
PSD_ENABLEPAGESETUPTEMPLATE
Angir at hInstance og lpPageSetupTemplateName -medlemmer angir en dialog boks mal som skal brukes i stedet for standardmalen.
PSD_ENABLEPAGESETUPTEMPLATEHANDLE
Angir at medlemmet hPageSetupTemplate identifiserer en datablokk som inneholder en mal for forhåndslagrede dialogboksen-boksen. Systemet ignorerer medlemmet lpPageSetupTemplateName Hvis dette flagget er angitt.
PSD_INHUNDREDTHSOFMILLIMETERS
Angir at hundredeler av millimeter er målenheten for marger og papirstørrelse. Verdiene i rtMargin, rtMinMarginog ptPaperSize -medlemmer er i hundredeler av millimeter. Du kan angi dette flagget på inndata til å overstyre standard målenhet for brukerens innstillinger. Når funksjonen returnerer, boksen dialogboksen angir dette flagget for å angi enhetene brukes.
PSD_INTHOUSANDTHSOFINCHES
Angir at tusendeler av tommer er målenheten for marger og papirstørrelse. Verdiene i rtMargin, rtMinMarginog ptPaperSize -medlemmer er i tusendeler av tommer. Du kan angi dette flagget på inndata til å overstyre standard målenhet for brukerens innstillinger. Når funksjonen returnerer, boksen dialogboksen angir dette flagget for å angi enhetene brukes.
PSD_INWININIINTLMEASURE
Ikke implementert.
PSD_MARGINS
Fører til at systemet du vil bruke verdiene som er angitt i rtMargin -medlem som de innledende breddene for venstre, topp, høyre og nederste margene. Hvis PSD_MARGINS ikke er angitt, setter systemet innledende bredder til én tomme for alle marger.
PSD_MINMARGINS
Fører til at systemet du vil bruke verdiene som er angitt i rtMinMargin -medlem som de minste tillatte breddene for venstre, topp, høyre og nederste margene. Systemet hindrer brukeren i å angi en bredde som er mindre enn angitt minimum. Hvis PSD_MINMARGINS ikke er angitt, angir systemet minste tillatte bredden til de som er tillatt av skriveren.
PSD_NONETWORKBUTTON
Skjuler og deaktiverer knappen nettverk.
PSD_NOWARNING
Forhindrer systemet fra å vise en advarsel når det er no default printer.
PSD_RETURNDEFAULT
PageSetupDlg vises ikke i dialogboksen. I stedet, det setter hDevNames og hDevMode medlemmene til referanser til DEVMODE og DEVNAMES strukturer som er initialisert for standardskriveren for systemet. PageSetupDlg returnerer en feil hvis hDevMode eller hDevNames , ikke er NULL.
PSD_SHOWHELP
Fører til dialogboksen for å vise Hjelp -knappen. HwndOwner -medlem må angi i vinduet for å motta HELPMSGSTRING registrert meldinger som dialogboksen sender når brukeren klikker Hjelp -knappen.

ptPaperSize
Angir størrelsen på papiret som er valgt av brukeren. PSD_INTHOUSANDTHSOFINCHES eller PSD_INHUNDREDTHSOFMILLIMETERS-flagg angir målenhetene.
rtMinMargin
Angir minste tillatte bredden for venstre, topp, høyre og nederste margene. Systemet ignorerer dette medlemmet hvis flagget PSD_MINMARGINS ikke er angitt. Disse verdiene må være mindre enn eller lik verdiene som er angitt i rtMargin -medlem. PSD_INTHOUSANDTHSOFINCHES eller PSD_INHUNDREDTHSOFMILLIMETERS-flagg angir målenhetene.
rtMargin
Angir bredden på venstre, topp, høyre og nederste margene. Hvis du angir PSD_MARGINS-flagg, angir rtMargin første margverdiene. Når PageSetupDlg kommer tilbake, inneholder rtMargin bredden på margene som er valgt av brukeren. PSD_INHUNDREDTHSOFMILLIMETERS eller PSD_INTHOUSANDTHSOFINCHES-flagg angir målenhetene.
hInstance
Hvis flagget PSD_ENABLEPAGESETUPTEMPLATE er angitt i flagg -medlem, er hInstance håndtaket på programmet eller modul-forekomsten som inneholder dialogboksen boksen malen kalt av lpPageSetupTemplateName -medlemmet.
lCustData
Angir en programdefinert data som systemet sender til Bindingsprosedyren identifisert av lpfnPageSetupHook -medlemmet. Når systemet sender meldingen WM_INITDIALOG til Bindingsprosedyren, er meldingens lParam -parameteren en peker til PAGESETUPDLG strukturen angitt da dialogboksen ble opprettet. Bindingsprosedyren kan bruke denne pekeren til å hente verdien lCustData.
lpfnPageSetupHook
Pekeren til en PageSetupHook hook-prosedyre som kan behandle meldinger som er ment for dialogboksen. Dette medlemmet ignoreres hvis ikke flagget PSD_ENABLEPAGESETUPHOOK er angitt i flagg -medlem.
lpfnPagePaintHook
Pekeren til en PagePaintHook hook-prosedyre som mottar WM_PSD_ * meldinger fra dialogboksen hver gang eksempelsiden tegnes. Ved å behandle meldingene, kan Bindingsprosedyren tilpasse utseendet på eksempelsiden. Dette medlemmet ignoreres hvis ikke flagget PSD_ENABLEPAGEPAINTHOOK er angitt i flagg -medlem.
lpPageSetupTemplateName
Pekeren til en null-terminert streng som navngir dialogboksen boksen mal ressurs i modulen identifisert av hInstance -medlemmet. Denne malen er erstattet med malen standard dialog-boksen. For nummererte dialogboksen boksen ressurser, kan lpPageSetupTemplateName være en verdi returneres av MAKEINTRESOURCE -makroen. Dette medlemmet ignoreres hvis ikke flagget PSD_ENABLEPAGESETUPTEMPLATE er angitt i flagg -medlem.
hPageSetupTemplate
Hvis flagget PSD_ENABLEPAGESETUPTEMPLATEHANDLE er angitt i flagg -medlem, er hPageSetupTemplate håndtaket av en minne-objekt som inneholder en dialog boks-mal.

Merknader

Hvis flaggene PSD_INHUNDREDTHSOFMILLIMETERS og PSD_INTHOUSANDTHSOFINCHES ikke er angitt, spørring systemet LOCALE_IMEASURE verdien av standard lokale innstillinger til å bestemme enheten enten (hundredeler av millimeter) eller tusendeler av tommer for margbredder og papirstørrelse.

Hvis både hDevNames og hDevMode har gyldig angitt håndtak og skrivernavnet av wDeviceOffset -medlemmet av DEVNAMES strukturen er ikke det samme som navnet angitt av dmDeviceName -medlemmet av den definerte strukturen DEVMODE , systemet bruker navnet som angis av wDeviceOffset som standard.

Hurtiginformasjon

nbsp; Windows &NT: krever versjon 3.51 eller senere.
Windows:Krever Windows 95 eller senere.
Windows CE:Som ikke støttes.
Topptekst:Deklarert i commdlg.h.
Unicode:Definert som Unicode- og ANSI-strukturer.

Se også

Felles biblioteket dialogboksoversikt, felles dialogboksen boksen strukturer, DEVMODE, DEVNAMES, MAKEINTRESOURCE, PagePaintHook, PageSetupDlg, PageSetupHook, WM_INITDIALOG

Index