CHOOSEFONT

המבנה CHOOSEFONT מכיל מידע העושה שימוש בפונקציה ChooseFont כדי לאתחל את תיבת הדו-שיח גופן נפוצות. לאחר שהמשתמש יסגור את תיבת הדו-שיח, המערכת מחזירה מידע אודות הבחירה של המשתמש במבנה זה.

typedef struct {/ / cf DWORD lStructSize; 
    HWND hwndOwner; 
    HDC hDC; 
    LPLOGFONT lpLogFont; 
    INT iPointSize; 
    DWORD דגלים; 
    DWORD rgbColors; 
    LPARAM lCustData; 
    LPCFHOOKPROC lpfnHook; 
    LPCTSTR lpTemplateName; 
    HINSTANCE hInstance; 
    LPTSTR lpszStyle; 
    המילה nFontType; 
    המילה ___MISSING_ALIGNMENT__; 
    INT nSizeMin; 
    INT nSizeMax; 
} CHOOSEFONT 

 

חברים

lStructSize
מציין את האורך, בבתים, של מבנה.
hwndOwner
מזהה את החלון שהוא הבעלים של תיבת הדו-שיח. חבר זה יכול להיות מטפל בחלון חוקי כלשהו, או זה להיות NULL אם תיבת הדו-שיח לא הבעלים.
hDC
מזהה הקשר ההתקן (או מידע הקשר) של המדפסת שאת הגופן שלו תופיע בתיבת הדו-שיח. חבר זה משמש רק אם החבר דגלים מציין את הדגל CF_PRINTERFONTS או CF_BOTH; אחרת, המערכת תתעלם זה חבר.
lpLogFont
מצביע LOGFONT מבנה. אם הגדרת את הדגל CF_INITTOLOGFONTSTRUCT חבר דגלים , לאתחל את החברים LOGFONT , הפונקציה ChooseFont אתחול תיבת הדו-שיח עם גופן הוא הדומה ביותר האפשריים. אם המשתמש לוחץ על לחצן אישור , ChooseFont מגדיר את החברים של מבנה LOGFONT בהתבסס על הבחירות של המשתמש.
iPointSize
מציין את גודל הגופן הנבחר, ביחידות של 1/10 של נקודה. הפונקציה ChooseFont מגדירה ערך זה לאחר שהמשתמש יסגור את תיבת הדו-שיח.
דגלים
ערכת דגלי סיביות בהם באפשרותך להשתמש כדי לאתחל את תיבת הדו-שיח גופן נפוצות. כאשר תיבת הדו-שיח חוזר, הגדרת דגלים אלה כדי לציין הקלט של המשתמש. חבר זה יכול להיות שילוב של הדגלים הבאים:
דגל משמעות
CF_APPLY גורמת לפתיחת תיבת הדו-שיח להציג את לחצן החל. עליך לספק שגרה hook על תהליך WM_COMMAND הודעות עבור לחצן החל. ההליך הוו ניתן לשלוח את ההודעה WM_CHOOSEFONT_GETLOGFONT לתיבת הדו-שיח כדי לאחזר את הכתובת מבנה LOGFONT המכיל את הבחירות הנוכחיות עבור הגופן.
CF_ANSIONLY דגל זה הוא מיושן. כדי להגביל את בחירות גופן כדי למעט אלה העושים שימוש בערכות תווים של OEM או סימן את כל פריטי script, להשתמש CF_SCRIPTSONLY. כדי לקבל את אופן הפעולה של Windows 3.1 CF_ANSIONLY, השתמש CF_SELECTSCRIPT וציין ANSI_CHARSET חבר lfCharSet של מבנה LOGFONT הצביע על-ידי lpLogFont.
CF_BOTH גורמת לפתיחת תיבת הדו-שיח רשימת הגופנים הזמינים במדפסת והן על המסך. חבר hDC מזהה את ההתקן הקשר (או מידע הקשר) המשויכים למדפסת. דגל זה הוא שילוב של הדגלים CF_SCREENFONTS ו- CF_PRINTERFONTS.
CF_TTONLY מציין כי ChooseFont יש רק למנות ולאפשר את הבחירה של גופני TrueType.
CF_EFFECTS גורמת לפתיחת תיבת הדו-שיח להציג את הפקדים לאפשר למשתמש לציין קו חוצה, קו תחתון ואפשרויות צבע טקסט. אם דגל זה מוגדר, באפשרותך להשתמש חבר rgbColors כדי לציין את צבע הטקסט ההתחלתי. באפשרותך להשתמש בני lfStrikeOut , lfUnderline LOGFONT מבנה הצביע על-ידי lpLogFont כדי לציין את הגדרות ראשוניות של תיבות הסימון קו חוצה וקו תחתון. ChooseFont להשתמש חברים אלה כדי להחזיר את הבחירות של המשתמש.
CF_ENABLEHOOK מאפשר את שגרת הוו חבר lpfnHook של מבנה זה.
CF_ENABLETEMPLATE מציין החברים hInstance ו- lpTemplateName לציין תבנית בתיבת הדו-שיח כדי להשתמש במקום תבנית ברירת המחדל.
CF_ENABLETEMPLATEHANDLE מציין החבר hInstance מזהה בלוק נתונים המכיל את תבנית בתיבת הדו-שיח שנטענו מראש. המערכת מתעלמת חבר lpTemplateName אם דגל זה מצוין.
CF_FIXEDPITCHONLY ציון ChooseFont עליך לבחור גופנים ברוחב קבוע בלבד.
CF_FORCEFONTEXIST ציון ChooseFont אמור לציין מצב שגיאה אם המשתמש מנסה לבחור גופן או סגנון שאינו קיים.
CF_INITTOLOGFONTSTRUCT קביעה כי יש להשתמש ChooseFont LOGFONT מבנה הצביע על-ידי חבר lpLogFont כדי לאתחל פקדי תיבת הדו-שיח.
CF_LIMITSIZE ציון ChooseFont עליך לבחור רק את גודלי גופן בטווח המצוין על-ידי חברי nSizeMin , nSizeMax.
CF_NOOEMFONTS זהה הדגל CF_NOVECTORFONTS.
CF_NOFACESEL בעת שימוש במבנה LOGFONT כדי לאתחל פקדי תיבת הדו-שיח, השתמש בדגל זה כדי למנוע באופן סלקטיבי את תיבת הדו-שיח הצגת הבחירה ההתחלתית עבור התיבה המשולבת שם של גופן. פעולה זו שימושית כאשר אין שם גופן יחיד שחל על בחירת הטקסט.
CF_NOSCRIPTSEL מבטל את התיבה המשולבת של ה-Script . כאשר מוגדר דגל זה, על החבר lfCharSet LOGFONT מבנה מוגדר DEFAULT_CHARSET כאשר ChooseFont חוזר. דגל זה משמש רק כדי לאתחל את תיבת הדו-שיח.
CF_NOSTYLESEL בעת שימוש במבנה LOGFONT כדי לאתחל פקדי תיבת הדו-שיח, השתמש בדגל זה כדי למנוע באופן סלקטיבי את תיבת הדו-שיח הצגת הבחירה ההתחלתית עבור התיבה המשולבת של סגנון הגופן. דבר זה שימושי כאשר יש ללא סגנון גופן יחיד שחל על בחירת הטקסט.
CF_NOSIZESEL בעת שימוש LOGFONT מבנה לאתחל פקדי תיבת דו-שיח, השתמש בדגל זה כדי למנוע באופן סלקטיבי את תיבת הדו-שיח הצגת הבחירה ההתחלתית עבור התיבה המשולבת של גודל גופן. דבר זה שימושי כאשר יש לא גודל גופן יחיד שחל על בחירת הטקסט.
CF_NOSIMULATIONS מציין כי ChooseFont אינו אמור לאפשר גרפיקה הדמיות גופן של התקן ממשק (GDI).
CF_NOVECTORFONTS מציין כי ChooseFont אינו אמור לאפשר וקטורית בחירות גופן.
CF_NOVERTFONTS גורמת לפתיחת תיבת הדו-שיח גופן לפרט את גופני בעל כיוון אופקי בלבד.
CF_PRINTERFONTS גורמת לפתיחת תיבת הדו-שיח ברשימה רק את הגופנים נתמכת על-ידי המדפסת המשויך בהקשר התקן (או מידע הקשר) המזוהה על-ידי האיבר hDC.
CF_SCALABLEONLY ציון ChooseFont עליך לאפשר רק את בחירת גופנים מדורגים. (גופנים מדורגים כוללות גופנים וקטוריים, גופני מדפסת מדרגי, גופני TrueType, וגופנים טיפסו על-ידי טכנולוגיות אחרות.)
CF_SCREENFONTS גורמת לפתיחת תיבת הדו-שיח להציג רק את גופני המסך הנתמכות על-ידי המערכת.
CF_SCRIPTSONLY ציון ChooseFont יש לאפשר בחירה של גופנים עבור כל-OEM וסמל תו ערכות, כמו גם ערכת תווי ANSI. פעולה זו מחליפה את הערך CF_ANSIONLY.
CF_SELECTSCRIPT כאשר הקלט, גופני בלבד עם ערכת התווים המזוהים ב- החבר lfCharSet LOGFONT מבנה מוצגים. המשתמש לא ירשו כדי לשנות את ערכת שצוין בתיבה המשולבת קבצי Script התווים.
CF_SHOWHELP גורמת לפתיחת תיבת הדו-שיח להציג את לחצן עזרה . החבר hwndOwner , עליך לציין החלון כדי לקבל את HELPMSGSTRING רשום הודעות בתיבת הדו-שיח השולח כאשר המשתמש לוחץ על לחצן עזרה.
CF_USESTYLE מציין כי נקודות חבר lpszStyle למאגר המכיל נתוני סגנון זה ChooseFont עליך להשתמש כדי לאתחל את התיבה המשולבת של הגופן בסגנון . כאשר המשתמש סוגר את תיבת הדו-שיח, עותקים ChooseFont בסגנון נתונים עבור הבחירה של המשתמש למאגר זה.
CF_WYSIWYG ציון ChooseFont עליך לאפשר רק את בחירת גופנים זמינים גם המדפסת וגם את התצוגה. אם דגל זה מצוין, גם צוינו דגלים CF_BOTH ו- CF_SCALABLEONLY.

