다음을 통해 공유


SpriteVisual 클래스

정의

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

public ref class SpriteVisual sealed : ContainerVisual
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 131072)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class SpriteVisual final : ContainerVisual
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 131072)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class SpriteVisual : ContainerVisual
Public NotInheritable Class SpriteVisual
Inherits ContainerVisual
상속
Object Platform::Object IInspectable CompositionObject Visual ContainerVisual SpriteVisual
특성

Windows 요구 사항

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

예제

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;        

설명

버전 기록

Windows 버전 SDK 버전 추가된 값
1607 14393 그림자

속성

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)
Dispatcher

CompositionObject의 디스패처입니다.

(다음에서 상속됨 CompositionObject)
DispatcherQueue

CompostionObject에 대한 DispatcherQueue 를 가져옵니다.

(다음에서 상속됨 CompositionObject)
ImplicitAnimations

이 개체에 연결된 암시적 애니메이션의 컬렉션입니다.

(다음에서 상속됨 CompositionObject)
IsHitTestVisible

이 시각적 개체에 루팅된 시각적 개체 하위 트리가 적중 테스트에 참여하는지 여부를 나타내는 값을 가져오거나 설정합니다.

(다음에서 상속됨 Visual)
IsPixelSnappingEnabled

컴퍼지션 엔진이 렌더링된 시각적 개체를 픽셀 경계에 맞추는지 여부를 나타내는 값을 가져오거나 설정합니다.

(다음에서 상속됨 Visual)
IsVisible

시각적 개체와 자식 시각적 개체의 전체 하위 트리가 표시되는지 여부를 나타냅니다.

(다음에서 상속됨 Visual)
Offset

부모 또는 루트 시각적 개체에 대한 시각적 개체의 오프셋은 시각적 개체를 호스트하는 창의 왼쪽 위 모서리를 기준으로 하는 오프셋입니다. 애니메이션을 적용할 수 있습니다.

(다음에서 상속됨 Visual)
Opacity

시각적 개체의 불투명도입니다. 애니메이션을 적용할 수 있습니다.

불투명도 속성은 시각적 개체의 투명도(있는 경우)를 결정하며 0에서 1까지의 값입니다. 0은 완전히 투명하고 1은 완전히 불투명합니다. Opacity 속성이 0인 시각적 개체는 여전히 트리에 있습니다. 시각적 개체의 다른 속성과 마찬가지로 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)
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)

적용 대상

추가 정보