PAGESETUPDLG

PAGESETUPDLGโครงสร้างประกอบด้วยข้อมูลที่ใช้ฟังก์ชันPageSetupDlgจะเริ่มต้นกล่องโต้ตอบหน้าทั่วไปติดตั้ง หลังจากผู้ใช้ ปิดกล่องโต้ตอบระบบส่งกลับข้อมูลเกี่ยวกับพารามิเตอร์หน้าผู้ใช้กำหนดในโครงสร้างนี้ .

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

 

สมาชิก

lStructSize
ระบุขนาด ในไบต์ โครงสร้างนี้.
hwndOwner
ระบุหน้าต่างที่เป็นเจ้าของกล่องโต้ตอบ สมาชิกนี้สามารถถูกหมายเลขอ้างอิงหน้าต่างที่ถูกต้องใด ๆ หรือสามารถเป็นค่า NULL ถ้ากล่องโต้ตอบได้ไม่มีเจ้าของ.
hDevMode
จัดการหน่วยความจำระดับโลกวัตถุที่ประกอบด้วยการ โครงสร้างข้อมูล DEVMODE ในการป้อนข้อมูล ถ้าหมายเลขอ้างอิงได้ถูกกำหนด ค่าในโครงสร้างข้อมูล DEVMODEที่สอดคล้องกันจะใช้เตรียมใช้งานตัวควบคุมในกล่องโต้ตอบ บนผลผลิต โต้ตอบการตั้งค่ากล่องhDevModeกับตัวจัดการหน่วยความจำส่วนกลางสำหรับโครงสร้างข้อมูล DEVMODEที่ประกอบด้วยค่าที่ระบุของผู้ใช้ที่เลือก ถ้าไม่มีผู้เลือก กล่องโต้ตอบการตั้งค่าhDevModeเป็น NULL.
hDevNames
จัดการหน่วยความจำระดับโลกวัตถุที่ประกอบด้วยโครงสร้างแบบDEVNAMES โครงสร้างนี้ประกอบด้วยสามสายอักขระที่ระบุชื่อโปรแกรมควบคุม ชื่อเครื่องพิมพ์ และชื่อพอร์ตผลลัพธ์ ในการป้อนข้อมูล ถ้าหมายเลขอ้างอิงได้ถูกกำหนด สายอักขระในโครงสร้างDEVNAMESที่สอดคล้องกันใช้เตรียมใช้งานตัวควบคุมในกล่องโต้ตอบ บนผลผลิต โต้ตอบการตั้งค่ากล่องhDevNamesกับตัวจัดการหน่วยความจำส่วนกลางสำหรับโครงสร้างแบบDEVNAMESที่ประกอบด้วยสายอักขระที่ระบุของผู้ใช้ที่เลือก ถ้าไม่มีผู้เลือก กล่องโต้ตอบการตั้งค่าhDevNamesเป็น NULL.
ค่าสถานะ
ชุดของค่าสถานะบิตที่คุณสามารถใช้กล่องโต้ตอบหน้าทั่วไปการตั้งค่าการเตรียมใช้งาน เมื่อกล่องโต้ตอบส่งกลับ กำหนดค่าสถานะเหล่านี้เพื่อบ่งชี้ถึงการป้อนข้อมูลของผู้ใช้ สมาชิกนี้สามารถเป็นการรวมกันของค่าสถานะต่อไปนี้ :
PSD_DEFAULTMINMARGINS
ตั้งค่าค่าต่ำสุดที่ผู้ใช้สามารถระบุสำหรับระยะขอบหน้าเป็น ระยะขอบต่ำสุดที่อนุญาต โดยเครื่องพิมพ์ นี่คือค่าเริ่มต้น ธงนี้จะถูกละเว้นถ้ายังมีระบุค่าสถานะ PSD_MARGINS และ PSD_MINMARGINS.
PSD_DISABLEMARGINS
ปิดใช้งานตัวควบคุมขอบ การป้องกันผู้ใช้จากการตั้งค่าระยะขอบ.
PSD_DISABLEORIENTATION
ปิดใช้งานตัวควบคุมการวางแนว การป้องกันผู้ใช้จากการตั้งค่าการวางหน้ากระดาษ.
PSD_DISABLEPAGEPAINTING
ป้องกันไม่ให้กล่องโต้ตอบการวาดเนื้อหาของหน้าตัวอย่าง ถ้าคุณเปิดใช้งานในขั้นตอนของ hook PagePaintHookคุณยังคงสามารถวาดเนื้อหาของหน้าตัวอย่าง.
PSD_DISABLEPAPER
ปิดใช้งานตัวควบคุมกระดาษ การป้องกันผู้ใช้จากการตั้งค่าพารามิเตอร์ของเพจเช่นขนาดกระดาษและแหล่งที่มา.
PSD_DISABLEPRINTER
ปิดใช้งานปุ่มเครื่องพิมพ์การป้องกันไม่ให้ผู้ใช้เรียกใช้กล่องโต้ตอบที่ประกอบด้วยข้อมูลการตั้งค่าเครื่องพิมพ์เพิ่มเติม.
PSD_ENABLEPAGEPAINTHOOK
ช่วยให้ขั้นตอนของ hook ระบุไว้ในสมาชิกlpfnPagePaintHook.
PSD_ENABLEPAGESETUPHOOK
ช่วยให้ขั้นตอนของ hook ระบุไว้ในสมาชิกlpfnPageSetupHook.
PSD_ENABLEPAGESETUPTEMPLATE
บ่งชี้ว่า สมาชิกที่hInstanceและlpPageSetupTemplateNameระบุแม่แบบกล่องโต้ตอบการใช้ในตำแหน่งของแม่แบบเริ่มต้น.
PSD_ENABLEPAGESETUPTEMPLATEHANDLE
บ่งชี้ว่า สมาชิกhPageSetupTemplateที่ระบุข้อมูลบล็อกที่ประกอบด้วยแม่แบบกล่องโต้ตอบที่มากมายใส่ไว้ ระบบสมาชิกlpPageSetupTemplateNameละเว้นถ้ามีระบุค่าสถานะนี้.
PSD_INHUNDREDTHSOFMILLIMETERS
บ่งชี้ว่า มีหน่วยวัดสำหรับระยะขอบในร้อยส่วนของมิลลิเมตร และขนาดกระดาษ ค่าในสมาชิกrtMargin, rtMinMarginและptPaperSizeในร้อยส่วนของมิลลิเมตรได้ คุณสามารถตั้งค่าสถานะนี้บนสัญญาณเข้าแทนที่หน่วยเริ่มต้นของหน่วยวัดสำหรับตำแหน่งกระทำการของผู้ใช้ เมื่อฟังก์ชันจะส่งกลับ การตั้งค่ากล่องโต้ตอบนี้ธงเพื่อระบุหน่วยใช้.
PSD_INTHOUSANDTHSOFINCHES
บ่งชี้ว่า มีหน่วยวัดสำหรับระยะขอบของ thousandths ของนิ้ว และขนาดกระดาษ ค่าในสมาชิกrtMargin, rtMinMarginและptPaperSizeใน thousandths ของนิ้วได้ คุณสามารถตั้งค่าสถานะนี้บนสัญญาณเข้าแทนที่หน่วยเริ่มต้นของหน่วยวัดสำหรับตำแหน่งกระทำการของผู้ใช้ เมื่อฟังก์ชันจะส่งกลับ การตั้งค่ากล่องโต้ตอบนี้ธงเพื่อระบุหน่วยใช้.
PSD_INWININIINTLMEASURE
ไม่สามารถใช้งาน.
PSD_MARGINS
ทำให้ระบบการใช้ค่าที่ระบุในสมาชิกrtMarginที่เป็นความกว้างเริ่มต้นสำหรับด้านซ้าย บน ด้านขวา และระยะขอบล่าง ถ้าไม่มีการตั้งค่า PSD_MARGINS ระบบตั้งค่าเริ่มต้นความกว้างเป็นหนึ่งนิ้วสำหรับระยะขอบทั้งหมด.
PSD_MINMARGINS
ทำให้ระบบการใช้ค่าที่ระบุในสมาชิกrtMinMarginที่เป็นความกว้างยอมขั้นต่ำสำหรับด้านซ้าย บน ด้านขวา และระยะขอบล่าง ระบบป้องกันไม่ให้ผู้ใช้ป้อนความกว้างที่น้อยกว่าค่าต่ำสุดที่ระบุ ถ้า PSD_MINMARGINS ไม่มีระบุ ระบบการตั้งค่าความกว้างยอมขั้นต่ำที่อนุญาตให้ใช้เครื่องพิมพ์.
PSD_NONETWORKBUTTON
ซ่อน และปิดใช้งานปุ่ม'เครือข่าย'.
PSD_NOWARNING
ป้องกันไม่ให้ระบบแสดงข้อความเตือนเมื่อมีไม่มีเครื่องพิมพ์เริ่มต้น.
PSD_RETURNDEFAULT
PageSetupDlgไม่แสดงกล่องโต้ตอบ แทน มันตั้งค่าสมาชิกhDevNamesและhDevModeในการจับเพื่อ โครงสร้างข้อมูล DEVMODEและDEVNAMESที่จะกำหนดค่าเริ่มต้นสำหรับเครื่องพิมพ์เริ่มต้นของระบบ PageSetupDlgส่งกลับข้อผิดพลาดถ้าเป็นhDevNamesหรือhDevModeไม่ใช่ NULL.
PSD_SHOWHELP
ทำให้กล่องโต้ตอบจะแสดงปุ่มที่ช่วยกัน สมาชิกhwndOwnerต้องระบุหน้าต่างไปHELPMSGSTRINGได้รับข้อความที่กล่องโต้ตอบการส่งเมื่อผู้ใช้คลิกที่ปุ่มวิธีใช้ที่ลงทะเบียน.

