AnimateWindow

該函式能在顯示與隱藏視窗時能產生特殊的效果。有兩種類型的動畫效果:滾動動畫和滑動動畫。

基本信息

函式原型

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。

相關詞條

相關搜尋

熱門詞條

聯絡我們