SpriteVisual Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Размещает двухсерийное содержимое типа CompositionBrush. Любая часть визуального элемента, не охваченная пикселями от кисти, отображается в виде прозрачных пикселей. 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 : ContainerVisualPublic NotInheritable Class SpriteVisual
Inherits ContainerVisual- Наследование
- Атрибуты
Требования к 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 | Shadow |
Свойства
| AnchorPoint |
Точка визуального элемента, расположенная по смещению визуального элемента. Значение нормализуется относительно размера визуального элемента. Анимация. (Унаследовано от Visual) |
| BackfaceVisibility |
Указывает, должна ли отображаться задняя часть визуального элемента во время трехмерного преобразования. (Унаследовано от Visual) |
| BorderMode |
Указывает способ создания краев растровых изображений и клипов, связанных с визуальным элементом или со всеми визуальными элементами в поддереве, корнями которых является этот визуальный элемент. Установка BorderMode в родительском визуальном элементе повлияет на все дочерние визуальные элементы в поддереве и может быть выборочно отключена в каждом дочернем визуальном элементе. (Унаследовано от Visual) |
| Brush |
CompositionBrush, описывающий, как закрашивание SpriteVisual. |
| CenterPoint |
Точка, о которой происходит поворот или масштабирование. Анимация (Унаследовано от Visual) |
| Children |
Дочерние элементы ContainerVisual. (Унаследовано от ContainerVisual) |
| Clip |
Указывает область обрезки для визуального элемента. При отрисовки визуального элемента отображается только часть визуального элемента, которая находится внутри области обрезки, в то время как любое содержимое, которое выходит за пределы области отсечения, обрезается (т. е. не отображается). (Унаследовано от Visual) |
| Comment |
Строка, связанная с CompositionObject. (Унаследовано от CompositionObject) |
| CompositeMode |
Указывает способ смешивания растрового изображения визуального элемента с экраном. (Унаследовано от Visual) |
| Compositor |
Составитель, используемый для создания этого объекта CompositionObject. (Унаследовано от CompositionObject) |
| Dispatcher |
Диспетчер для CompositionObject. (Унаследовано от CompositionObject) |
| DispatcherQueue |
Возвращает dispatcherQueue для объекта CompostionObject. (Унаследовано от CompositionObject) |
| ImplicitAnimations |
Коллекция неявных анимаций, присоединенных к этому объекту. (Унаследовано от CompositionObject) |
| IsHitTestVisible |
Возвращает или задает значение, указывающее, участвует ли визуальное вложенное дерево в этом визуальном элементе в проверке попадания. (Унаследовано от Visual) |
| IsPixelSnappingEnabled |
Возвращает или задает значение, указывающее, выравнивает ли обработчик композиции отображаемый визуальный элемент с границой пикселя. (Унаследовано от Visual) |
| IsVisible |
Указывает, видим ли визуальный элемент и все его поддерево дочерних визуальных элементов. (Унаследовано от Visual) |
| Offset |
Смещение визуального элемента относительно его родительского элемента или для корневого визуального элемента смещение относительно левого верхнего угла окна, в котором размещен визуальный элемент. Анимация. (Унаследовано от Visual) |
| Opacity |
Прозрачность визуального элемента. Анимация. Свойство непрозрачности определяет прозрачность (если таковой имеется) визуального элемента и является значением от 0 до 1. 0 является полностью прозрачным, а 1 — полностью непрозрачным. Визуальный элемент со свойством Opacity 0 по-прежнему присутствует в дереве. Как и другие свойства визуального элемента, Opacity можно анимировать с помощью windows,ui. Система анимации композиции. (Унаследовано от Visual) |
| Orientation |
Кватернион, описывающий ориентацию и поворот в трехмерном пространстве, которые будут применены к визуальному элементу. Анимация. (Унаследовано от 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) |
Запускает группу анимации. Метод StartAnimationGroup в CompositionObject позволяет запустить CompositionAnimationGroup. Все анимации в группе будут запущены одновременно для объекта . (Унаследовано от CompositionObject) |
| StopAnimation(String) |
Отключает анимацию от указанного свойства и останавливает анимацию. (Унаследовано от CompositionObject) |
| StopAnimationGroup(ICompositionAnimationBase) |
Останавливает группу анимации. (Унаследовано от CompositionObject) |
| TryGetAnimationController(String) |
Возвращает AnimationController для анимации, выполняемой с указанным свойством. (Унаследовано от CompositionObject) |