SpriteVisual Класс

Определение

Пространство имен:

Microsoft.UI.Composition

Содержит 2D-содержимое типа CompositionBrush. Любая часть визуального элемента, не охватываемая пикселями с кисти, отображается как прозрачные пиксели. CompositionBrush может быть композициейBackdropBrush, 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	Точка визуального элемента, расположенная в смещение визуального элемента. Значение нормализуется относительно размера визуального элемента. Animatable. (Унаследовано от Visual)
BackfaceVisibility	Указывает, должна ли обратная часть визуального элемента отображаться во время трехмерного преобразования. (Унаследовано от Visual)
BorderMode	Указывает, как создавать края растровых изображений и клипов, связанных с визуальным элементом, или со всеми визуальными элементами в поддереве, корневым в этом визуальном элементе. Задание BorderMode в родительском визуальном элементе влияет на все дочерние визуальные элементы в поддереве и может быть выборочно отключается на каждом дочернем визуальном элементе. (Унаследовано от Visual)
Brush	CompositionBrush, описывающий, как окрашен spriteVisual.
CenterPoint	Точка, о которой происходит поворот или масштабирование. Animatable (Унаследовано от Visual)
Children	Дочерние элементы ContainerVisual. (Унаследовано от ContainerVisual)
Clip	Указывает область вырезки для визуального элемента. При отображении визуального элемента отображается только часть визуального элемента, который попадает в область вырезки, в то время как любое содержимое, которое расширяется за пределами области обрезки (т. е. не отображается). (Унаследовано от Visual)
Comment	Строка, связанная с CompositionObject. (Унаследовано от CompositionObject)
CompositeMode	Указывает, как растровое изображение визуального элемента смешивается с экраном. (Унаследовано от Visual)
Compositor	Компостор, используемый для создания этого объекта CompositionObject. (Унаследовано от CompositionObject)
DispatcherQueue	Возвращает диспетчерку для CompositionObject. (Унаследовано от CompositionObject)
ImplicitAnimations	Коллекция неявных анимаций, присоединенных к этому объекту. (Унаследовано от CompositionObject)
IsHitTestVisible	Возвращает или задает значение, указывающее, участвует ли визуальный вложенный дерево в этом визуальном элементе в тестировании попаданий. (Унаследовано от Visual)
IsPixelSnappingEnabled	Возвращает или задает значение, указывающее, выравнивает ли обработчик композиции отрисованный визуальный элемент с границой пикселя. (Унаследовано от Visual)
IsVisible	Указывает, отображается ли визуальный элемент и весь его поддерев дочерних визуальных элементов. (Унаследовано от Visual)
Offset	Смещение визуального элемента относительно родительского или корневого визуального элемента смещение относительно левого верхнего угла окон, на котором размещается визуальный элемент. Animatable. (Унаследовано от Visual)
Opacity	Прозрачность визуального элемента. Animatable. Свойство непрозрачности определяет прозрачность, если она есть, визуального элемента и является значением от 0 до 1. 0 полностью прозрачный и 1 полностью непрозрачный. Визуальный элемент с свойством Opacity 0 по-прежнему присутствует в дереве. Как и другие свойства в Визуальном элементе, прозрачность может быть анимирована с помощью Windows пользовательского интерфейса. Система анимации композиции. (Унаследовано от Visual)
Orientation	Кватернион, описывающий ориентацию и поворот в трехмерном пространстве, которое будет применяться к визуальному элементу. Animatable. (Унаследовано от Visual)
Parent	Родительский элемент визуального элемента. (Унаследовано от Visual)
ParentForTransform	Визуальный элемент, указывающий систему координат, в которой состоит этот визуальный элемент. (Унаследовано от Visual)
Properties	Коллекция свойств, связанных с CompositionObject. (Унаследовано от CompositionObject)
RelativeOffsetAdjustment	Указывает смещение визуального элемента относительно размера родительского визуального элемента. (Унаследовано от Visual)
RelativeSizeAdjustment	Получает или задает размер визуального элемента относительно размера родительского визуального элемента. (Унаследовано от Visual)
RotationAngle	Угол поворота в радианах визуального элемента. Animatable. (Унаследовано от Visual)
RotationAngleInDegrees	Угол поворота визуального элемента в градусах. Animatable. (Унаследовано от Visual)
RotationAxis	Ось для поворота визуального элемента вокруг. Animatable. (Унаследовано от Visual)
Scale	Масштаб, применяемый к визуальному элементу. (Унаследовано от Visual)
Shadow	Тени для SpriteVisual.
Size	Ширина и высота визуального элемента. Animatable. (Унаследовано от Visual)
TransformMatrix	Матрица преобразования, применяемая к визуальному элементу. Animatable. (Унаследовано от Visual)

Методы

Имя	Описание
Close()	Закрывает ресурсы системы CompositionObject и освобождает системные ресурсы. (Унаследовано от CompositionObject)
Dispose()	Выполняет определяемые приложением задачи, связанные с освобождением, освобождением или сбросом неуправляемых ресурсов. (Унаследовано от CompositionObject)
PopulatePropertyInfo(String, AnimationPropertyInfo)	Определяет свойство, которое может быть анимировано. (Унаследовано от CompositionObject)
StartAnimation(String, CompositionAnimation, AnimationController)	Подключает анимацию с указанным свойством объекта и запускает анимацию. (Унаследовано от CompositionObject)
StartAnimation(String, CompositionAnimation)	Подключает анимацию с указанным свойством объекта и запускает анимацию. (Унаследовано от CompositionObject)
StartAnimationGroup(ICompositionAnimationBase)	Запускает группу анимации. Метод StartAnimationGroup в CompositionObject позволяет запустить CompositionAnimationGroup. Все анимации в группе будут запущены одновременно в объекте. (Унаследовано от CompositionObject)
StopAnimation(String)	Отключает анимацию от указанного свойства и останавливает анимацию. (Унаследовано от CompositionObject)
StopAnimationGroup(ICompositionAnimationBase)	Останавливает группу анимации. (Унаследовано от CompositionObject)
TryGetAnimationController(String)	Возвращает AnimationController для анимации, выполняемой в указанном свойстве. (Унаследовано от CompositionObject)

См. также раздел

• ContainerVisual
• Обзор визуального дерева композиции
• IClosable