AnimateWindow

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

基本介紹

• 外文名：AnimateWindow
• 性質：顯示與隱藏視窗時能產生特殊效果
• 效果：滾動動畫和滑動動畫
• hWnd：指定產生動畫的視窗的句柄。

函式原型

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。