Fungsi GetDlgItemInt (winuser.h)

Artikel
03/13/2024

Menerjemahkan teks kontrol tertentu dalam kotak dialog ke dalam nilai bilangan bulat.

Sintaks

UINT GetDlgItemInt(
  [in]            HWND hDlg,
  [in]            int  nIDDlgItem,
  [out, optional] BOOL *lpTranslated,
  [in]            BOOL bSigned
);

Parameter

[in] hDlg

Jenis: HWND

Handel ke kotak dialog yang berisi kontrol yang menarik.

[in] nIDDlgItem

Jenis: int

Pengidentifikasi kontrol yang teksnya akan diterjemahkan.

[out, optional] lpTranslated

Jenis: BOOL*

Menunjukkan keberhasilan atau kegagalan (TRUE menunjukkan keberhasilan, FALSE menunjukkan kegagalan).

Jika parameter ini NULL, fungsi tidak mengembalikan informasi tentang keberhasilan atau kegagalan.

[in] bSigned

Jenis: BOOL

Menunjukkan apakah fungsi harus memeriksa teks untuk tanda minus di awal dan mengembalikan nilai bilangan bulat yang ditandatangani jika menemukannya (TRUE menentukan ini harus dilakukan, FALSE yang seharusnya tidak).

Nilai kembali

Jenis: UINT

Jika fungsi berhasil, variabel yang ditujukkan oleh lpTranslated diatur ke TRUE, dan nilai yang dikembalikan adalah nilai terjemahan dari teks kontrol.

Jika fungsi gagal, variabel yang diacu oleh lpTranslated diatur ke FALSE, dan nilai yang dikembalikan adalah nol. Perhatikan bahwa, karena nol adalah nilai yang mungkin diterjemahkan, nilai pengembalian nol tidak dengan sendirinya menunjukkan kegagalan.

Jika lpTranslatedadalah NULL, fungsi tidak mengembalikan informasi tentang keberhasilan atau kegagalan.

Perhatikan bahwa, jika parameter bSignedadalah TRUE dan ada tanda minus (–) di awal teks, GetDlgItemInt menerjemahkan teks ke dalam nilai bilangan bulat yang ditandatangani. Jika tidak, fungsi membuat nilai bilangan bulat yang tidak ditandatangani. Untuk mendapatkan nilai yang tepat dalam kasus ini, transmisikan nilai yang dikembalikan ke jenis int .

Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Fungsi GetDlgItemInt mengambil teks kontrol yang ditentukan dengan mengirim kontrol pesan WM_GETTEXT . Fungsi ini menerjemahkan teks yang diambil dengan menghapus spasi tambahan di awal teks lalu mengonversi digit desimal. Fungsi berhenti menerjemahkan saat mencapai akhir teks atau menemukan karakter nonnumerik.

Fungsi GetDlgItemInt mengembalikan nol jika nilai yang diterjemahkan lebih besar dari INT_MAX (untuk angka yang ditandatangani) atau UINT_MAX (untuk angka yang tidak ditandatangani).

Contoh

Misalnya, lihat Membuat Kotak Dialog Tanpa Mode.

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-2 (diperkenalkan dalam Windows 10, versi 10.0.10240)