SpriteVisual 클래스

정의

네임스페이스:

Microsoft.UI.Composition

CompositionBrush 형식의 2D 박스 콘텐츠를 호스트합니다. 브러시의 픽셀로 덮여 있지 않은 시각적 개체의 모든 부분은 투명 픽셀로 렌더링됩니다. CompositionBrush는 CompositionBackdropBrush, CompositionColorBrush, CompositionSurfaceBrush 또는 CompositionEffectBrush일 수 있습니다.

public ref class SpriteVisual sealed : ContainerVisual

/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Foundation.WindowsAppSDKContract, 65536)]
class SpriteVisual final : ContainerVisual

[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Foundation.WindowsAppSDKContract), 65536)]
public sealed class SpriteVisual : ContainerVisual

Public NotInheritable Class SpriteVisual
Inherits ContainerVisual

상속

Object Platform::Object IInspectable CompositionObject Visual ContainerVisual SpriteVisual

특성

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

예제

SpriteVisual visual = compositor.CreateSpriteVisual();
visual.Brush = compositor.CreateColorBrush  (Colors.White);

SpriteVisual visual = compositor.CreateSpriteVisual();
var surface = graphicsDevice.CreateDrawingSurface(new Size(300, 50), 
                                                  Windows.Graphics.DirectX.DirectXPixelFormat.B8G8R8A8UIntNormalized, 
                                                  CompositionAlphaMode.Ignore); 
visual.Brush = compsositor.CreateSurfaceBrush (surface);

그림자 추가

//Create surface brush and load in an image
CompositionSurfaceBrush surfaceBrush = compositor.CreateSurfaceBrush();
surfaceBrush.Surface = await imageLoader.LoadImageFromUriAsync(new Uri("ms-appx:///Assets/cat.jpg"));

//Create sprite visual
SpriteVisual visual = compositor.CreateSpriteVisual();
visual.Brush = surfaceBrush;
visual.Size = new Vector2(270, 200);

//Create drop shadow
DropShadow shadow = compositor.CreateDropShadow();
shadow.BlurRadius = 5;
shadow.Offset = new Vector3(15, 15, -10);
shadow.Color = Colors.DarkGray;

//Associate shadow to visual
visual.Shadow = shadow;        

속성

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

메서드

Close()	CompositionObject를 닫고 시스템 리소스를 해제합니다. (다음에서 상속됨 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)

추가 정보

• ContainerVisual
• 컴퍼지션 시각적 트리 개요
• IClosable