基本介紹
- 外文名:GetWindowLongA
- 類型:函式
- 函式功能:數獲得有關指定視窗的信息
- 隸屬:程式代碼
函式原型,參數,hWnd,nlndex,
函式原型
LONG GetWindowLong(HWND hWnd,int nlndex);
參數
hWnd
nlndex
指定要獲得值的大於等於0的值的偏移量。有效值的範圍從0到額外視窗記憶體空間
的位元組數一4例如,若指定了12位或多於12位的額外類存儲空間,則應設為第三個32位
整數的索引位8。要獲得任意其他值,指定下列值之一:
GWL_EXSTYLE;獲得擴展視窗風格。
GWL_STYLE:獲得視窗風格。
GWL_WNDPROC:獲得視窗過程的地址,或代表視窗過程的地址的句柄。必須使用GWL_WNDPROC
函式調用視窗過程。
GWL_HINSTANCE:獲得套用事例的句柄。
GWL_HWNDPAAENT:如果父視窗存在,獲得父視窗句柄。
GWL_ID:獲得視窗標識。
GWL_USERDATA:獲得與視窗有關的32位值。每一個視窗均有一個由創建該視窗的應用程式
使用的32位值。
在hWnd參數標識了一個對話框時也可用下列值:
DWL_DLGPROC:獲得對話框過程的地址,或一個代表對話框過程的地址的句柄。必須使用函
數CallWindowProc來調用對話框過程。
DWL_MSGRESULT:獲得在對話框過程中一個訊息處理的返回值。
DWL_USER:獲得應用程式私有的額外信息,例如一個句柄或指針。
返回值:如果函式成功,返回值是所需的32位值;如果函式失敗,返回值是0。若想獲得
更多錯誤信息請調用 GetLastError函式。
備註:通過使用函式RegisterClassEx將結構WNDCLASSEX中的cbWndExtra單元指定為一個
非0值來保留額外類的存儲空間。
Windows CE:nlndex參數指定的位元組偏移量必須為 4的倍數。不支持 unaligmned
access。
Windows CE:不支持在參數nlndex中設定的GWL_HINSTANCE和GWL_HWNDPARENT。
Windows CE1.0也不支持在 nlndex參數中的 DWL_DLGPROC和 GWL_USERDATA。
速查:Windows NT:3.1以上版本;Windows:95以上版本;Windows CE:1.0對以上版本;
頭檔案:winuser.h;庫檔案:user32.lib;在Windows NT上實現為Unicode和ANSI兩種版
本。