Struktur FINDREPLACEW (commdlg.h)

Berisi informasi yang digunakan fungsi FindText dan ReplaceText untuk menginisialisasi kotak dialog Temukan dan Ganti. Pesan terdaftar FINDMSGSTRING menggunakan struktur ini untuk meneruskan input pencarian atau penggantian pengguna ke jendela pemilik kotak dialog Temukan atau Ganti.

Sintaksis

typedef struct tagFINDREPLACEW {
  DWORD        lStructSize;
  HWND         hwndOwner;
  HINSTANCE    hInstance;
  DWORD        Flags;
  LPWSTR       lpstrFindWhat;
  LPWSTR       lpstrReplaceWith;
  WORD         wFindWhatLen;
  WORD         wReplaceWithLen;
  LPARAM       lCustData;
  LPFRHOOKPROC lpfnHook;
  LPCWSTR      lpTemplateName;
} FINDREPLACEW, *LPFINDREPLACEW;

Anggota

lStructSize

Jenis: DWORD

Panjangnya, dalam byte, dari struktur.

hwndOwner

Jenis: HWND

Handel ke jendela yang memiliki kotak dialog. Prosedur jendela jendela yang ditentukan menerima pesan FINDMSGSTRING dari kotak dialog. Anggota ini bisa menjadi handel jendela yang valid, tetapi tidak boleh NULL.

hInstance

Jenis: HINSTANCE

Jika bendera FR_ENABLETEMPLATEHANDLE diatur dalamBendera , hInstance adalah handel ke objek memori yang berisi templat kotak dialog. Jika bendera FR_ENABLETEMPLATE diatur, hInstance adalah handel ke modul yang berisi templat kotak dialog yang dinamai oleh anggota lpTemplateName. Jika tidak ada bendera yang diatur, anggota ini diabaikan.

Flags

Jenis: DWORD

Sekumpulan bendera bit yang bisa Anda gunakan untuk menginisialisasi kotak dialog. Kotak dialog mengatur bendera ini saat mengirim pesan terdaftar FINDMSGSTRING untuk menunjukkan input pengguna. Anggota ini bisa menjadi satu atau beberapa nilai berikut.

lpstrFindWhat

Jenis: LPTSTR

String pencarian yang diketik pengguna di kontrol Temukan Apa yang edit. Anda harus mengalokasikan buffer secara dinamis atau menggunakan array global atau statis sehingga tidak keluar dari cakupan sebelum kotak dialog ditutup. Panjang buffer harus setidaknya 80 karakter. Jika buffer berisi string saat Anda menginisialisasi kotak dialog, string ditampilkan di kontrol Temukan Apa yang edit. Jika pesan FINDMSGSTRING menentukan bendera FR_FINDNEXT, lpstrFindWhat berisi string yang akan dicari. Bendera FR_DOWN, FR_WHOLEWORD, dan FR_MATCHCASE menunjukkan arah dan jenis pencarian. Jika pesan FINDMSGSTRING menentukan bendera FR_REPLACE atau FR_REPLACE, lpstrFindWhat berisi string yang akan diganti.

lpstrReplaceWith

Jenis: LPTSTR

String pengganti yang diketik pengguna di kontrol edit Ganti Dengan. Anda harus mengalokasikan buffer secara dinamis atau menggunakan array global atau statis sehingga tidak keluar dari cakupan sebelum kotak dialog ditutup. Jika buffer berisi string saat Anda menginisialisasi kotak dialog, string ditampilkan di kontrol Ganti Dengan pengeditan.

Jika pesan FINDMSGSTRING menentukan bendera FR_REPLACE atau FR_REPLACEALL, lpstrReplaceWith berisi string pengganti .

Fungsi FindText mengabaikan anggota ini.

wFindWhatLen

Jenis: WORD

Panjangnya, dalam byte, dari buffer yang ditunjukkan oleh lpstrFindWhat anggota.

wReplaceWithLen

Jenis: WORD

Panjangnya, dalam byte, dari buffer yang diarahkan oleh anggota lpstrReplaceWith.

lCustData

Jenis: LPARAM

Data yang ditentukan aplikasi yang diteruskan sistem ke prosedur kait yang diidentifikasi oleh anggota lpfnHook. Ketika sistem mengirim pesan WM_INITDIALOG ke prosedur kait, parameter lParam pesan adalah penunjuk ke struktur FINDREPLACE yang ditentukan saat dialog dibuat. Prosedur kait dapat menggunakan pointer ini untuk mendapatkan nilai lCustData.

lpfnHook

Jenis: LPFRHOOKPROC

Penunjuk ke prosedur hook FRHookProc yang dapat memproses pesan yang ditujukan untuk kotak dialog. Anggota ini diabaikan kecuali bendera FR_ENABLEHOOK diatur dalam anggota Bendera . Jika prosedur kait mengembalikan FALSE sebagai respons terhadap pesan WM_INITDIALOG, prosedur kait harus menampilkan kotak dialog atau kotak dialog tidak akan ditampilkan. Untuk melakukan ini, pertama-tama lakukan operasi cat lainnya, lalu panggil fungsi ShowWindow dan UpdateWindow.

lpTemplateName

Jenis: LPCTSTR

Nama sumber daya templat kotak dialog dalam modul yang diidentifikasi oleh hInstance anggota. Templat ini digantikan untuk templat kotak dialog standar. Untuk sumber daya kotak dialog bernomor, ini bisa menjadi nilai yang dikembalikan oleh makro MAKEINTRESOURCE. Anggota ini diabaikan kecuali bendera FR_ENABLETEMPLATE diatur dalam anggota Bendera .

Komentar

Persyaratan

Lihat juga

Pustaka Kotak Dialog Umum

Konseptual

FRHookProc

FindText

MAKEINTRESOURCE

Referensi

ReplaceText

ShowWindow

WM_INITDIALOG