FINDREPLACE

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

typedef struct { / / fr DWORD lStructSize 
    HWND hwndOwner 
    HINSTANCE hInstance 
    DWORD Flags 
    LPTSTR lpstrFindWhat 
    LPTSTR lpstrReplaceWith 
    WORD wFindWhatLen 
    WORD wReplaceWithLen 
    LPARAM lCustData 
    LPFRHOOKPROC lpfnHook 
    LPCTSTR lpTemplateName 
} FINDREPLACE 

 

สมาชิก

lStructSize
ระบุความยาว ไบต์ โครงสร้าง.
hwndOwner
ระบุหน้าต่างที่เป็นเจ้าของกล่องโต้ตอบ กระบวนงานหน้าต่างของหน้าต่างที่ระบุได้รับข้อความ FINDMSGSTRING จากกล่องโต้ตอบ สมาชิกนี้สามารถถูกจับหน้าต่างที่ถูกต้อง แต่มันต้องไม่เป็นค่า NULL.
hInstance
หากถูกตั้งค่าสถานะ FR_ENABLETEMPLATEHANDLE ในสถานะสมาชิกhInstanceคือหมายเลขอ้างอิงของวัตถุของหน่วยความจำประกอบด้วยแม่แบบกล่องโต้ตอบ หากถูกตั้งค่าสถานะ FR_ENABLETEMPLATE, hInstanceระบุโมดูลที่ประกอบด้วยแบบกล่องโต้ตอบที่มีชื่อ โดยlpTemplateNameสมาชิก ถ้าไม่มีการตั้งค่า สมาชิกนี้จะถูกละเว้น.
ค่าสถานะ
ชุดของค่าสถานะบิตที่คุณสามารถใช้กล่องโต้ตอบการเตรียมใช้งาน ชุดกล่องโต้ตอบค่าสถานะเหล่านี้เมื่อส่ง FINDMSGSTRING การลงทะเบียนข้อความเพื่อแสดงการป้อนข้อมูลของผู้ใช้ สมาชิกนี้สามารถเป็นการรวมกันของค่าสถานะต่อไปนี้:
ค่าสถานะ ความหมาย
FR_DIALOGTERM
ถ้าการตั้งค่าในความ FINDMSGSTRING บ่งชี้ว่า มีการปิดกล่องโต้ตอบ เมื่อคุณได้รับข้อความที่ตั้งค่าสถานะนี้ การจัดการหน้าต่างกล่องโต้ตอบที่ส่งกลับ โดยฟังก์ชันFindTextหรือReplaceTextจะไม่ถูกต้อง.
FR_DOWN
ถ้าชุด ปุ่มลงของปุ่มในกล่องโต้ตอบค้นหาวิทยุทิศทางเลือกเพื่อบ่งชี้ที่ คุณควรค้นหาจากตำแหน่งปัจจุบันไปยังจุดสิ้นสุดของเอกสาร ถ้า ไม่มีเลือกชุด ปุ่มขึ้นดังนั้นคุณควรค้นหาไปยังจุดเริ่มต้นของเอกสาร คุณสามารถตั้งค่าสถานะนี้กล่องโต้ตอบการเตรียมใช้งาน ถ้ากำหนดไว้ในข้อความ FINDMSGSTRING บ่งชี้ของผู้ใช้ที่เลือก.
FR_ENABLEHOOK
ทำให้ฟังก์ชันของ hook ระบุในสมาชิกlpfnHook ธงนี้ใช้ในการเริ่มต้นกล่องโต้ตอบเท่านั้น.
FR_ENABLETEMPLATE
บ่งชี้ว่า สมาชิกที่hInstanceและlpTemplateNameระบุแม่แบบกล่องโต้ตอบการใช้ในตำแหน่งของแม่แบบเริ่มต้น ธงนี้ใช้ในการเริ่มต้นกล่องโต้ตอบเท่านั้น.
FR_ENABLETEMPLATEHANDLE
บ่งชี้ว่า สมาชิกhInstanceที่ระบุข้อมูลบล็อกที่ประกอบด้วยแม่แบบกล่องโต้ตอบที่มากมายใส่ไว้ ระบบสมาชิกlpTemplateNameละเว้นถ้ามีระบุค่าสถานะนี้.
FR_FINDNEXT
ถ้าการตั้งค่าในความ FINDMSGSTRING บ่งชี้ว่า ผู้ใช้คลิกปุ่มค้นหา ถัดไปในกล่องโต้ตอบการค้นหาหรือแทน สมาชิกlpstrFindWhatระบุสายอักขระการค้นหา.
FR_HIDEUPDOWN
ถ้าตั้งค่าเมื่อเริ่มต้นกล่องโต้ตอบการค้นหาซ่อนปุ่มค้นหาทิศวิทยุ.
FR_HIDEMATCHCASE
ถ้ากล่องกาเครื่องหมายในชุดเมื่อกำลังเตรียมใช้งานการค้นหาหรือแทนกล่องโต้ตอบ ซ่อนMatchCase .
FR_HIDEWHOLEWORD
ถ้ากล่องกาเครื่องหมายในการตั้งค่าเมื่อเริ่มต้นการค้นหาหรือแทนกล่องโต้ตอบ ซ่อนตรงกันทั้งคำเท่านั้น .
FR_MATCHCASE
ถ้าชุด กล่องกาเครื่องหมายตรงตาม ตัวพิมพ์เลือกเพื่อบ่งชี้ที่ การค้นหาควรจะคำนึงถึงตัวพิมพ์ ถ้า ไม่ตั้งค่า กล่องกาเครื่องหมายเป็นไม่ได้ตรวจสอบเพื่อการค้นหาควรหรือไม่ คุณสามารถตั้งค่าสถานะนี้กล่องโต้ตอบการเตรียมใช้งาน ถ้ากำหนดไว้ในข้อความ FINDMSGSTRING บ่งชี้ของผู้ใช้ที่เลือก.
FR_NOMATCHCASE
ถ้ากล่องกาเครื่องหมายในชุดเมื่อเริ่มต้นการค้นหาหรือแทนกล่องโต้ตอบ ปิดใช้งานการจับคู่กรณี .
FR_NOUPDOWN
ถ้าตั้งค่าเมื่อเริ่มต้นกล่องโต้ตอบการค้นหาการปิดใช้งานปุ่มค้นหาทิศวิทยุ.
FR_NOWHOLEWORD
ถ้ากล่องกาเครื่องหมายในชุดเมื่อเริ่มต้นการค้นหาหรือแทนกล่องโต้ตอบ ปิดใช้งานทั้งWord .
FR_REPLACE
ถ้าการตั้งค่าในความ FINDMSGSTRING บ่งชี้ว่า ผู้ใช้คลิกปุ่มการแทนที่ในกล่องโต้ตอบแทน สมาชิกlpstrFindWhatระบุสายอักขระการแทน และสมาชิกlpstrReplaceWithระบุสายอักขระการแทน.
FR_REPLACEALL
ถ้าการตั้งค่าในความ FINDMSGSTRING บ่งชี้ว่า ผู้ใช้คลิกปุ่มการแทน ทั้งหมดในกล่องโต้ตอบแทน สมาชิกlpstrFindWhatระบุสายอักขระการแทน และสมาชิกlpstrReplaceWithระบุสายอักขระการแทน.
FR_SHOWHELP
ทำให้กล่องโต้ตอบจะแสดงปุ่มที่ช่วยกัน สมาชิกhwndOwnerต้องระบุหน้าต่างไปHELPMSGSTRINGได้รับข้อความที่กล่องโต้ตอบการส่งเมื่อผู้ใช้คลิกที่ปุ่มวิธีใช้ที่ลงทะเบียน.
FR_WHOLEWORD
ถ้าชุดตรง ทั้ง คำ เฉพาะกล่องกาเครื่องหมายเลือกเพื่อบ่งชี้ที่ คุณควรค้นหาเฉพาะคำทั้งหมดที่ตรงกับสายอักขระการค้นหา ถ้า ไม่ตั้งค่า กล่องกาเครื่องหมายจะไม่ได้ตรวจสอบดังนั้นคุณควรค้นหาการกระจายตัวของคำที่ตรงกับสายอักขระการค้นหา คุณสามารถตั้งค่าสถานะนี้กล่องโต้ตอบการเตรียมใช้งาน ถ้ากำหนดไว้ในข้อความ FINDMSGSTRING บ่งชี้ของผู้ใช้ที่เลือก.

