PAGESETUPDLG

המבנה PAGESETUPDLG מכיל מידע שהפונקציה PageSetupDlg משתמשת כדי לאתחל את תיבת הדו-שיחהגדרת עמודנפוצות. לאחר שהמשתמש יסגור את תיבת הדו-שיח, המערכת מחזירה מידע אודות פרמטרי עמוד המוגדרים על-ידי המשתמש במבנה זה .

typedef struct tagPSD {/ / psd DWORD lStructSize; 
    HWND hwndOwner; 
    HGLOBAL hDevMode; 
    HGLOBAL hDevNames; 
    DWORD דגלים; 
    נקודת 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
מונעת ציור את התוכן של עמוד דוגמה של תיבת הדו-שיח. אם תפעיל שגרה הוו PagePaintHook , עדיין באפשרותך לצייר את התוכן של עמוד דוגמה.
PSD_DISABLEPAPER
מבטל את הפקדים נייר, מניעת הגדרת פרמטרי עמוד כגון גודל הנייר ואת המקור על-ידי המשתמש.
PSD_DISABLEPRINTER
הופכת ללא זמין את לחצן מדפסת , המשתמש שהוא מונע תיבת דו-שיח המכילה מידע התקנה של מדפסת נוספות.
PSD_ENABLEPAGEPAINTHOOK
מאפשר את שגרת הוו חבר lpfnPagePaintHook.
PSD_ENABLEPAGESETUPHOOK
מאפשר את שגרת הוו חבר 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
ציון נתונים המוגדרים על-ידי יישום המערכת עובר להליך הוו המזוהה על-ידי חבר lpfnPageSetupHook . כאשר המערכת שולחת את הודעת WM_INITDIALOG ההליך הוו, פרמטר lParam של ההודעה הוא שמצביע למבנה PAGESETUPDLG צוין מתי נוצר בתיבת הדו-שיח. ההליך hook להשתמש במצביע זה כדי לקבל את הערך lCustData.
lpfnPageSetupHook
מצביע PageSetupHook לחבר שגרה אשר ניתן לעבד הודעות המיועד עבור תיבת הדו-שיח. אין התייחסות איבר זה אלא אם הדגל PSD_ENABLEPAGESETUPHOOK מוגדר חבר דגלים.
lpfnPagePaintHook
מצביע PagePaintHook לחבר בהליך שאינו מקבל WM_PSD_ * הודעות מתיבת הדו-שיח בכל פעם עמוד דוגמה מצויר. על-ידי עיבוד ההודעות, ההליך הוו להתאים אישית את המראה של עמוד דוגמה. אין התייחסות איבר זה אלא אם הדגל 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 או גירסה מתקדמת יותר.
חלונות CE:לא נתמך.
כותרת עליונה:להצהיר על commdlg.h.
Unicode:מוגדר כ- Unicode ומבני ANSI.

ראה גם

סקירה נפוצות על תיבת הדו-שיח ספריית, מבנים נפוצות של תיבת הדו-שיח, DEVMODE, DEVNAMES, MAKEINTRESOURCE, PagePaintHook, PageSetupDlg, PageSetupHook, WM_INITDIALOG

Index