GetClassLong

GetClassLong

GetClassLong是一個函數,函數功能為函數返回與指定窗口相關的WNDCLASSEX結構的指定32位值。

簡介


函數功能:該函數返回與指定窗口相關的WNDCLASSEX結構的指定32位值。
函數原型:DWORD GetClassLong(HWND hWnd,int nlndex);

參數


hWnd:窗口句柄間接給出的窗口所屬的類。
nlndex:指定要恢復的32位值。從額外的類存儲空間恢復一個32位的值,指定的一個大於等於0的被恢復值的偏移量。有效值為從0開始到額外類存儲空間位元組數一4。例如,若指定了12位或多於12位的額外類存儲空間,則應設為第三個32位整數的索引位8。要從WNDCLASSEX結構中恢復任何值,需要指定下面值之一:
GCSW原子:獲得一個唯一標識窗口類的原子值,該值與RegisterClassEx函數的返回值相同。
GCL_CBWNDEXTRA:獲得與類中的每個窗口相關的額外窗口中內存空間的位元組大小,進入該存儲空間的方法請參看GetWindowLong。
GCL_HBRBACKGROUND:獲得背景畫刷句柄。
GCL_HCURSOR:獲得與類有關的游標句柄。
GCL_HICON:獲得與類有關的圖標句柄。
GCL_HICONSM:獲得與類有關的小圖標句柄。
GCL_HMODULE:獲得註冊該類的模塊句柄。
GCL_MENUNAME:獲得菜單名字元串的地址,該字元串標識了與類有關的菜單資源。
GCL_STYLE:獲得窗口類的風格位。
GCL_WNDPROC:獲得與類有關的窗口過程的地址。
返回值:如果函數成功,返回值是所需的32位值;如果函數失敗,返回值為0。若想獲得更多錯誤信息,請調用GetLastError函數。
備註:64位版本為GCLP_前綴。通過使用函數RegisterClassEx將結構WNDCLASSEX中的cbCIsExtra單元指定為一個非O值來保留額外類的存儲空間。Windows CE:nlndex參數是一個位元組偏移量,但是必須為 4的倍數。Windows CE不支持unaligned access。nlndex參數中只可設定為GCL_HICON和GCL_STYLE。如果使用了Windows CE的 lconsurs組件,該組件支持在適當的目標平台上的滑鼠,也可以在nlndex中使用GCL_HCURSOR。注意支持滑鼠的 Windows CE版本包含 Iconcurs和 Mcursor而不是 Icon和 Cursor組件。
速查:Wiodows NT:3.1以上版本;Windows:95以上版本:Windows CE:1.0以上版本:頭文件:Winuser.h;庫文件:USer32.lib:Unicode:在 Windows NT上實現為 Unicode和ANSI兩種版本。