Fungsi FindTextA (commdlg.h)

Artikel
11/20/2024

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

Sintaksis

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 Komentar berikut ini.

Mengembalikan nilai

Jenis: HWND

Jika fungsi berhasil, nilai yang dikembalikan adalah gagang 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:

Komentar

Fungsi FindText tidak melakukan operasi pencarian. Sebagai gantinya, kotak dialog mengirimkan FINDMSGSTRING pesan terdaftar ke prosedur jendela jendela jendela pemilik kotak dialog. Saat Anda membuat kotak dialog, hwndOwner anggota 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 . Bendera anggota 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 Bendera anggota struktur FINDREPLACE dan tentukan alamat prosedur kait di anggota lpfnHook.

Contoh

Misalnya, lihat Menemukan Teks.

Nota

Header commdlg.h mendefinisikan FindText sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosektor 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

Syarat	Nilai
klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Platform Target	Windows
Header	commdlg.h (termasuk Windows.h)
Pustaka	Comdlg32.lib
DLL	Comdlg32.dll
set API	ext-ms-win-shell-comdlg32-l1-1-1 (diperkenalkan di Windows 10, versi 10.0.14393)

Lihat juga

CommDlgExtendedError

Pustaka Kotak Dialog Umum

Konseptual

FINDMSGSTRING

FINDREPLACE

FRHookProc

IsDialogMessage

Referensi

RegisterWindowMessage

ReplaceText

Bagikan melalui