Visual Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Objeto visual base de la jerarquía visual.
[WebHostHidden]
public ref class Visual : CompositionObject/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Foundation.LiftedContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[WebHostHidden]
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(Microsoft.Foundation.WindowsAppSDKContract, 65536)]
[WebHostHidden]
class Visual : CompositionObject[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Foundation.LiftedContract), 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(Microsoft.Foundation.WindowsAppSDKContract), 65536)]
public class Visual : CompositionObjectPublic Class Visual
Inherits CompositionObject- Herencia
- Derivado
- Atributos
Comentarios
Los objetos visuales componen y representan contenido de dibujo serializado y forman la base de un sistema visual de modo retenido. La clase Visual admite la posición básica y el recorte y puede tener transformaciones 2D y 3D aplicadas. Se proporciona funcionalidad adicional como colores sólidos, imágenes y contenido con efectos a través de subclases como SpriteVisual o ContainerVisual, y estableciendo la propiedad Brush del objeto visual en subclases CompositionColorBrush, como CompositionColorBrush, CompositionEffectBrush o CompositionSurfaceBrush.
Los objetos visuales son ágiles para subprocesos y no están enlazados al subproceso de la interfaz de usuario.
Propiedades animables
Se pueden animar las siguientes propiedades. Llame a CompositionObject.StartAnimation para asociar la propiedad a compositionAnimation.
- Tamaño
- Desplazamiento
- Opacidad
- Orientación
- CenterPoint
- RotationAngle
- RotationAngleInDegrees
- EjeDeRotación
- TransformMatrix
Rotation
El objeto visual admite dos formas de rotación:
ángulo del eje
La rotación del ángulo del eje usa las propiedades RotationAngle, RotationAxis y CenterPoint para especificar la rotación en grados, el eje que se va a girar y el punto central del objeto visual que se va a girar.
orientación
La rotación por orientación usa la propiedad Orientation para especificar un cuaternión que describe una orientación y rotación en el espacio 3D.
Propiedades
| Nombre | Description |
|---|---|
| AnchorPoint |
El punto del objeto visual que se va a colocar en el desplazamiento del objeto visual. El valor se normaliza con respecto al tamaño del objeto visual. Animable. |
| BackfaceVisibility |
Especifica si la cara posterior del objeto visual debe estar visible durante una transformación 3D. |
| BorderMode |
Especifica cómo crear los bordes de mapas de bits y clips asociados a un objeto visual, o bien con todos los objetos visuales del subárbol raíz en este objeto visual. Establecer BorderMode en un objeto visual primario afectará a todos los objetos visuales secundarios del subárbol y se puede desactivar de forma selectiva en cada objeto visual secundario. |
| CenterPoint |
Punto sobre el que se produce la rotación o el escalado. Animatable |
| Clip |
Especifica la región de recorte del objeto visual. Cuando se representa un objeto visual, solo se muestra la parte del objeto visual que se encuentra dentro de la región de recorte, mientras que cualquier contenido que se extiende fuera de la región de recorte se recorta (es decir, no se muestra). |
| Comment |
Cadena que se va a asociar con compositionObject. (Heredado de CompositionObject) |
| CompositeMode |
Especifica cómo se combina el mapa de bits de un objeto visual con la pantalla. |
| Compositor |
Compositor usado para crear este CompositionObject. (Heredado de CompositionObject) |
| DispatcherQueue |
Obtiene dispatcherQueue para CompositionObject. (Heredado de CompositionObject) |
| ImplicitAnimations |
Colección de animaciones implícitas adjuntas a este objeto. (Heredado de CompositionObject) |
| IsHitTestVisible |
Obtiene o establece un valor que indica si el subárbol visual con raíz en este objeto visual participa en las pruebas de posicionamiento. |
| IsPixelSnappingEnabled |
Obtiene o establece un valor que indica si el motor de composición alinea el objeto visual representado con un límite de píxel. |
| IsVisible |
Indica si el objeto visual y su subárbol completo de objetos visuales secundarios están visibles. |
| Offset |
Desplazamiento del objeto visual en relación con su elemento primario o para un objeto visual raíz, el desplazamiento relativo a la esquina superior izquierda de las ventanas que hospeda el objeto visual. Animable. |
| Opacity |
Opacidad del objeto visual. Animable. La propiedad opacidad determina la transparencia, si existe, del objeto Visual y es un valor de 0 a 1. 0 es totalmente transparente y 1 es opaco completo. Un objeto Visual con una propiedad opacidad de 0 todavía está presente en el árbol. Al igual que otras propiedades del objeto visual, la opacidad se puede animar mediante la interfaz de usuario Windows. Sistema de animación de composición. |
| Orientation |
Cuaternión que describe una orientación y rotación en el espacio 3D que se aplicará al objeto visual. Animable. |
| Parent |
Elemento primario del objeto visual. |
| ParentForTransform |
Objeto visual que especifica el sistema de coordenadas en el que se compone este objeto visual. |
| Properties |
Colección de propiedades asociadas a CompositionObject. (Heredado de CompositionObject) |
| RelativeOffsetAdjustment |
Especifica el desplazamiento del objeto visual con respecto al tamaño de su objeto visual primario. |
| RelativeSizeAdjustment |
Obtiene o establece el tamaño del objeto visual con respecto al tamaño de su objeto visual primario. |
| RotationAngle |
Ángulo de rotación en radianes del objeto visual. Animable. |
| RotationAngleInDegrees |
Ángulo de rotación del objeto visual en grados. Animable. |
| RotationAxis |
Eje que se va a girar el objeto visual. Animable. |
| Scale |
Escala que se va a aplicar al objeto visual. |
| Size |
Ancho y alto del objeto visual. Animable. |
| TransformMatrix |
Matriz de transformación que se va a aplicar al objeto visual. Animable. |
Métodos
| Nombre | Description |
|---|---|
| Close() |
Cierra compositionObject y libera los recursos del sistema. (Heredado de CompositionObject) |
| Dispose() |
Realiza tareas definidas por la aplicación asociadas a la liberación, liberación o restablecimiento de recursos no administrados. (Heredado de CompositionObject) |
| PopulatePropertyInfo(String, AnimationPropertyInfo) |
Define una propiedad que se puede animar. (Heredado de CompositionObject) |
| StartAnimation(String, CompositionAnimation, AnimationController) |
Conecta una animación con la propiedad especificada del objeto e inicia la animación. (Heredado de CompositionObject) |
| StartAnimation(String, CompositionAnimation) |
Conecta una animación con la propiedad especificada del objeto e inicia la animación. (Heredado de CompositionObject) |
| StartAnimationGroup(ICompositionAnimationBase) |
Inicia un grupo de animación. El método StartAnimationGroup de CompositionObject le permite iniciar CompositionAnimationGroup. Todas las animaciones del grupo se iniciarán al mismo tiempo en el objeto . (Heredado de CompositionObject) |
| StopAnimation(String) |
Desconecta una animación de la propiedad especificada y detiene la animación. (Heredado de CompositionObject) |
| StopAnimationGroup(ICompositionAnimationBase) |
Detiene un grupo de animación. (Heredado de CompositionObject) |
| TryGetAnimationController(String) |
Devuelve un AnimationController para la animación que se ejecuta en la propiedad especificada. (Heredado de CompositionObject) |