Compartilhar via


Visual Classe

Definição

O objeto visual base na hierarquia visual.

public ref class Visual : CompositionObject
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
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.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public 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
Atributos

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.

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)

Aplica-se a

Confira também