CHOOSEFONT

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

typedef struct { / / cf DWORD lStructSize 
    HWND hwndOwner 
    HDC hDC 
    LPLOGFONT lpLogFont 
    INT iPointSize 
    DWORD Flags 
    DWORD rgbColors 
    LPARAM lCustData 
    LPCFHOOKPROC lpfnHook 
    LPCTSTR lpTemplateName 
    HINSTANCE hInstance 
    LPTSTR lpszStyle 
    WORD 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	ทำให้กล่องโต้ตอบเพื่อแสดงปุ่ม Apply คุณควรให้มีขั้นตอนของ hook ข้อความWM_COMMANDกระบวนการสำหรับปุ่ม Apply ขั้นตอนของ hook สามารถส่งข้อความWM_CHOOSEFONT_GETLOGFONTกับกล่องโต้ตอบเพื่อเรียกใช้อยู่ LOGFONTโครงสร้างที่ประกอบด้วยการเลือกปัจจุบันแบบอักษร.
CF_ANSIONLY	ธงนี้ล้าสมัย เมื่อต้องการจำกัดตัวเลือกแบบอักษรไปยังสคริปต์ทั้งหมดยกเว้นที่ใช้ชุดอักขระ OEM หรือสัญลักษณ์ ใช้ 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	ช่วยให้ขั้นตอนของ hook ระบุไว้ในโครงสร้างนี้กรรมการ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ควรอนุญาตเฉพาะการเลือกแบบอักษรที่ยืดหยุ่น (Scalable อักษรรวมแบบอักษรแบบเวกเตอร์ แบบอักษรเครื่องพิมพ์ที่ยืดหยุ่น แบบ อักษร TrueType และแบบอักษรที่ปรับ โดยเทคโนโลยีอื่น ๆ)
CF_SCREENFONTS	ทำให้กล่องโต้ตอบจะแสดงรายการเฉพาะแบบอักษรของหน้าจอได้รับการสนับสนุน โดยระบบ.
CF_SCRIPTSONLY	ระบุว่าChooseFontควรให้มีการเลือกแบบอักษรสำหรับทั้งหมดไม่ใช่ของ OEM และสัญลักษณ์อักขระชุด เช่นเดียวกับชุดอักขระ ANSI นี้แทนค่า CF_ANSIONLY.
CF_SELECTSCRIPT	เมื่อมีการระบุไว้ในการป้อนข้อมูล อักษรเท่ากับชุดอักขระที่ระบุในสมาชิกlfCharSetของการ LOGFONTโครงสร้างจะแสดง ผู้ใช้จะไม่ได้รับการอนุญาตให้เปลี่ยนการตั้งค่าที่ระบุในกล่องคำสั่งผสมสคริปต์อักขระ.
CF_SHOWHELP	ทำให้กล่องโต้ตอบจะแสดงปุ่มที่ช่วยกัน สมาชิกhwndOwnerต้องระบุหน้าต่างไปHELPMSGSTRINGได้รับข้อความที่กล่องโต้ตอบการส่งเมื่อผู้ใช้คลิกที่ปุ่มวิธีใช้ที่ลงทะเบียน.
CF_USESTYLE	ระบุว่า จุดการบัฟเฟอร์ที่ประกอบด้วยลักษณะข้อมูลสมาชิกlpszStyleที่ChooseFontควรใช้กล่องคำสั่งผสมแบบอักษร ลักษณะการเตรียมใช้งาน เมื่อผู้ใช้ปิดกล่องโต้ตอบChooseFontสำเนาลักษณะข้อมูลสำหรับส่วนที่เลือกของผู้ใช้การบัฟเฟอร์นี้.
CF_WYSIWYG	ระบุว่าChooseFontควรอนุญาตเฉพาะการเลือกแบบอักษรที่พร้อมใช้งานทั้งเครื่องพิมพ์และการแสดง ถ้ามีระบุค่าสถานะนี้ ค่าสถานะ CF_BOTH และ CF_SCALABLEONLY ควรจะระบุ.

rgbColors

หากถูกตั้งค่าสถานะ CF_EFFECTS, rgbColorsระบุสีข้อความเริ่มต้น เมื่อChooseFontส่งกลับเรียบร้อยแล้ว สมาชิกนี้ประกอบด้วยค่า RGB ของสีของข้อความที่ผู้ใช้ที่เลือก.

lCustData

ระบุข้อมูลที่โปรแกรมประยุกต์ที่กำหนดเองที่ระบบส่งผ่านไปยังขั้นตอนของ hook ที่ระบุ โดยสมาชิกlpfnHook เมื่อระบบส่งข้อความWM_INITDIALOGไปขั้นตอนของ hook พารามิเตอร์lParamของข้อความเป็นตัวชี้ไปยังโครงสร้างCHOOSEFONTระบุเมื่อสร้างการโต้ตอบ ขั้นตอนของ hook สามารถใช้การตั้งค่านี้ชี้เพื่อรับค่าlCustData.

lpfnHook

ชี้ไปCFHookProcของ hook กระบวนงานที่สามารถประมวลผลข้อความสำหรับกล่องโต้ตอบ สมาชิกนี้จะถูกละเว้นเว้นแต่ค่าสถานะ 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	แบบอักษรถูกจำลอง โดย graphics device interface (GDI).

nSizeMin

ระบุขนาดของจุดต่ำสุดผู้ใช้สามารถเลือก ChooseFontรู้จักสมาชิกนี้เท่านั้นถ้ามีระบุค่าสถานะ CF_LIMITSIZE.

nSizeMax

ระบุขนาดของจุดสูงสุดผู้ใช้สามารถเลือก ChooseFontรู้จักสมาชิกนี้เท่านั้นถ้ามีระบุค่าสถานะ CF_LIMITSIZE.

QuickInfo

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

ดูเพิ่มเติม

ภาพรวมไลบรารีของกล่องโต้ตอบทั่วไปโครงสร้างกล่องโต้ตอบทั่วไป ChooseFont, LOGFONT, MAKEINTRESOURCE

Index