SetProp是一種函式,功能是增加一個新項,修改一個現有項。
基本介紹
- 外文名:SetProp
- 功能:增加一個新項,修改一個現有項
- 原型:BOOL SetProp
- 類別:計算機函式
簡介,參數,
簡介
函式功能:該函式在指定視窗的屬性表中增加一個新項,或者修改一個現有項。如果指定的字元串不在屬性表中,那么就增加該新的項,新項中包含該字元串和句柄,否則就用指定的句柄替換該字元串的全前句柄。
函式原型:BOOL SetProp(HWND hWnd,LPCTSTR lpString,HANDLE hData);
參數
hWnd:指向視窗的句柄,該視窗的屬性表要接收一個新項。
lpString:指向以null結尾的字元串指針,或者包含一個標識字元串的原子。如果該參數是一個原子,那么它必須是以前使用GlobalAddAtom函式創建的。原子是16位的數據值,它必須是放置在lpstring參數低位字中,而高位字必須為O。
hData:指向要拷貝到屬性表中的數據的句柄。該數據句柄可以標識任何對應用程式有用的值。
返回值:如果該數據句柄和字元串以加到屬性表中,那么返回值為非零。如果該函式失敗,那么返回為零。若想獲得更多錯誤信息,請調用GetLastError函式。
備註:在清除視窗之前(也就是在處理WM_NCDESTROY訊息之前),應用程式必須把它加到屬性表的所項清除。應用程式必須使用RemoveProp函式來清除這些項。
速查:Windows NT:3.1以上版本:Windows:95以上版本:Windows CE:不支持:頭檔案:winuser.h;檔案:user32.lib:Unicode:在Windows NT環境中以Unicode和ANSI版本實現。