AmbientLight 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í.
Una luz que ilumina cada objeto visual de destino por igual.
public ref class AmbientLight sealed : CompositionLight/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 196608)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class AmbientLight final : CompositionLight[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 196608)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class AmbientLight : CompositionLightPublic NotInheritable Class AmbientLight
Inherits CompositionLight- Herencia
- Atributos
Requisitos de Windows
| Familia de dispositivos |
Windows 10 Anniversary Edition (se introdujo en la versión 10.0.14393.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (se introdujo en la versión v3.0)
|
Ejemplos
_ambientLight = _compositor.CreateAmbientLight();
_ambientLight.Color = Colors.Yellow;
_ambientLight.Targets.Add(root);
Comentarios
AmbientLight es uno de los cuatro tipos de luz derivados de CompositionLight.
| Claro | Descripción |
|---|---|
| AmbientLight | Fuente de luz que emite luz no direccional que parece haber sido reflejada por todo en la escena. |
| DistantLight | Fuente de luz lejana infinitamente grande que emite luz en una sola dirección. |
| PointLight | Una fuente de luz puntual que emite luz en todas las direcciones. |
| Foco | Fuente de luz que emite conos internos y externos de luz. |
Nota:
Un objeto visual no puede ser dirigido por más de dos luces no ambientales (PointLight, SpotLight o DistantLight).
Historial de versiones
| Versión de Windows | Versión del SDK | Valor agregado |
|---|---|---|
| 1709 | 16299 | Intensidad |
Propiedades
| Color |
Color de la luz. Animable. |
| Comment |
Cadena que se va a asociar con compositionObject. (Heredado de CompositionObject) |
| Compositor |
Compositor que se usa para crear este CompositionObject. (Heredado de CompositionObject) |
| Dispatcher |
Distribuidor de CompositionObject. (Heredado de CompositionObject) |
| DispatcherQueue |
Obtiene dispatcherQueue para CompostionObject. (Heredado de CompositionObject) |
| ExclusionsFromTargets |
Obtiene una colección de objetos visuales que no tienen como destino la luz. (Heredado de CompositionLight) |
| ImplicitAnimations |
Colección de animaciones implícitas adjuntas a este objeto. (Heredado de CompositionObject) |
| Intensity |
Obtiene o establece la intensidad de la luz. |
| IsEnabled |
Obtiene o establece un valor que determina si la luz de composición está activada. (Heredado de CompositionLight) |
| Properties |
Colección de propiedades asociadas a CompositionObject. (Heredado de CompositionObject) |
| Targets |
Colección de objetos visuales dirigidos por la luz. (Heredado de CompositionLight) |
Métodos
| Close() |
Cierra compositionObject y libera los recursos del sistema. (Heredado de CompositionObject) |
| ConnectAnimation(String, CompositionAnimation) |
Conecta y animación. (Heredado de CompositionObject) |
| DisconnectAnimation(String) |
Desconecta una animación. (Heredado de CompositionObject) |
| Dispose() |
Realiza tareas definidas por la aplicación asociadas a la liberación o al 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 en CompositionObject 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 animaciones. (Heredado de CompositionObject) |
| TryGetAnimationController(String) |
Devuelve un AnimationController para la animación que se ejecuta en la propiedad especificada. (Heredado de CompositionObject) |