IProgressDialog::SetAnimation 메서드(shlobj_core.h)
[이 메서드는 Windows Vista 이상 버전에서는 지원되지 않습니다.]
대화 상자에서 실행되는 Audio-Video AVI(인터리브) 클립을 지정합니다.
구문
HRESULT SetAnimation(
[in, optional] HINSTANCE hInstAnimation,
UINT idAnimation
);
매개 변수
[in, optional] hInstAnimation
형식: HINSTANCE
AVI 리소스를 로드해야 하는 모듈에 대한 instance 핸들입니다.
idAnimation
형식: UINT
AVI 리소스 식별자입니다. 이 값을 만들려면 MAKEINTRESOURCE 매크로를 사용합니다. 컨트롤은 hInstAnimation으로 지정된 모듈에서 AVI 리소스를 로드합니다.
반환 값
형식: HRESULT
성공하면 S_OK 반환하고, 그렇지 않으면 오류 값을 반환합니다. Windows Vista 이상 버전에서는 항상 S_OK 반환합니다.
설명
진행률 대화 상자가 표시되기 전에 IProgressDialog::SetAnimation을 호출할 수 없습니다. 표시될 때까지 진행률 대화 상자에 유효한 HWND가 없습니다. 해당 HWND의 존재는 IProgressDialog::SetAnimation 을 호출할 수 있는지 여부를 확인하는 데 사용할 수 있습니다.
이 메서드는 hInstAnimation에서 지정한 instance 핸들을 사용하고 애니메이션 컨트롤을 사용하여 자동 AVI 클립을 열고 실행합니다. 다음을 포함하여 사용할 수 있는 AVI 클립 유형에 대한 몇 가지 제한 사항이 있습니다.
- 클립에는 소리가 포함될 수 없습니다.
- AVI 클립의 크기는 272x60픽셀을 초과할 수 없습니다. 더 작은 사각형을 사용할 수 있지만 제대로 가운데에 배치되지 않을 수 있습니다.
- AVI 클립은 압축을 풀거나 런 길이(BI_RLE8) 인코딩으로 압축해야 합니다. 지원되지 않는 압축 형식을 사용하려고 하면 애니메이션이 표시되지 않습니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows 2000 Professional, Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | shlobj_core.h |
| DLL | Shell32.dll(버전 5.0 이상) |