Visual 클래스

정의

네임스페이스:

Windows.UI.Composition

시각적 계층 구조의 기본 시각적 개체입니다.

public ref class Visual : CompositionObject

/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 131072)]
class Visual : CompositionObject

[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 131072)]
public class Visual : CompositionObject

Public Class Visual
Inherits CompositionObject

상속

Object Platform::Object IInspectable CompositionObject Visual

파생

Windows.UI.Composition.ContainerVisual

Windows.UI.Composition.DelegatedInkTrailVisual

특성

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 요구 사항

디바이스 패밀리	Windows 10 (10.0.10240.0에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)

설명

시각적 개체는 직렬화된 그리기 콘텐츠를 작성하고 렌더링하며 유지 모드 시각적 시스템의 기초를 형성합니다. Visual 클래스는 기본 위치 및 클리핑을 지원하며 2D 및 3D 변환을 적용할 수 있습니다. 단색, 이미지 및 효과가 있는 콘텐츠와 같은 추가 기능은 SpriteVisual 또는 ContainerVisual과 같은 하위 클래스를 통해 제공되며 시각적 개체의 Brush 속성을 CompositionColorBrush, CompositionEffectBrush 또는 CompositionSurfaceBrush와 같은 CompositionBrush 하위 클래스로 설정하여 제공됩니다.

시각적 개체는 스레드 민첩하며 UI 스레드에 바인딩되지 않습니다.

애니메이션 가능 속성

애니메이션 효과를 주면 다음 속성을 사용할 수 있습니다. CompositionObject.StartAnimation을 호출하여 속성을 CompositionAnimation과 연결합니다.

• 크기
• Offset
• 불투명도
• 방향
• CenterPoint
• RotationAngle
• RotationAngleInDegrees
• RotationAxis
• TransformMatrix

회전

시각적 개체는 두 가지 형태의 회전을 지원합니다.

• 축 각도

  축 각도 회전은 RotationAngle, RotationAxis 및 CenterPoint 속성을 사용하여 회전 각도, 회전할 축 및 회전할 시각적 개체의 중심점을 지정합니다.

• orientation

  방향별 회전은 Orientation 속성을 사용하여 3D 공간에서 방향 및 회전을 설명하는 쿼터니언을 지정합니다.

버전 기록

Windows 버전	SDK 버전	추가된 값
1703	15063	ParentForTransform
1703	15063	RelativeOffsetAdjustment
1703	15063	RelativeSizeAdjustment

속성

