Fungsi ReplaceTextA (commdlg.h)

Artikel
11/20/2024

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.

Sintaksis

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 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 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:

Komentar

Fungsi ReplaceText tidak melakukan operasi penggantian teks. 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 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 TemukanBerikutnya , Ganti, atau Ganti Semua, 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 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 Bendera anggota struktur FINDREPLACE dan tentukan alamat prosedur kait di anggota lpfnHook.

Nota

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

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

FINDREPLACE

FRHookProc

IsDialogMessage

Referensi

RegisterWindowMessage

WM_CTLCOLORDLG

Bagikan melalui