Visual 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.
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 : CompositionObjectPublic Class Visual
Inherits CompositionObject- Herança
- 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.
- 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) |