簡介
函式功能:該函式返回與指定視窗相關的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兩種版本。