IUIAnimationManager2::GetStoryboardFromTag 메서드(uianimation.h)

지정된 태그가 있는 스토리보드를 가져옵니다.

구문

HRESULT GetStoryboardFromTag(
  [in, optional] IUnknown                *object,
  [in]           UINT32                  id,
  [out]          IUIAnimationStoryboard2 **storyboard
);

매개 변수

[in, optional] object

태그의 개체 부분입니다. 이 매개 변수는 NULL일 수 있습니다.

[in] id

태그의 식별자 부분입니다.

[out] storyboard

지정된 태그와 일치하는 스토리보드이거나 일치하는 항목이 없는 경우 NULL 입니다.

반환 값

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다. 오류 코드 목록은 Windows 애니메이션 오류 코드를 참조하세요.

설명

태그는 COM 개체(개체)와 정수 식별자(id)를 페어링하는 것입니다. 애플리케이션은 태그를 사용하여 애니메이션 변수 및 스토리보드를 식별할 수 있습니다. NULL은 태그의 유효한 개체 구성 요소입니다. 따라서 개체 매개 변수는 NULL일 수 있습니다.

태그가 반드시 고유하지는 않습니다. 지정된 태그를 사용하여 둘 이상의 스토리보드가 있는 경우 이 메서드는 UI_E_AMBIGUOUS_MATCH 반환합니다.

요구 사항

지원되는 최소 클라이언트	Windows 8, Windows 7 및 Windows 7용 플랫폼 업데이트 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	지원되는 버전 없음
대상 플랫폼	Windows
헤더	uianimation.h
DLL	UIAnimation.dll

추가 정보

IUIAnimationManager2

IUIAnimationStoryboard2

IUIAnimationStoryboard::GetTag

IUIAnimationStoryboard::SetTag