Fungsi GetDlgItemTextA (winuser.h)

Artikel
03/04/2024

Mengambil judul atau teks yang terkait dengan kontrol dalam kotak dialog.

Sintaks

UINT GetDlgItemTextA(
  [in]  HWND  hDlg,
  [in]  int   nIDDlgItem,
  [out] LPSTR lpString,
  [in]  int   cchMax
);

Parameter

[in] hDlg

Jenis: HWND

Handel ke kotak dialog yang berisi kontrol.

[in] nIDDlgItem

Jenis: int

Pengidentifikasi kontrol yang judul atau teksnya akan diambil.

[out] lpString

Jenis: LPTSTR

Buffer untuk menerima judul atau teks.

[in] cchMax

Jenis: int

Panjang maksimum, dalam karakter, dari string yang akan disalin ke buffer yang diacu oleh lpString. Jika panjang string, termasuk karakter null, melebihi batas, string dipotong.

Nilai kembali

Jenis: UINT

Jika fungsi berhasil, nilai pengembalian menentukan jumlah karakter yang disalin ke buffer, tidak termasuk karakter null yang mengakhiri.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Jika string panjang atau lebih panjang dari buffer, buffer akan berisi string terpotong dengan karakter null yang mengakhiri.

Fungsi GetDlgItemText mengirim pesan WM_GETTEXT ke kontrol.

Contoh

Misalnya, lihat Membuat Kotak Dialog Modal.

Catatan

Header winuser.h mendefinisikan GetDlgItemText sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosedur 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	winuser.h (termasuk Windows.h)
Pustaka	User32.lib
DLL	User32.dll
Set API	ext-ms-win-ntuser-dialogbox-l1-1-0 (diperkenalkan dalam Windows 8)