lpstrFindWhat
ชี้การบัฟเฟอร์ที่ข้อความFINDMSGSTRINGใช้ผ่านสายอักขระการค้นหาค่า null ที่หยุดการทำงานที่ผู้ใช้พิมพ์ลงในการค้นหาว่าตัวควบคุมที่มีแก้ไข คุณต้องจัดสรรบัฟเฟอร์แบบไดนามิก หรือใช้อาร์เรย์แบบสากล หรือคงที่เพื่อที่จะไม่ไปจากขอบเขตก่อนที่ปิดกล่องโต้ตอบ บัฟเฟอร์ที่ควรมีความยาวอักขระอย่างน้อย 80 ตัว ถ้าบัฟเฟอร์ที่ประกอบด้วยสตริเมื่อคุณเริ่มต้นกล่องโต้ตอบ สายอักขระจะปรากฏในตัวควบคุมแก้ไขค้นหาอะไร .

หากข้อความ FINDMSGSTRING ระบุค่าสถานะ FR_FINDNEXT, lpstrFindWhatมีสายอักขระการค้นหา FR_DOWN, FR_WHOLEWORD และ FR_MATCHCASE ค่าสถานะบ่งชี้ทิศทางและชนิดของการค้นหา หากข้อความ FINDMSGSTRING ระบุค่าสถานะ FR_REPLACE หรือ FR_REPLACE, lpstrFindWhatมีสายอักขระถูกแทนที่.

