Fungsi GetWindowLongA (winuser.h)

2024-11-20

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.

Sintaksis

LONG GetWindowLongA(
  [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	Arti
GWL_EXSTYLE -20	Mengambil gaya jendela 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	Arti
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 privat ke aplikasi, seperti handel atau pointer.

Mengembalikan nilai

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, panggil GetLastError.

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

Komentar

Pesan memori jendela tambahan dengan menentukan nilai bukan nol dalam cbWndExtra anggota struktur WNDCLASSEX yang digunakan dengan fungsi RegisterClassEx.

Contoh

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

Nota

Header winuser.h mendefinisikan GetWindowLong sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosedur 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

Syarat	Nilai
klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Platform Target	Windows
Header	winuser.h (termasuk Windows.h)
Pustaka	User32.lib
DLL	User32.dll
set API	ext-ms-win-ntuser-windowclass-l1-1-0 (diperkenalkan di Windows 8)

Lihat juga

CallWindowProc

Konseptual

GetWindowLongPtr

Referensi

RegisterClassEx

SetParent

SetWindowLong

WNDCLASS

Kelas Jendela

Bagikan melalui