Fungsi GetWindowLongW (winuser.h)

Artikel
03/13/2024

Mengambil informasi tentang jendela yang ditentukan. Fungsi ini juga mengambil nilai 32-bit (DWORD) pada offset yang ditentukan ke dalam memori jendela tambahan.

Catatan Jika Anda mengambil penunjuk atau handel, fungsi ini telah digantikan oleh fungsi GetWindowLongPtr . (Pointer dan handel adalah 32 bit pada Windows 32-bit dan 64 bit pada Windows 64-bit.) Untuk menulis kode yang kompatibel dengan Windows versi 32-bit dan 64-bit, gunakan GetWindowLongPtr.

Sintaks

LONG GetWindowLongW(
  [in] HWND hWnd,
  [in] int  nIndex
);

Parameter

[in] hWnd

Jenis: HWND

Handel ke jendela dan, secara tidak langsung, kelas tempat jendela berada.

[in] nIndex

Jenis: int

Offset berbasis nol ke nilai yang akan diambil. Nilai yang valid berada dalam rentang nol melalui jumlah byte memori jendela tambahan, dikurangi empat; misalnya, jika Anda menentukan 12 byte atau lebih memori tambahan, nilai 8 akan menjadi indeks ke bilangan bulat 32-bit ketiga. Untuk mengambil nilai lain, tentukan salah satu nilai berikut.

Nilai	Makna
GWL_EXSTYLE -20	Mengambil gaya jendela yang diperluas.
GWL_HINSTANCE -6	Mengambil handel ke instans aplikasi.
GWL_HWNDPARENT -8	Mengambil handel ke jendela induk, jika ada.
GWL_ID -12	Mengambil pengidentifikasi jendela.
GWL_STYLE -16	Mengambil gaya jendela.
GWL_USERDATA -21	Mengambil data pengguna yang terkait dengan jendela. Data ini ditujukan untuk digunakan oleh aplikasi yang membuat jendela. Nilainya awalnya nol.
GWL_WNDPROC -4	Mengambil alamat prosedur jendela, atau handel yang mewakili alamat prosedur jendela. Anda harus menggunakan fungsi CallWindowProc untuk memanggil prosedur jendela.

Nilai berikut juga tersedia saat parameter hWnd mengidentifikasi kotak dialog.

Nilai	Makna
DWL_DLGPROC DWLP_MSGRESULT + sizeof(LRESULT)	Mengambil alamat prosedur kotak dialog, atau handel yang mewakili alamat prosedur kotak dialog. Anda harus menggunakan fungsi CallWindowProc untuk memanggil prosedur kotak dialog.
DWL_MSGRESULT 0	Mengambil nilai pengembalian pesan yang diproses dalam prosedur kotak dialog.
DWL_USER DWLP_DLGPROC + sizeof(DLGPROC)	Mengambil informasi tambahan yang bersifat privat ke aplikasi, seperti handel atau pointer.

Nilai kembali

Jenis: LONG

Jika fungsi berhasil, nilai yang dikembalikan adalah nilai yang diminta.

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

Jika SetWindowLong belum dipanggil sebelumnya, GetWindowLong mengembalikan nol untuk nilai di jendela tambahan atau memori kelas.

Keterangan

Cadangkan memori jendela tambahan dengan menentukan nilai bukan nol di anggota cbWndExtra dari struktur WNDCLASSEX yang digunakan dengan fungsi RegisterClassEx .

Contoh

Misalnya, lihat Membuat, Menghitung, dan Mengukur Jendela Anak.

Catatan

Header winuser.h mendefinisikan GetWindowLong 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

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 (sertakan Windows.h)
Pustaka	User32.lib
DLL	User32.dll
Set API	ext-ms-win-ntuser-windowclass-l1-1-0 (diperkenalkan dalam Windows 8)