Fungsi FindTextA (commdlg.h)

Artikel
08/22/2023

Membuat kotak dialog Temukan tanpa mode tanpa mode yang ditentukan sistem yang memungkinkan pengguna menentukan string untuk mencari opsi dan yang akan digunakan saat mencari teks dalam dokumen.

Sintaks

HWND FindTextA(
  [in] LPFINDREPLACEA unnamedParam1
);

Parameter

[in] unnamedParam1

Jenis: LPFINDREPLACE

Penunjuk ke struktur FINDREPLACE yang berisi informasi yang digunakan untuk menginisialisasi kotak dialog. Kotak dialog menggunakan struktur ini untuk mengirim informasi tentang input pengguna ke aplikasi Anda. Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.

Menampilkan nilai

Jenis: HWND

Jika fungsi berhasil, nilai yang dikembalikan adalah handel jendela ke kotak dialog. Anda dapat menggunakan handel jendela untuk berkomunikasi dengan atau untuk menutup kotak dialog.

Jika fungsi gagal, nilai yang dikembalikan adalah NULL. Untuk mendapatkan informasi kesalahan yang diperluas, panggil fungsi CommDlgExtendedError . CommDlgExtendedError dapat mengembalikan salah satu kode kesalahan berikut:

Keterangan

Fungsi FindText tidak melakukan operasi pencarian. Sebagai gantinya, kotak dialog mengirim pesan terdaftar FINDMSGSTRING ke prosedur jendela jendela pemilik kotak dialog. Saat Anda membuat kotak dialog, anggota hwndOwner dari struktur FINDREPLACE adalah handel ke jendela pemilik.

Sebelum memanggil FindText, Anda harus memanggil fungsi RegisterWindowMessage untuk mendapatkan pengidentifikasi untuk pesan FINDMSGSTRING . Prosedur kotak dialog menggunakan pengidentifikasi ini untuk mengirim pesan saat pengguna mengklik tombol Temukan Berikutnya , atau saat kotak dialog ditutup. Parameter lParam dari pesan FINDMSGSTRING berisi penunjuk ke struktur FINDREPLACE . Anggota Bendera struktur ini menunjukkan peristiwa yang menyebabkan pesan. Anggota struktur lainnya menunjukkan input pengguna.

Jika Anda membuat kotak dialog Temukan , Anda juga harus menggunakan fungsi IsDialogMessage di perulangan pesan utama aplikasi Anda untuk memastikan bahwa kotak dialog memproses input keyboard dengan benar, seperti tombol TAB dan ESC. IsDialogMessage mengembalikan nilai yang menunjukkan apakah kotak dialog Temukan memproses pesan.

Anda dapat menyediakan prosedur hook FRHookProc untuk kotak dialog Temukan . Prosedur kait dapat memproses pesan yang dikirim ke kotak dialog. Untuk mengaktifkan prosedur kait, atur bendera FR_ENABLEHOOK di anggota Bendera struktur FINDREPLACE dan tentukan alamat prosedur kait di anggota lpfnHook .

Contoh

Misalnya, lihat Menemukan Teks.

Catatan

Header commdlg.h mendefinisikan FindText 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]
Target Platform	Windows
Header	commdlg.h (sertakan Windows.h)
Pustaka	Comdlg32.lib
DLL	Comdlg32.dll
Set API	ext-ms-win-shell-comdlg32-l1-1-1 (diperkenalkan dalam Windows 10, versi 10.0.14393)