CompositionLight Classe

Référence

Définition

Espace de noms:: Windows.UI.Composition

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Modifier

Classe de base pour une source de lumière qui peut cibler une scène d’interface utilisateur.

La propriété CompositionLight.Targets détermine les visuels qui sont allumés.

public ref class CompositionLight : CompositionObject

/// [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 CompositionLight : CompositionObject

[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 class CompositionLight : CompositionObject

Public Class CompositionLight
Inherits CompositionObject

Héritage: Object Platform::Object IInspectable CompositionObject CompositionLight

Dérivé: Windows.UI.Composition.AmbientLight

Windows.UI.Composition.DistantLight

Windows.UI.Composition.PointLight

Windows.UI.Composition.SpotLight

Attributs: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10 Anniversary Edition (introduit dans 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v3.0)

Remarques

CompositionLight est la classe de base pour quatre types de lumière.

Clair	Description
AmbientLight	Source de lumière qui émet une lumière non directionnelle qui semble avoir été réfléchie par tous les éléments de la scène.
DistantLight	Source de lumière distante infiniment grande qui émet de la lumière dans une seule direction.
PointLight	Source de lumière ponctuelle qui émet de la lumière dans toutes les directions.
Projecteur	Source de lumière qui émet des cônes de lumière intérieurs et externes.

Notes

Un visuel ne peut pas être ciblé par plus de deux lumières non ambiantes (PointLight, SpotLight ou DistantLight).

Historique des versions

Version de Windows	Version du SDK	Valeur ajoutée
1709	16299	ExclusionsFromTargets
1803	17134	IsEnabled

Propriétés

Comment	Chaîne à associer à l’objet CompositionObject. (Hérité de CompositionObject)
Compositor	Compositeur utilisé pour créer cet Objet CompositionObject. (Hérité de CompositionObject)
Dispatcher	Répartiteur de l’objet CompositionObject. (Hérité de CompositionObject)
DispatcherQueue	Obtient dispatcherQueue pour compostionObject. (Hérité de CompositionObject)
ExclusionsFromTargets	Obtient une collection de visuels qui ne sont pas ciblés par la lumière.
ImplicitAnimations	Collection d’animations implicites attachées à cet objet. (Hérité de CompositionObject)
IsEnabled	Obtient ou définit une valeur qui détermine si la lumière de composition est activée.
Properties	Collection de propriétés associées à CompositionObject. (Hérité de CompositionObject)
Targets	Collection de visuels ciblés par la lumière.

Méthodes

Close()	Ferme l’objet CompositionObject et libère les ressources système. (Hérité de CompositionObject)
ConnectAnimation(String, CompositionAnimation)	Se connecte et animation. (Hérité de CompositionObject)
DisconnectAnimation(String)	Déconnecte une animation. (Hérité de CompositionObject)
Dispose()	Exécute les tâches définies par l'application associées à la libération ou à la redéfinition des ressources non managées. (Hérité de CompositionObject)
PopulatePropertyInfo(String, AnimationPropertyInfo)	Définit une propriété qui peut être animée. (Hérité de CompositionObject)
StartAnimation(String, CompositionAnimation)	Connecte une animation avec la propriété spécifiée de l’objet et démarre l’animation. (Hérité de CompositionObject)
StartAnimation(String, CompositionAnimation, AnimationController)	Connecte une animation avec la propriété spécifiée de l’objet et démarre l’animation. (Hérité de CompositionObject)
StartAnimationGroup(ICompositionAnimationBase)	Démarre un groupe d’animations. La méthode StartAnimationGroup sur CompositionObject vous permet de démarrer CompositionAnimationGroup. Toutes les animations du groupe sont démarrées en même temps sur l’objet . (Hérité de CompositionObject)
StopAnimation(String)	Déconnecte une animation de la propriété spécifiée et arrête l’animation. (Hérité de CompositionObject)
StopAnimationGroup(ICompositionAnimationBase)	Arrête un groupe d’animations. (Hérité de CompositionObject)
TryGetAnimationController(String)	Renvoie un AnimationController pour l’animation en cours d’exécution sur la propriété spécifiée. (Hérité de CompositionObject)

S’applique à