Fungsi GetDlgItemInt (winuser.h)
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) |
Lihat juga
Konseptual
Referensi