rgbColors
אם הדגל CF_EFFECTS מוגדר, rgbColors מציין את צבע הטקסט ההתחלתי. כאשר ChooseFont מחזיר בהצלחה, חבר זה מכיל ערך ה-RGB של צבע הטקסט המשתמש שנבחר.
lCustData
ציון נתונים המוגדרים על-ידי יישום המערכת עובר להליך הוו המזוהה על-ידי חבר lpfnHook . כאשר המערכת שולחת את הודעת WM_INITDIALOG ההליך הוו, פרמטר lParam של ההודעה הוא שמצביע למבנה CHOOSEFONT צוין מתי נוצר בתיבת הדו-שיח. ההליך hook להשתמש במצביע זה כדי לקבל את הערך lCustData.
lpfnHook
מצביע CFHookProc לחבר שגרה אשר ניתן לעבד הודעות המיועד עבור תיבת הדו-שיח. אין התייחסות איבר זה אלא אם הדגל CF_ENABLEHOOK מוגדר חבר דגלים.
lpTemplateName
מצביע מחרוזת המסתיימת ב- null שמות משאבים תבנית בתיבת הדו-שיח במודול המזוהה על-ידי חבר hInstance . תבנית זו כתחליף עבור התבנית בתיבת הדו-שיח הרגילה. עבור משאבים בתיבת הדו-שיח ממוספרת, lpTemplateName עשוי להיות ערך המוחזר על-ידי מאקרו MAKEINTRESOURCE . אין התייחסות איבר זה אלא אם הדגל CF_ENABLETEMPLATE מוגדר חבר דגלים.
hInstance
אם הדגל CF_ENABLETEMPLATEHANDLE מוגדר חבר דגלים , hInstance הוא נקודת האחיזה האובייקט זיכרון המכיל תבנית בתיבת הדו-שיח. אם הדגל CF_ENABLETEMPLATE מוגדר, hInstance מזהה את מודול המכיל תיבת הדו-שיח תבנית בשם על-ידי חבר lpTemplateName . אם לא CF_ENABLETEMPLATEHANDLE ולא CF_ENABLETEMPLATE מוגדר, חבר זה מתעלמת.
lpszStyle
מצביע למאגר המכיל נתוני סגנון. אם תציין את הדגל CF_USESTYLE, ChooseFont משתמש בנתונים במאגר זה כדי לאתחל את התיבה המשולבת של סגנון הגופן. כאשר המשתמש סוגר את תיבת הדו-שיח, ChooseFont מעתיק את המחרוזת בתיבה המשולבת של סגנון הגופן לתוך מאגר זה.
nFontType
מציין את סוג הגופן שנבחר כאשר חוזר ChooseFont . חבר זה יכול להיות שילוב של הערכים הבאים:
ערך משמעות
BOLD_FONTTYPE משקל גופן הוא מודגש. מידע זה הוא לשכפל את חבר lfWeight LOGFONT מבנה והוא שווה ערך FW_BOLD.
ITALIC_FONTTYPE הגדר את התכונה גופן נטוי. מידע זה משוכפלת חבר lfItalic של מבנה LOGFONT.
PRINTER_FONTTYPE הגופן הוא גופן מדפסת.
REGULAR_FONTTYPE משקל גופן נורמלי. מידע זה משוכפלת חבר lfWeight של מבנה LOGFONT , שווה ל- FW_REGULAR.
SCREEN_FONTTYPE הגופן הוא גופן מסך.
SIMULATED_FONTTYPE הגופן מדומה על ידי ממשק התקן גרפי (GDI).

nSizeMin
מציין את הגודל המינימלי נקודת שהמשתמש יכול לבחור. ChooseFont מזהה איבר זה רק אם צוין דגל CF_LIMITSIZE.
nSizeMax
מציין את הגודל המרבי נקודת שהמשתמש יכול לבחור. ChooseFont מזהה איבר זה רק אם צוין דגל CF_LIMITSIZE.

QuickInfo

nbsp; Windows &NT: מחייב גירסה 3.1 או גירסה מתקדמת יותר.
Windows:נדרש Windows 95 או גירסה מתקדמת יותר.
חלונות CE:לא נתמך.
כותרת עליונה:להצהיר על commdlg.h.
Unicode:מוגדר כ- Unicode ומבני ANSI.

ראה גם

סקירה נפוצות על תיבת הדו-שיח ספריית, מבנים נפוצות של תיבת הדו-שיח, ChooseFont, LOGFONT, MAKEINTRESOURCE

Index