DistantLight 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

Source de lumière distante à l’infini qui émet de la lumière dans une seule direction. Par exemple, une lumière distante peut être utilisée pour représenter la lumière du soleil.

public ref class DistantLight 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 DistantLight 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 DistantLight : CompositionLight

Public NotInheritable Class DistantLight
Inherits CompositionLight

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

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)

Exemples

_distantLight = _compositor.CreateDistantLight(); 
_distantLight.Color = Colors.Yellow; 
_distantLight.Direction = new Vector3(0,-1, 0); 
_distantLight.CoordinateSpace = root; 
_distantLight.Targets.Add(root);

Remarques

DistantLightet SpotLightprennent en charge la direction.

DistantLight est l’un des quatre types de lumière dérivés de CompositionLight.

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 à l’infini 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 intérieurs et externes de lumière.

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	Intensité

Propriétés

Color	Couleur du DistantLight émis.
Comment	Chaîne à associer à CompositionObject. (Hérité de CompositionObject)
Compositor	Compositor utilisé pour créer cet Objet CompositionObject. (Hérité de CompositionObject)
CoordinateSpace	Visuel utilisé pour déterminer la direction de la lumière. La propriété Direction de la lumière est relative à l’espace de coordonnées de ce visuel. `CoordinateSpace` est une propriété obligatoire. Si CoordinateSpace n’est pas défini, l’objet DistantLight ne s’affiche pas.
Direction	Direction dans laquelle la lumière pointe, spécifiée par rapport à son élément visuel CoordinateSpace .
Dispatcher	Répartiteur pour compositionObject. (Hérité de CompositionObject)
DispatcherQueue	Obtient le DispatcherQueue pour CompostionObject. (Hérité de CompositionObject)
ExclusionsFromTargets	Obtient une collection de visuels qui ne sont pas ciblés par la lumière. (Hérité de CompositionLight)
ImplicitAnimations	Collection d’animations implicites attachées à cet objet. (Hérité de CompositionObject)
Intensity	Obtient ou définit l’intensité de la lumière.
IsEnabled	Obtient ou définit une valeur qui détermine si la lumière de composition est allumée. (Hérité de CompositionLight)
Properties	Collection de propriétés associées à CompositionObject. (Hérité de CompositionObject)
Targets	Collection de visuels ciblés par la lumière. (Hérité de CompositionLight)

Méthodes

Close()	Ferme l’objet CompositionObject et libère les ressources système. (Hérité de CompositionObject)
ConnectAnimation(String, CompositionAnimation)	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 à 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 à 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 seront 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 à