SpriteVisual Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Hospeda o conteúdo em caixa 2D do tipo CompositionBrush. Qualquer parte do visual não coberta por pixels do pincel é renderizada como pixels transparentes. CompositionBrush pode ser um CompositionBackdropBrush, CompositionColorBrush, um CompositionSurfaceBrush ou um 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- Herança
- Atributos
Requisitos do Windows
| Família de dispositivos |
Windows 10 (introduzida na 10.0.10586.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduzida na v2.0)
|
Exemplos
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);
Adicionando uma 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;
Comentários
Histórico de versão
| Versão do Windows | Versão do SDK | Valor adicionado |
|---|---|---|
| 1607 | 14393 | Shadow |
Propriedades
| AnchorPoint |
O ponto no visual a ser posicionado no deslocamento do visual. O valor é normalizado em relação ao tamanho do visual. Animatable. (Herdado de Visual) |
| BackfaceVisibility |
Especifica se a face traseira do visual deve estar visível durante uma transformação 3D. (Herdado de Visual) |
| BorderMode |
Especifica como compor as bordas de bitmaps e clipes associados a um visual ou com todos os visuais na subárvore com raiz neste visual. Definir BorderMode em um visual pai afetará todos os visuais filhos na subárvore e poderá ser desativado seletivamente em cada visual filho. (Herdado de Visual) |
| Brush |
Um CompositionBrush que descreve como o SpriteVisual é pintado. |
| CenterPoint |
O ponto sobre qual rotação ou dimensionamento ocorre. Animatable (Herdado de Visual) |
| Children |
Os filhos do ContainerVisual. (Herdado de ContainerVisual) |
| Clip |
Especifica a região de recorte para o visual. Quando um visual é renderizado, somente a parte do visual que cai dentro da região de recorte é exibida, enquanto qualquer conteúdo que se estenda para fora da região de recorte é recortado (ou seja, não exibido). (Herdado de Visual) |
| Comment |
Uma cadeia de caracteres a ser associada ao CompositionObject. (Herdado de CompositionObject) |
| CompositeMode |
Especifica como o bitmap de um visual é combinado com a tela. (Herdado de Visual) |
| Compositor |
O Compositor usado para criar este CompositionObject. (Herdado de CompositionObject) |
| Dispatcher |
O dispatcher do CompositionObject. (Herdado de CompositionObject) |
| DispatcherQueue |
Obtém o DispatcherQueue para o CompostionObject. (Herdado de CompositionObject) |
| ImplicitAnimations |
A coleção de animações implícitas anexadas a esse objeto. (Herdado de CompositionObject) |
| IsHitTestVisible |
Obtém ou define um valor que indica se a subárvore visual com raiz nesse visual participa do teste de clique. (Herdado de Visual) |
| IsPixelSnappingEnabled |
Obtém ou define um valor que indica se o mecanismo de composição alinha o visual renderizado com um limite de pixel. (Herdado de Visual) |
| IsVisible |
Indica se o visual e sua subárvore inteira de visuais filho estão visíveis. (Herdado de Visual) |
| Offset |
O deslocamento do visual em relação ao pai ou a um visual raiz o deslocamento em relação ao canto superior esquerdo das janelas que hospeda o visual. Animatable. (Herdado de Visual) |
| Opacity |
A opacidade do visual. Animatable. A propriedade opacidade determina a transparência, se houver, do Visual e é um valor de 0 a 1. 0 é totalmente transparente e 1 é totalmente opaco. Um Visual com uma propriedade Opacity de 0 ainda está presente na árvore. Assim como outras propriedades no Visual, a opacidade pode ser animada usando o Windows, a interface do usuário. Sistema de animação de composição. (Herdado de Visual) |
| Orientation |
Um quatérnion que descreve uma orientação e rotação no espaço 3D que será aplicado ao visual. Animatable. (Herdado de Visual) |
| Parent |
O pai do visual. (Herdado de Visual) |
| ParentForTransform |
Visual que especifica o sistema de coordenadas no qual esse visual é composto. (Herdado de Visual) |
| Properties |
A coleção de propriedades associadas ao CompositionObject. (Herdado de CompositionObject) |
| RelativeOffsetAdjustment |
Especifica o deslocamento do visual em relação ao tamanho de seu visual pai. (Herdado de Visual) |
| RelativeSizeAdjustment |
Obtém ou define o tamanho do visual em relação ao tamanho de seu visual pai. (Herdado de Visual) |
| RotationAngle |
O ângulo de rotação em radianos do visual. Animatable. (Herdado de Visual) |
| RotationAngleInDegrees |
O ângulo de rotação do visual em graus. Animatable. (Herdado de Visual) |
| RotationAxis |
O eixo para girar o visual. Animatable. (Herdado de Visual) |
| Scale |
A escala a ser aplicada ao visual. (Herdado de Visual) |
| Shadow |
A sombra do SpriteVisual. |
| Size |
A largura e a altura do visual. Animatable. (Herdado de Visual) |
| TransformMatrix |
A matriz de transformação a ser aplicada ao visual. Animatable. (Herdado de Visual) |
Métodos
| Close() |
Fecha o CompositionObject e libera os recursos do sistema. (Herdado de CompositionObject) |
| ConnectAnimation(String, CompositionAnimation) |
Conecta e animação. (Herdado de CompositionObject) |
| DisconnectAnimation(String) |
Desconecta uma animação. (Herdado de CompositionObject) |
| Dispose() |
Realiza tarefas definidas pelo aplicativo associadas à liberação ou à redefinição de recursos não gerenciados. (Herdado de CompositionObject) |
| PopulatePropertyInfo(String, AnimationPropertyInfo) |
Define uma propriedade que pode ser animada. (Herdado de CompositionObject) |
| StartAnimation(String, CompositionAnimation, AnimationController) |
Conecta uma animação com a propriedade especificada do objeto e inicia a animação. (Herdado de CompositionObject) |
| StartAnimation(String, CompositionAnimation) |
Conecta uma animação com a propriedade especificada do objeto e inicia a animação. (Herdado de CompositionObject) |
| StartAnimationGroup(ICompositionAnimationBase) |
Inicia um grupo de animação. O método StartAnimationGroup em CompositionObject permite iniciar CompositionAnimationGroup. Todas as animações no grupo serão iniciadas ao mesmo tempo no objeto . (Herdado de CompositionObject) |
| StopAnimation(String) |
Desconecta uma animação da propriedade especificada e interrompe a animação. (Herdado de CompositionObject) |
| StopAnimationGroup(ICompositionAnimationBase) |
Interrompe um grupo de animação. (Herdado de CompositionObject) |
| TryGetAnimationController(String) |
Retorna um AnimationController para a animação em execução na propriedade especificada. (Herdado de CompositionObject) |