AnimateWindow 함수(winuser.h)

아티클
08/27/2023

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

구문

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

매개 변수

[in] hWnd

형식: HWND

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

[in] dwTime

형식:DWORD

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

[in] dwFlags

형식:DWORD

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

값	의미
AW_ACTIVATE 0x00020000	창을 활성화합니다. 이 값은 AW_HIDE 사용하지 마세요.
AW_BLEND 0x00080000	페이드 효과를 사용합니다. 이 플래그는 hwnd 가 최상위 창인 경우에만 사용할 수 있습니다.
AW_CENTER 0x00000010	AW_HIDE 사용되는 경우 창이 안쪽으로 축소되거나 AW_HIDE 사용되지 않는 경우 바깥쪽으로 확장합니다. 다양한 방향 플래그는 영향을 주지 않습니다.
AW_HIDE 0x00010000	창을 숨깁니다. 기본적으로 창이 표시됩니다.
AW_HOR_POSITIVE 0x00000001	창에 왼쪽에서 오른쪽으로 애니메이션 효과를 적용합니다. 이 플래그는 롤 또는 슬라이드 애니메이션과 함께 사용할 수 있습니다. AW_CENTER 또는AW_BLEND 사용하는 경우 무시됩니다.
AW_HOR_NEGATIVE 0x00000002	창에 오른쪽에서 왼쪽으로 애니메이션 효과를 적용합니다. 이 플래그는 롤 또는 슬라이드 애니메이션과 함께 사용할 수 있습니다. AW_CENTER 또는AW_BLEND 사용하는 경우 무시됩니다.
AW_SLIDE 0x00040000	슬라이드 애니메이션을 사용합니다. 기본적으로 롤 애니메이션이 사용됩니다. 이 플래그는 AW_CENTER 함께 사용할 때 무시됩니다.
AW_VER_POSITIVE 0x00000004	창에 위쪽에서 아래쪽으로 애니메이션 효과를 적용합니다. 이 플래그는 롤 또는 슬라이드 애니메이션과 함께 사용할 수 있습니다. AW_CENTER 또는AW_BLEND 사용하는 경우 무시됩니다.
AW_VER_NEGATIVE 0x00000008	창에 애니메이션 효과를 적용합니다. 이 플래그는 롤 또는 슬라이드 애니메이션과 함께 사용할 수 있습니다. AW_CENTER 또는AW_BLEND 사용하는 경우 무시됩니다.

반환 값

형식: BOOL

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

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

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

확장 오류 정보를 가져오려면 GetLastError 함수를 호출합니다.

설명

특수 효과 없이 창을 표시하거나 숨기려면 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 창을 지원합니다.

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

요구 사항


지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	winuser.h(Windows.h 포함)
라이브러리	User32.lib
DLL	User32.dll
API 세트	ext-ms-win-ntuser-window-l1-1-0(Windows 8에서 도입)