Visual Classe

Definição

Namespace:

Windows.UI.Composition

O objeto visual base na hierarquia visual.

public ref class Visual : CompositionObject

/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 131072)]
class Visual : CompositionObject

[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 131072)]
public class Visual : CompositionObject

Public Class Visual
Inherits CompositionObject

Herança

Object Platform::Object IInspectable CompositionObject Visual

Derivado

Windows.UI.Composition.ContainerVisual

Windows.UI.Composition.DelegatedInkTrailVisual

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Comentários

Os objetos visuais compõem e renderizam o conteúdo de desenho serializado e formam a base de um sistema visual de modo retido. A classe Visual dá suporte à posição e ao recorte básicos e pode ter transformações 2D e 3D aplicadas a elas. Funcionalidades adicionais, como cores sólidas, imagens e conteúdo com efeitos, são fornecidas por meio de subclasses como SpriteVisual ou ContainerVisual e definindo a propriedade Brush do visual como subclasses CompositionBrush, como CompositionColorBrush, CompositionEffectBrush ou CompositionSurfaceBrush.

Os objetos visuais são thread-agile e não estão associados ao thread da interface do usuário.

Propriedades animáveis

As propriedades a seguir podem ser animadas. Chame CompositionObject.StartAnimation para associar a propriedade a um CompositionAnimation.

• Tamanho
• Deslocamento
• Opacidade
• Orientation
• CenterPoint
• RotationAngle
• RotationAngleInDegrees
• RotationAxis
• TransformMatrix

Rotação

O visual dá suporte a duas formas de rotação:

• eixo-ângulo

  A rotação do ângulo do eixo usa as propriedades RotationAngle, RotationAxis e CenterPoint para especificar a rotação em graus, qual eixo girar e o ponto central do visual para girar.

• orientation

  A rotação por orientação usa a propriedade Orientation para especificar um quatérnion que descreve uma orientação e rotação no espaço 3D.

Histórico de versão

Versão do Windows	Versão do SDK	Valor adicionado
1703	15063	ParentForTransform
1703	15063	RelativeOffsetAdjustment
1703	15063	RelativeSizeAdjustment

Propriedades

AnchorPoint	O ponto no visual a ser posicionado no deslocamento do visual. O valor é normalizado em relação ao tamanho do visual. Animatable.
BackfaceVisibility	Especifica se a face traseira do visual deve estar visível durante uma transformação 3D.
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.
CenterPoint	O ponto sobre qual rotação ou dimensionamento ocorre. Animatable
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).
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.
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.
IsPixelSnappingEnabled	Obtém ou define um valor que indica se o mecanismo de composição alinha o visual renderizado com um limite de pixel.
IsVisible	Indica se o visual e sua subárvore inteira de visuais filho estão visíveis.
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.
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.
Orientation	Um quatérnion que descreve uma orientação e rotação no espaço 3D que será aplicado ao visual. Animatable.
Parent	O pai do visual.
ParentForTransform	Visual que especifica o sistema de coordenadas no qual esse visual é composto.
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.
RelativeSizeAdjustment	Obtém ou define o tamanho do visual em relação ao tamanho de seu visual pai.
RotationAngle	O ângulo de rotação em radianos do visual. Animatable.
RotationAngleInDegrees	O ângulo de rotação do visual em graus. Animatable.
RotationAxis	O eixo para girar o visual. Animatable.
Scale	A escala a ser aplicada ao visual.
Size	A largura e a altura do visual. Animatable.
TransformMatrix	A matriz de transformação a ser aplicada ao visual. Animatable.

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)

Confira também

• CompositionObject
• IClosable
• Visão geral da árvore visual de composição
• Visual de composição sem exemplo de estrutura (Windows 10)