AnimateWindow 함수(winuser.h)

창을 표시하거나 숨길 때 특수 효과를 생성할 수 있습니다. 애니메이션에는 롤, 슬라이드, 축소 또는 확장, 알파 혼합 페이드의 네 가지 유형이 있습니다.

구문

BOOL AnimateWindow(
  [in] HWND  hWnd,
  [in] DWORD dwTime,
  [in] DWORD dwFlags
);

매개 변수

[in] hWnd

형식: HWND

애니메이션 효과를 주는 창에 대한 핸들입니다. 호출 스레드는 이 창을 소유해야 합니다.

[in] dwTime

형식:DWORD

애니메이션을 재생하는 데 걸리는 시간(밀리초)입니다. 일반적으로 애니메이션을 재생하는 데 200밀리초가 걸립니다.

[in] dwFlags

형식:DWORD

애니메이션의 형식입니다. 이 매개 변수는 다음 값 중 하나 이상일 수 있습니다. 기본적으로 이러한 플래그는 창을 표시할 때 적용됩니다. 창을 숨길 때 적용하려면 적절한 플래그와 함께 AW_HIDE 및 논리 OR 연산자를 사용합니다.

반환 값

형식: BOOL

함수가 성공하면 반환 값이 0이 아닙니다.

함수가 실패하면 반환 값은 0입니다. 함수는 다음과 같은 상황에서 실패합니다.

• 창이 이미 표시되어 있고 창을 표시하려고 하는 경우
• 창이 이미 숨겨져 있고 창을 숨기려는 경우
• 슬라이드 또는 롤 애니메이션에 대해 지정된 방향이 없는 경우
• 자식 창에 애니메이션 효과를 주려고 할 때 AW_BLEND.
• 스레드가 창을 소유하지 않는 경우 이 경우 AnimateWindow 는 실패하지만 GetLastError 는 ERROR_SUCCESS 반환합니다.

설명

특수 효과 없이 창을 표시하거나 숨기려면 ShowWindow를 사용합니다.

슬라이드 또는 롤 애니메이션을 사용하는 경우 방향을 지정해야 합니다. AW_HOR_POSITIVE, AW_HOR_NEGATIVE, AW_VER_POSITIVE 또는 AW_VER_NEGATIVE 수 있습니다.

AW_HOR_POSITIVE 또는 AW_HOR_NEGATIVE AW_VER_POSITIVE 또는 AW_VER_NEGATIVE 결합하여 창에 대각선으로 애니메이션 효과를 적용할 수 있습니다.

창 및 해당 자식 창에 대한 창 프로시저는 WM_PRINT 또는 WM_PRINTCLIENT 메시지를 처리해야 합니다. 대화 상자, 컨트롤 및 공통 컨트롤은 이미 WM_PRINTCLIENT 처리합니다. 기본 창 프로시저는 이미 WM_PRINT 처리합니다.

자식 창이 부분적으로 잘린 것으로 표시되면 애니메이션 효과를 주면 자식 창이 잘린 구멍이 생생합니다.

AnimateWindow 는 RTL 창을 지원합니다.

시각적으로 산만하고 육포 애니메이션을 생성하므로 그림자가 있는 창에 애니메이션 효과를 주는 것은 방지합니다.

요구 사항

추가 정보

개념

기타 리소스

참조

Showwindow

WM_PRINT

WM_PRINTCLIENT

Windows