Fungsi GetDlgItem (winuser.h)

Artikel
03/04/2024

Mengambil handel ke kontrol dalam kotak dialog yang ditentukan.

Sintaks

HWND GetDlgItem(
  [in, optional] HWND hDlg,
  [in]           int  nIDDlgItem
);

Parameter

[in, optional] hDlg

Jenis: HWND

Handel ke kotak dialog yang berisi kontrol.

[in] nIDDlgItem

Jenis: int

Pengidentifikasi kontrol yang akan diambil.

Nilai kembali

Jenis: HWND

Jika fungsi berhasil, nilai yang dikembalikan adalah handel jendela dari kontrol yang ditentukan.

Jika fungsi gagal, nilai yang dikembalikan adalah NULL, menunjukkan handel kotak dialog yang tidak valid atau kontrol yang tidak ada. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Anda dapat menggunakan fungsi GetDlgItem dengan pasangan jendela induk-anak apa pun, bukan hanya dengan kotak dialog. Selama parameter hDlg menentukan jendela induk dan jendela anak memiliki pengidentifikasi unik (seperti yang ditentukan oleh parameter hMenu dalam fungsi CreateWindow atau CreateWindowEx yang membuat jendela anak), GetDlgItem mengembalikan handel yang valid ke jendela anak.

Contoh

Misalnya, lihat Menginisialisasi Kotak Dialog.

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)