lpstrReplaceWith
ชี้การบัฟเฟอร์ที่ข้อความ FINDMSGSTRING ใช้ในการส่งผ่านสายอักขระการแทนค่า null ที่หยุดการทำงานที่ผู้ใช้พิมพ์ในการแทนที่ด้วยตัวควบคุมที่มีแก้ไข คุณต้องจัดสรรบัฟเฟอร์แบบไดนามิก หรือใช้อาร์เรย์แบบสากล หรือคงที่เพื่อที่จะไม่ไปจากขอบเขตก่อนที่ปิดกล่องโต้ตอบ ถ้าบัฟเฟอร์ที่ประกอบด้วยสตริเมื่อคุณเริ่มต้นกล่องโต้ตอบ สายอักขระที่แสดงในตัวควบคุมแก้ไขแทนที่ด้วย .

หากข้อความ FINDMSGSTRING ระบุค่าสถานะ FR_REPLACE หรือ FR_REPLACEALL, lpstrReplaceWithมีสายอักขระการแทน.

ฟังก์ชันFindTextละเว้นสมาชิกนี้.

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

ถ้าส่งขั้นตอนของ hook กลับค่า FALSE ในการตอบสนองต่อข้อความ WM_INITDIALOG ขั้นตอนของ hook ต้องแสดงกล่องโต้ตอบหรือ มิฉะนั้นกล่องโต้ตอบจะไม่สามารถแสดง การทำเช่นนี้ ก่อน ดำเนินการโปรแกรมระบายสีอื่นใด และเรียกใช้ฟังก์ชันShowWindowและUpdateWindowแล้ว.

lpTemplateName
ตัวชี้เป็นสตริงที่สิ้นสุดด้วยค่า null ที่ชื่อทรัพยากรแม่แบบกล่องโต้ตอบในโมดูลที่ระบุ โดยhInstanceสมาชิก แม่แบบนี้ถูกแทนแม่แบบกล่องโต้ตอบมาตรฐาน สำหรับแหล่งข้อมูลของกล่องโต้ตอบหมายเลข นี้สามารถเป็นค่าส่งกลับ โดยแมโคMAKEINTRESOURCE สมาชิกนี้จะถูกละเว้นเว้นแต่ค่าสถานะ FR_ENABLETEMPLATE ถูกตั้งค่าในสถานะสมาชิก.

QuickInfo

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

ดูเพิ่มเติม

ภาพรวมไลบรารีของกล่องโต้ตอบทั่วไปโครงสร้างกล่องโต้ตอบทั่วไป FindText, FRHookProc, MAKEINTRESOURCE, ReplaceText, ShowWindow, UpdateWindow, WM_INITDIALOG

Index