ptPaperSize
ระบุขนาดของกระดาษที่เลือก โดยผู้ใช้ ค่าสถานะ PSD_INTHOUSANDTHSOFINCHES หรือ PSD_INHUNDREDTHSOFMILLIMETERS ระบุหน่วยวัด.
rtMinMargin
ระบุความกว้างยอมขั้นต่ำสำหรับด้านซ้าย บน ด้านขวา และระยะขอบล่าง ระบบละเว้นสมาชิกนี้ถ้าไม่ได้กำหนดค่าสถานะ PSD_MINMARGINS ค่าเหล่านี้ต้องน้อยกว่า หรือเท่ากับค่าที่ระบุในสมาชิกrtMargin ค่าสถานะ PSD_INTHOUSANDTHSOFINCHES หรือ PSD_INHUNDREDTHSOFMILLIMETERS ระบุหน่วยวัด.
rtMargin
ระบุความกว้างของด้านซ้าย บน ด้านขวา และระยะขอบล่าง ถ้าคุณตั้งค่าสถานะ PSD_MARGINS, rtMarginระบุค่าเริ่มต้นระยะขอบ เมื่อมีการส่งกลับค่าPageSetupDlg , rtMarginมีความกว้างระยะขอบที่เลือก โดยผู้ใช้ ค่าสถานะ PSD_INHUNDREDTHSOFMILLIMETERS หรือ PSD_INTHOUSANDTHSOFINCHES ระบุหน่วยวัด.
hInstance
หากถูกตั้งค่าสถานะ PSD_ENABLEPAGESETUPTEMPLATE ในสถานะสมาชิกhInstanceคือหมายเลขอ้างอิงของแอพลิเคชันหรืออินสแตนซ์ของโมดูลที่ประกอบด้วยแม่แบบกล่องโต้ตอบชื่อ โดยสมาชิกlpPageSetupTemplateName.
lCustData
ระบุข้อมูลที่โปรแกรมประยุกต์ที่กำหนดเองที่ระบบส่งผ่านไปยังขั้นตอนของ hook ที่ระบุ โดยสมาชิกlpfnPageSetupHook เมื่อระบบส่งข้อความWM_INITDIALOGไปขั้นตอนของ hook พารามิเตอร์lParamของข้อความเป็นตัวชี้ไปยังโครงสร้างPAGESETUPDLGระบุเมื่อสร้างการโต้ตอบ ขั้นตอนของ hook สามารถใช้การตั้งค่านี้ชี้เพื่อรับค่าlCustData.
lpfnPageSetupHook
ชี้ไปPageSetupHookของ hook กระบวนงานที่สามารถประมวลผลข้อความสำหรับกล่องโต้ตอบ สมาชิกนี้จะถูกละเว้นเว้นแต่ค่าสถานะ PSD_ENABLEPAGESETUPHOOK ถูกตั้งค่าในสถานะสมาชิก.
lpfnPagePaintHook
ชี้ไปPagePaintHookของ hook กระบวนงานที่ได้รับ WM_PSD_ * ข้อความจากกล่องโต้ตอบเมื่อใดก็ ตามที่มีการวาดใหม่หน้าตัวอย่าง ด้วยการประมวลผลข้อความ ขั้นตอนของ hook สามารถกำหนดลักษณะที่ปรากฏของหน้าตัวอย่าง สมาชิกนี้จะถูกละเว้นเว้นแต่ค่าสถานะ PSD_ENABLEPAGEPAINTHOOK ถูกตั้งค่าในสถานะสมาชิก.
lpPageSetupTemplateName
ตัวชี้เป็นสตริงที่สิ้นสุดด้วยค่า null ที่ชื่อทรัพยากรแม่แบบกล่องโต้ตอบในโมดูลที่ระบุ โดยhInstanceสมาชิก แม่แบบนี้ถูกแทนแม่แบบกล่องโต้ตอบมาตรฐาน สำหรับแหล่งข้อมูลของกล่องโต้ตอบหมายเลขlpPageSetupTemplateNameได้ค่าส่งกลับ โดยแมโคMAKEINTRESOURCE สมาชิกนี้จะถูกละเว้นเว้นแต่ค่าสถานะ PSD_ENABLEPAGESETUPTEMPLATE ถูกตั้งค่าในสถานะสมาชิก.
hPageSetupTemplate
หากถูกตั้งค่าสถานะ PSD_ENABLEPAGESETUPTEMPLATEHANDLE ในสถานะสมาชิกhPageSetupTemplateคือหมายเลขอ้างอิงของวัตถุของหน่วยความจำประกอบด้วยแม่แบบกล่องโต้ตอบ.

