Bagikan melalui

Struktur FINDREPLACEA (commdlg.h)

  • Artikel

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 .

Sintaks

typedef struct tagFINDREPLACEA {
  DWORD        lStructSize;
  HWND         hwndOwner;
  HINSTANCE    hInstance;
  DWORD        Flags;
  LPSTR        lpstrFindWhat;
  LPSTR        lpstrReplaceWith;
  WORD         wFindWhatLen;
  WORD         wReplaceWithLen;
  LPARAM       lCustData;
  LPFRHOOKPROC lpfnHook;
  LPCSTR       lpTemplateName;
} FINDREPLACEA, *LPFINDREPLACEA;

Anggota

lStructSize

Jenis: DWORD

Panjangnya, dalam byte, dari struktur.

hwndOwner

Jenis: HWND

Handel ke jendela yang memiliki kotak dialog. Prosedur jendela dari 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 di Bendera, 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 bernama 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.

Nilai Makna
FR_DIALOGTERM
0x00000040
 Jika diatur dalam pesan FINDMSGSTRING , menunjukkan bahwa kotak dialog ditutup. Saat Anda menerima pesan dengan set bendera ini, handel kotak dialog yang dikembalikan oleh fungsi FindText atau ReplaceText tidak lagi valid.
FR_DOWN
0x00000001
 Jika diatur, tombol Bawah tombol radio arah dalam kotak dialog Temukan dipilih yang menunjukkan bahwa Anda harus mencari dari lokasi saat ini ke akhir dokumen. Jika tidak diatur, tombol Atas dipilih sehingga Anda harus mencari ke awal dokumen. Anda dapat mengatur bendera ini untuk menginisialisasi kotak dialog. Jika diatur dalam pesan FINDMSGSTRING , menunjukkan pilihan pengguna.
FR_ENABLEHOOK
0x00000100
 Mengaktifkan fungsi hook yang ditentukan dalam anggota lpfnHook . Bendera ini hanya digunakan untuk menginisialisasi kotak dialog.
FR_ENABLETEMPLATE
0x00000200
 Menunjukkan bahwa anggota hInstance dan lpTemplateName menentukan templat kotak dialog untuk digunakan sebagai pengganti templat default. Bendera ini hanya digunakan untuk menginisialisasi kotak dialog.
FR_ENABLETEMPLATEHANDLE
0x00002000
 Menunjukkan bahwa anggota hInstance mengidentifikasi blok data yang berisi templat kotak dialog yang dimuat sebelumnya. Sistem mengabaikan anggota lpTemplateName jika bendera ini ditentukan.
FR_FINDNEXT
0x00000008
 Jika diatur dalam pesan FINDMSGSTRING , menunjukkan bahwa pengguna mengklik tombol Temukan Berikutnya dalam kotak dialog Temukan atau Ganti . Anggota lpstrFindWhat menentukan string yang akan dicari.
FR_HIDEUPDOWN
0x00004000
 Jika diatur saat menginisialisasi kotak dialog Temukan , menyembunyikan tombol radio arah pencarian.
FR_HIDEMATCHCASE
0x00008000
 Jika diatur saat menginisialisasi kotak dialog Temukan atau Ganti, sembunyikan kotak centang Cocokkan Kasus .
FR_HIDEWHOLEWORD
0x00010000
 Jika diatur saat menginisialisasi kotak dialog Temukan atau Ganti, sembunyikan kotak centang Cocokkan Seluruh Word Saja.
FR_MATCHCASE
0x00000004
 Jika diatur, kotak centang Cocokkan Kasus dipilih yang menunjukkan bahwa pencarian harus peka huruf besar/kecil. Jika tidak diatur, kotak centang tidak dipilih sehingga pencarian harus tidak peka huruf besar/kecil. Anda dapat mengatur bendera ini untuk menginisialisasi kotak dialog. Jika diatur dalam pesan FINDMSGSTRING , menunjukkan pilihan pengguna.
FR_NOMATCHCASE
0x00000800
 Jika diatur saat menginisialisasi kotak dialog Temukan atau Ganti , nonaktifkan kotak centang Cocokkan Kasus .
FR_NOUPDOWN
0x00000400
 Jika diatur saat menginisialisasi kotak dialog Temukan , nonaktifkan tombol radio arah pencarian.
FR_NOWHOLEWORD
0x00001000
 Jika diatur saat menginisialisasi kotak dialog Temukan atau Ganti, nonaktifkan kotak centang Seluruh Word.
FR_REPLACE
0x00000010
 Jika diatur dalam pesan FINDMSGSTRING , menunjukkan bahwa pengguna mengklik tombol Ganti dalam kotak dialog Ganti . Anggota lpstrFindWhat menentukan string yang akan diganti dan anggota lpstrReplaceWith menentukan string pengganti.
FR_REPLACEALL
0x00000020
 Jika diatur dalam pesan FINDMSGSTRING , menunjukkan bahwa pengguna mengklik tombol Ganti Semua dalam kotak dialog Ganti . Anggota lpstrFindWhat menentukan string yang akan diganti dan anggota lpstrReplaceWith menentukan string pengganti.
FR_SHOWHELP
0x00000080
 Menyebabkan kotak dialog menampilkan tombol Bantuan . Anggota hwndOwner harus menentukan jendela untuk menerima pesan terdaftar HELPMSGSTRING yang dikirim kotak dialog saat pengguna mengklik tombol Bantuan .
FR_WHOLEWORD
0x00000002
 Jika diatur, kotak centang Cocokkan Seluruh Word Saja dipilih yang menunjukkan bahwa Anda hanya harus mencari seluruh kata yang cocok dengan string pencarian. Jika tidak diatur, kotak centang tidak dipilih sehingga Anda juga harus mencari fragmen kata yang cocok dengan string pencarian. Anda dapat mengatur bendera ini untuk menginisialisasi kotak dialog. Jika diatur dalam pesan FINDMSGSTRING , menunjukkan pilihan pengguna.

lpstrFindWhat

Jenis: LPTSTR

String pencarian yang diketik pengguna di kontrol edit Temukan Apa . Anda harus mengalokasikan buffer secara dinamis atau menggunakan array global atau statis sehingga tidak keluar dari cakupan sebelum kotak dialog ditutup. Panjang buffer harus minimal 80 karakter. Jika buffer berisi string saat Anda menginisialisasi kotak dialog, string ditampilkan di kontrol edit Temukan Apa . 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 dalam 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 diarahkan oleh anggota lpstrFindWhat .

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 di 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 anggota hInstance . Templat ini diganti 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 di anggota Bendera .

Keterangan

Catatan

Header commdlg.h mendefinisikan FINDREPLACE sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung Windows 2000 Server [hanya aplikasi desktop]
Header commdlg.h (sertakan Windows.h)

Lihat juga

Pustaka Kotak Dialog Umum

Konseptual

FRHookProc

FindText

MAKEINTRESOURCE

Referensi

ReplaceText

TampilkanWindow

WM_INITDIALOG