Compartilhar via


SpriteVisual Classe

Definição

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 : ContainerVisual
Public NotInheritable Class SpriteVisual
Inherits ContainerVisual
Herança
Object Platform::Object IInspectable CompositionObject Visual ContainerVisual SpriteVisual
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)

Aplica-se a

Confira também