AnchorPoint	시각적 개체의 오프셋에 배치할 시각적 개체의 점입니다. 값은 시각적 개체의 크기와 관련하여 정규화됩니다. 애니메이션 가능.
BackfaceVisibility	3D 변환 중에 시각적 개체의 뒷면을 표시할지 여부를 지정합니다.
BorderMode	시각적 개체와 연결된 비트맵 및 클립의 가장자리 또는 이 시각적 개체에 루팅된 하위 트리의 모든 시각적 개체를 구성하는 방법을 지정합니다. 부모 시각적 개체에서 BorderMode를 설정하면 하위 트리의 모든 자식 시각적 개체에 영향을 미치며 각 자식 시각적 개체에서 선택적으로 해제할 수 있습니다.
CenterPoint	회전 또는 크기 조정이 발생하는 지점입니다. 애니메이션 가능
Clip	시각적 개체의 클리핑 영역을 지정합니다. 시각적 개체가 렌더링되면 클리핑 영역 내에 있는 시각적 개체의 일부만 표시되고, 클리핑 영역 외부로 확장되는 모든 콘텐츠는 잘립니다(즉, 표시되지 않음).
Comment	CompositionObject와 연결할 문자열입니다. (다음에서 상속됨 CompositionObject)
CompositeMode	시각적 개체의 비트맵이 화면과 혼합되는 방법을 지정합니다.
Compositor	이 CompositionObject를 만드는 데 사용되는 Compositor입니다. (다음에서 상속됨 CompositionObject)
Dispatcher	CompositionObject의 디스패처입니다. (다음에서 상속됨 CompositionObject)
DispatcherQueue	CompostionObject에 대한 DispatcherQueue 를 가져옵니다. (다음에서 상속됨 CompositionObject)
ImplicitAnimations	이 개체에 연결된 암시적 애니메이션의 컬렉션입니다. (다음에서 상속됨 CompositionObject)
IsHitTestVisible	이 시각적 개체에 루팅된 시각적 개체 하위 트리가 적중 테스트에 참여하는지 여부를 나타내는 값을 가져오거나 설정합니다.
IsPixelSnappingEnabled	컴퍼지션 엔진이 렌더링된 시각적 개체를 픽셀 경계에 맞추는지 여부를 나타내는 값을 가져오거나 설정합니다.
IsVisible	시각적 개체와 자식 시각적 개체의 전체 하위 트리가 표시되는지 여부를 나타냅니다.
Offset	부모 또는 루트 시각적 개체를 기준으로 하는 시각적 개체의 오프셋은 시각적 개체를 호스트하는 창의 왼쪽 위 모서리를 기준으로 하는 오프셋입니다. 애니메이션 가능.
Opacity	시각적 개체의 불투명도입니다. 애니메이션 가능. 불투명도 속성은 시각적 개체의 투명도(있는 경우)를 결정하며 0에서 1까지의 값입니다. 0은 완전히 투명하고 1은 완전히 불투명합니다. Opacity 속성이 0인 시각적 개체는 여전히 트리에 있습니다. Visual의 다른 속성과 마찬가지로 Windows,UI를 사용하여 불투명도에 애니메이션 효과를 적용할 수 있습니다. 컴퍼지션 애니메이션 시스템.
Orientation	시각적 개체에 적용할 3D 공간의 방향 및 회전을 설명하는 쿼터니언입니다. 애니메이션 가능.
Parent	시각적 개체의 부모입니다.
ParentForTransform	이 시각적 개체가 구성되는 좌표계를 지정하는 시각적 개체입니다.
Properties	CompositionObject와 연결된 속성의 컬렉션입니다. (다음에서 상속됨 CompositionObject)
RelativeOffsetAdjustment	부모 시각적 개체의 크기와 관련하여 시각적 개체의 오프셋을 지정합니다.
RelativeSizeAdjustment	부모 시각적 개체의 크기와 관련된 시각적 개체의 크기를 가져오거나 설정합니다.
RotationAngle	시각적 개체의 라디안 회전 각도입니다. 애니메이션 가능.
RotationAngleInDegrees	시각적 개체의 회전 각도(도)입니다. 애니메이션 가능.
RotationAxis	시각적 개체를 회전할 축입니다. 애니메이션 가능.
Scale	시각적 개체에 적용할 크기 조정입니다.
Size	시각적 개체의 너비 및 높이입니다. 애니메이션 가능.
TransformMatrix	시각적 개체에 적용할 변환 행렬입니다. 애니메이션 가능.

메서드

Close()	CompositionObject를 닫고 시스템 리소스를 해제합니다. (다음에서 상속됨 CompositionObject)
ConnectAnimation(String, CompositionAnimation)	연결 및 애니메이션. (다음에서 상속됨 CompositionObject)
DisconnectAnimation(String)	애니메이션의 연결을 끊습니다. (다음에서 상속됨 CompositionObject)
Dispose()	관리되지 않는 리소스의 확보, 해제 또는 다시 설정과 관련된 애플리케이션 정의 작업을 수행합니다. (다음에서 상속됨 CompositionObject)
PopulatePropertyInfo(String, AnimationPropertyInfo)	애니메이션 효과를 주는 속성을 정의합니다. (다음에서 상속됨 CompositionObject)
StartAnimation(String, CompositionAnimation, AnimationController)	개체의 지정된 속성에 애니메이션을 연결하고 애니메이션을 시작합니다. (다음에서 상속됨 CompositionObject)
StartAnimation(String, CompositionAnimation)	개체의 지정된 속성에 애니메이션을 연결하고 애니메이션을 시작합니다. (다음에서 상속됨 CompositionObject)
StartAnimationGroup(ICompositionAnimationBase)	애니메이션 그룹을 시작합니다. CompositionObject의 StartAnimationGroup 메서드를 사용하면 CompositionAnimationGroup을 시작할 수 있습니다. 그룹의 모든 애니메이션은 개체에서 동시에 시작됩니다. (다음에서 상속됨 CompositionObject)
StopAnimation(String)	지정된 속성에서 애니메이션의 연결을 끊고 애니메이션을 중지합니다. (다음에서 상속됨 CompositionObject)
StopAnimationGroup(ICompositionAnimationBase)	애니메이션 그룹을 중지합니다. (다음에서 상속됨 CompositionObject)
TryGetAnimationController(String)	지정된 속성에서 실행되는 애니메이션에 대한 AnimationController를 반환합니다. (다음에서 상속됨 CompositionObject)

추가 정보

• CompositionObject
• IClosable
• 컴퍼지션 시각적 트리 개요
• 프레임워크 샘플이 없는 컴퍼지션 시각적 개체(Windows 10)