IDCompositionVisual::SetOffsetY(float) 메서드(dcomp.h)

이 시각적 개체의 OffsetY 속성 값을 변경합니다. OffsetY 속성은 부모 시각적 개체를 기준으로 y축을 따라 시각적 개체의 새 오프셋을 지정합니다.

구문

HRESULT SetOffsetY(
  [in] float offsetY
);

매개 변수

[in] offsetY

형식: float

y축을 따라 시각적 개체의 새 오프셋(픽셀)입니다.

반환 값

형식: HRESULT

함수가 성공하면 S_OK를 반환합니다. 그러지 않으면 HRESULT 오류 코드를 반환합니다. 오류 코드 목록은 DirectComposition 오류 코드를 참조하세요.

설명

offsetY 매개 변수가 NaN, 양수 무한대 또는 음의 무한대인 경우 이 메서드는 실패합니다.

OffsetY 속성을 변경하면 이 시각적 개체에 루팅된 전체 시각적 하위 트리의 좌표계가 변환됩니다. 이 시각적 개체의 Clip 속성을 지정하면 클립 사각형도 변환됩니다.

Transform 속성에 지정된 변환은 OffsetY 속성 다음에 적용됩니다. 즉, Transform 속성과 OffsetY 속성을 설정하는 효과는 그룹의 첫 번째 멤버가 offsetY와 동일한 OffsetY 값을 가진 IDCompositionTranslateTransform 개체인 변환 그룹 개체에서 Transform 속성만 설정하는 것과 같습니다. 그러나 가능하면 약간 더 빠르므로 IDCompositionVisual::SetOffsetY 를 사용해야 합니다.

OffsetX 및 OffsetY 속성이 0으로 설정되고 Transform 속성이 NULL로 설정된 경우 시각적 개체의 좌표계는 해당 부모의 좌표계와 동일합니다.

OffsetY 속성이 이전에 애니메이션 효과를 준 경우 이 메서드는 애니메이션을 제거하고 속성을 지정된 정적 값으로 설정합니다.

예제

예제는 간단한 시각적 트리를 빌드하는 방법을 참조하세요.

요구 사항

지원되는 최소 클라이언트	Windows 8 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2012 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	dcomp.h
라이브러리	Dcomp.lib
DLL	Dcomp.dll

추가 정보

IDCompositionVisual

IDCompositionVisual::SetOffsetX

IDCompositionVisual::SetTransform