函數功能
該函數改變指定窗口的
屬性.
函數也將指定的一個32位值設置在窗口的額外存儲空間的指定偏移位置。
函數原型
LONG SetWindowLong(HWND hWnd,int nlndex,LONG dwNewLong);
參數
hWnd:
窗口句柄及間接給出的窗口所屬的類。
nlndex:指定將設定的大于等于0的偏移值。
有效值的
范圍從0到額外類的存儲空間的字節數-4:例如若指定了12位或多于12位的額外類存儲空間,則應設為第三個32位整數的索引位8。要設置其他任何值,
可以指定下面值之一:
GWL_EXSTYLE:設定一個新的擴展
風格。
GWL_STYLE:設定一個新的窗口風格?! ?br>GWL_WNDPROC:為窗口過程設定一個新的
地址。
GWL_ID:設置一個新的窗口標識符。
GWL_HINSTANCE:設置一個新的
應用程序事例句柄。
GWL_USERDATA:設置與
窗口有關的32位值。
每一個窗口均有一個由創建該窗口的應用程序使用的32位值。
當hWnd參數標識了一個
對話框時,也可使用下列值:
DWL_DLGPROC:
設置對話框過程的新地址。
DWL_MSGRESULT:設置在對話框過程中處理的消息的返回值。
DWL_USER:設置的應用程序私有的新的額外信息,例如一個句柄或指針。
dwNewLong:指定的替換值。
返回值:
如果函數成功,返回值是指定的32位整數的原來的值。
如果函數失敗,返回值為0。若想獲得更多錯誤信息,請調用GetLastError函數。
如果指定32位整數的原來的值為0,并且函數成功,則返回值為0,但是函數并不清除最后的錯誤信息,這就很難判斷函數是否成功。這時,就應在調用SetWindowLong之前調用callingSetLastError(0)函數來清除最后的錯誤信息。這樣,如果函數失敗就會返回0,并且GetLastError。也返回一個非零值。 如果由hWnd參數指定的窗口與調用線程不屬于同一進程,將導致SetWindowLong函數失敗。
指定的窗口數據是在緩存中保存的,因此在調用SetWindowLong之后再調用SetWindowPos函數才能使SetWindowLong函數所作的改變生效。
如果使用帶GWL_WNDPROC索引值的SetWindowLong函數替換窗口過程,則該窗口過程必須與WindowProccallback函數說明部分指定的指導行一致。
如果使用帶DWL_MSGRESULT索引值的SetWindowLong函數來設置由一個對話框過程處理的消息的返回值,應在此后立即返回TRUE。否則,如果又調用了其他函數而使對話框過程接收到一個窗口消息,則嵌套的窗口消息可能改寫使用DWL_MSGRESULT設定的返回值。
可以使用帶GWL_WNDPROC索引值的SetWindowLong函數創建一個窗口類的子類,該窗口類是用于創建該窗口的關。一個應用程序可以一個系統美為于類,但是不能以一個其他進程產生的窗口類為子類,SetwindowLong函數通過改變與一個特殊的窗口類相聯系的窗口過程來創建窗口子類,從而使系統調用新的窗口過程而不是以前定義的窗口過程。應用程序必須通過調用CallWindowProc函數向前窗口傳遞未被新窗口處理的消息,這樣作允許應用程序創建一個窗口過程鏈。
通過使用函數RegisterClassEx將結構WNDCLASSEX中的cbWndExtra單元指定為一個非0值來保留新外窗口內存。
不能通過調用帶GWL_HWNDPARENT索引值的SetWindowLong的函數來改變子窗口的父窗口,應使用SetParent函數。