Fungsi ReplaceTextA (commdlg.h)

Artikel
08/22/2023

Membuat kotak dialog tanpa mode yang ditentukan sistem yang memungkinkan pengguna menentukan string untuk dicari dan string pengganti, serta opsi untuk mengontrol operasi temukan dan ganti.

Sintaks

HWND ReplaceTextA(
  [in, out] LPFINDREPLACEA unnamedParam1
);

Parameter

[in, out] 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.

Mengembalikan nilai

Jenis: HWND

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

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

Keterangan

Fungsi ReplaceText tidak melakukan operasi penggantian teks. 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 ReplaceText, 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, Ganti, atau Ganti Semua , 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 Ganti , 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. Fungsi IsDialogMessage mengembalikan nilai yang menunjukkan apakah kotak dialog Ganti memproses pesan.

Anda dapat menyediakan prosedur hook FRHookProc untuk kotak dialog Ganti . 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 .

Catatan

Header commdlg.h mendefinisikan ReplaceText 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)