函式原型
BOOL AnimateWindow(HWND hWnd,DWORD dwTime,DWORD dwFlags);
BOOL AnimateWindow(DWORD dwTime,DWORD dwFlags);
參數
hWnd:指定產生動畫的視窗的句柄。
dwTime:指明動畫持續的時間(以微秒計),完成一個動畫的標準時間為200微秒。
dwFags:指定動畫類型。這個參數可以是一個或多個下列標誌的組合。標誌描述:
AW_SLIDE:使用滑動類型。預設則為滾動動畫類型。當使用AW_CENTER標誌時,這個標誌就被忽略。
AW_ACTIVATE:激活視窗。在使用了AW_HIDE標誌後不要使用這個標誌。
AW_BLEND:使用淡出效果。只有當hWnd為頂層視窗的時候才可以使用此標誌。
AW_HIDE:隱藏視窗,預設則顯示視窗。
AW_CENTER:若使用了AW_HIDE標誌,則使視窗向內重疊;若未使用AW_HIDE標誌,則使視窗向外擴展。
AW_HOR_POSITIVE:自左向右顯示視窗。該標誌可以在滾動動畫和滑動動畫中使用。當使用AW_CENTER標誌時,該標誌將被忽略。
AW_VER_POSITIVE:自頂向下顯示視窗。該標誌可以在滾動動畫和滑動動畫中使用。當使用AW_CENTER標誌時,該標誌將被忽略。
AW_VER_NEGATIVE:自下向上顯示視窗。該標誌可以在滾動動畫和滑動動畫中使用。當使用AW_CENTER標誌時,該標誌將被忽略。
AW_HOR_NEGATIVE:自右向左顯示視窗。該標誌可以在滾動動畫和滑動動畫中使用。當使用AW_CENTER標誌時,該標誌將被忽略。
返回值
如果函式成功,返回值為非零;如果函式失敗,返回值為零。在下列情況下函式將失敗:
視窗使用了視窗邊界;視窗已經可見仍要顯示視窗;視窗已經隱藏仍要隱藏視窗。若想獲得更多錯誤信息,請調用GetLastError函式。
備註
可以將AW_HOR_POSITIVE或AW_HOR_NEGTVE與AW_VER_POSITVE或AW_VER_NEGATIVE組合來激活一個視窗。可能需要在該視窗的視窗過程和它的子視窗的視窗過程中處理WM_PRINT或WM_PRINTCLIENT訊息。對話框,控制,及共用控制已處理WM_PRINTCLIENT訊息,預設視窗過程也已處理WM_PRINT訊息。
代碼示例
void CAboutDlg::OnClose()
{
//實現淡出效果。
AnimateWindow(GetSafeHwnd(),1000,AW_HIDE|AW_BLEND); CDialog::OnClose();
}
速查
WINDOWS NT:5.0以上版本:Windows:98以上版本;Windows CE:不支持;頭檔案:Winuser.h;庫檔案:user32.lib。