หมายเหตุ

ถ้าไม่ระบุค่าสถานะ PSD_INHUNDREDTHSOFMILLIMETERS และ PSD_INTHOUSANDTHSOFINCHES ระบบแบบสอบถามค่า LOCALE_IMEASURE ของระบบภาษาของผู้ใช้เริ่มต้นเพื่อกำหนดหน่วยวัดอย่างใดอย่างหนึ่ง (ในร้อยส่วนของมิลลิเมตร) หรือ thousandths ของนิ้วสำหรับความกว้างระยะขอบและขนาดกระดาษ.

ถ้ามีทั้งhDevNamesและhDevModeถูกต้อง จับและชื่อเครื่องพิมพ์ที่ระบุ โดยสมาชิกwDeviceOffsetของโครงสร้างDEVNAMESไม่เหมือนชื่อที่ระบุ โดยสมาชิกdmDeviceNameของโครงสร้างข้อมูล DEVMODEระบบใช้ชื่อที่ระบุโดยwDeviceOffsetตามค่าเริ่มต้น.

QuickInfo

nbsp Windows &NT:ต้องการรุ่น 3.51 หรือรุ่นที่ใหม่กว่า
Windows:ต้องใช้ Windows 95 หรือรุ่นที่ใหม่กว่า
Windows CE:ไม่สนับสนุน
หัวข้อ:ประกาศใน commdlg.h
Unicode:กำหนดเป็นโครงสร้างแบบ Unicode และ ANSI.

ดูเพิ่มเติม

ภาพรวมไลบรารีของกล่องโต้ตอบทั่วไปโครงสร้างกล่องโต้ตอบทั่วไป DEVMODE, DEVNAMES, MAKEINTRESOURCE, PagePaintHook, PageSetupDlg, PageSetupHook, WM_INITDIALOG

Index