SpriteVisual Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Hospeda el contenido con 2D boxed de tipo CompositionBrush. Cualquier parte del objeto visual no cubierto por píxeles del pincel se representa como píxeles transparentes. CompositionBrush puede ser compositionBackdropBrush, CompositionColorBrush, CompositionSurfaceBrush o 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- Herencia
- Atributos
Requisitos de Windows
| Familia de dispositivos |
Windows 10 (se introdujo en la versión 10.0.10586.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (se introdujo en la versión v2.0)
|
Ejemplos
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);
Agregar una sombra
//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;
Comentarios
Historial de versiones
| Versión de Windows | Versión del SDK | Valor agregado |
|---|---|---|
| 1607 | 14393 | Shadow |
Propiedades
| AnchorPoint |
Punto del objeto visual que se va a colocar en el desplazamiento del objeto visual. El valor se normaliza con respecto al tamaño del objeto visual. Animable. (Heredado de Visual) |
| BackfaceVisibility |
Especifica si la cara posterior del objeto visual debe estar visible durante una transformación 3D. (Heredado de Visual) |
| BorderMode |
Especifica cómo componer los bordes de los mapas de bits y los clips asociados a un objeto visual, o con todos los objetos visuales del subárbol rooteado en este objeto visual. Establecer BorderMode en un objeto visual primario afectará a todos los objetos visuales secundarios del subárbol y se puede desactivar de forma selectiva en cada objeto visual secundario. (Heredado de Visual) |
| Brush |
Un compositionBrush que describe cómo se pinta spriteVisual. |
| CenterPoint |
Punto sobre el que se produce la rotación o el escalado. Animatable (Heredado de Visual) |
| Children |
Los elementos secundarios de ContainerVisual. (Heredado de ContainerVisual) |
| Clip |
Especifica la región de recorte del objeto visual. Cuando se representa un objeto visual, solo se muestra la parte del objeto visual que se encuentra dentro de la región de recorte, mientras que cualquier contenido que se extiende fuera de la región de recorte se recorta (es decir, no se muestra). (Heredado de Visual) |
| Comment |
Cadena que se va a asociar con compositionObject. (Heredado de CompositionObject) |
| CompositeMode |
Especifica cómo se combina el mapa de bits de un objeto visual con la pantalla. (Heredado de Visual) |
| Compositor |
Compositor que se usa para crear este CompositionObject. (Heredado de CompositionObject) |
| Dispatcher |
Distribuidor de CompositionObject. (Heredado de CompositionObject) |
| DispatcherQueue |
Obtiene dispatcherQueue para CompostionObject. (Heredado de CompositionObject) |
| ImplicitAnimations |
Colección de animaciones implícitas adjuntas a este objeto. (Heredado de CompositionObject) |
| IsHitTestVisible |
Obtiene o establece un valor que indica si el subárbol visual con raíz en este objeto visual participa en las pruebas de posicionamiento. (Heredado de Visual) |
| IsPixelSnappingEnabled |
Obtiene o establece un valor que indica si el motor de composición alinea el objeto visual representado con un límite de píxel. (Heredado de Visual) |
| IsVisible |
Indica si el objeto visual y su subárbol completo de objetos visuales secundarios están visibles. (Heredado de Visual) |
| Offset |
Desplazamiento del objeto visual en relación con su elemento primario o para un objeto visual raíz, el desplazamiento relativo a la esquina superior izquierda de las ventanas que hospeda el objeto visual. Animable. (Heredado de Visual) |
| Opacity |
Opacidad del objeto visual. Animable. La propiedad opacidad determina la transparencia, si existe, del objeto Visual y es un valor comprendido entre 0 y 1. 0 es totalmente transparente y 1 es opaco completo. Un objeto Visual con una propiedad Opacity de 0 todavía está presente en el árbol. Al igual que otras propiedades del objeto visual, la opacidad se puede animar mediante Windows, la interfaz de usuario. Sistema de animación de composición. (Heredado de Visual) |
| Orientation |
Cuaternión que describe una orientación y un giro en el espacio 3D que se aplicará al objeto visual. Animable. (Heredado de Visual) |
| Parent |
Elemento primario del objeto visual. (Heredado de Visual) |
| ParentForTransform |
Objeto visual que especifica el sistema de coordenadas en el que se compone este objeto visual. (Heredado de Visual) |
| Properties |
Colección de propiedades asociadas a CompositionObject. (Heredado de CompositionObject) |
| RelativeOffsetAdjustment |
Especifica el desplazamiento del objeto visual con respecto al tamaño de su objeto visual primario. (Heredado de Visual) |
| RelativeSizeAdjustment |
Obtiene o establece el tamaño del objeto visual con respecto al tamaño de su objeto visual primario. (Heredado de Visual) |
| RotationAngle |
Ángulo de rotación en radianes del objeto visual. Animable. (Heredado de Visual) |
| RotationAngleInDegrees |
Ángulo de rotación del objeto visual en grados. Animable. (Heredado de Visual) |
| RotationAxis |
Eje que se va a girar alrededor del objeto visual. Animable. (Heredado de Visual) |
| Scale |
Escala que se va a aplicar al objeto visual. (Heredado de Visual) |
| Shadow |
Sombra de SpriteVisual. |
| Size |
Ancho y alto del objeto visual. Animable. (Heredado de Visual) |
| TransformMatrix |
Matriz de transformación que se va a aplicar al objeto visual. Animable. (Heredado de Visual) |
Métodos
| Close() |
Cierra compositionObject y libera los recursos del sistema. (Heredado de CompositionObject) |
| ConnectAnimation(String, CompositionAnimation) |
Conecta y animación. (Heredado de CompositionObject) |
| DisconnectAnimation(String) |
Desconecta una animación. (Heredado de CompositionObject) |
| Dispose() |
Realiza tareas definidas por la aplicación asociadas a la liberación o al restablecimiento de recursos no administrados. (Heredado de CompositionObject) |
| PopulatePropertyInfo(String, AnimationPropertyInfo) |
Define una propiedad que se puede animar. (Heredado de CompositionObject) |
| StartAnimation(String, CompositionAnimation, AnimationController) |
Conecta una animación con la propiedad especificada del objeto e inicia la animación. (Heredado de CompositionObject) |
| StartAnimation(String, CompositionAnimation) |
Conecta una animación con la propiedad especificada del objeto e inicia la animación. (Heredado de CompositionObject) |
| StartAnimationGroup(ICompositionAnimationBase) |
Inicia un grupo de animación. El método StartAnimationGroup en CompositionObject permite iniciar CompositionAnimationGroup. Todas las animaciones del grupo se iniciarán al mismo tiempo en el objeto . (Heredado de CompositionObject) |
| StopAnimation(String) |
Desconecta una animación de la propiedad especificada y detiene la animación. (Heredado de CompositionObject) |
| StopAnimationGroup(ICompositionAnimationBase) |
Detiene un grupo de animaciones. (Heredado de CompositionObject) |
| TryGetAnimationController(String) |
Devuelve un AnimationController para la animación que se ejecuta en la propiedad especificada. (Heredado de CompositionObject) |