DistantLight Klasse

Definition

Namespace:

Microsoft.UI.Composition

Eine unendlich große, weit entfernte Lichtquelle, die Licht in eine einzige Richtung ausgibt. Beispielsweise könnte ein fernes Licht verwendet werden, um Sonnenlicht darzustellen.

public ref class DistantLight sealed : CompositionLight

/// [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)]
class DistantLight final : CompositionLight

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

Public NotInheritable Class DistantLight
Inherits CompositionLight

Vererbung

Object Platform::Object IInspectable CompositionObject CompositionLight DistantLight

Attribute

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Beispiele

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

Hinweise

DistantLights und SpotLights unterstützen die Richtung.

DistantLight ist einer der vier Lichttypen, die von CompositionLight abgeleitet sind.

Hell

BESCHREIBUNG

Hinweis Ein Visual kann nicht von mehr als zwei Nicht-Umgebungslichtern (PointLight, SpotLight oder DistantLight) als Ziel verwendet werden. Eigenschaften Color Farbe des ausgegebenen DistantLight. Comment Eine Zeichenfolge, die dem CompositionObject zugeordnet werden soll. (Geerbt von CompositionObject) Compositor Der Compositor , der zum Erstellen dieses CompositionObject verwendet wird. (Geerbt von CompositionObject) CoordinateSpace Das Visual, das verwendet wird, um die Richtung des Lichts zu bestimmen. Die Direction-Eigenschaft des Lichts ist relativ zum Koordinatenraum dieses Visuals. **CoordinateSpace** ist eine erforderliche Eigenschaft. Wenn CoordinateSpace nicht festgelegt ist, wird distantLight nicht gerendert. Direction Die Richtung, in die das Licht zeigt, wird relativ zum CoordinateSpace-Visual angegeben. DispatcherQueue Ruft die DispatcherQueue für das CompositionObject ab. (Geerbt von CompositionObject) ExclusionsFromTargets Ruft eine Auflistung von Visuals ab, die nicht vom Licht bestimmt werden. (Geerbt von CompositionLight) ImplicitAnimations Die Auflistung impliziter Animationen, die an dieses Objekt angefügt sind. (Geerbt von CompositionObject) Intensity Ruft die Intensität des Lichts ab oder legt diese fest. IsEnabled Ruft einen Wert ab, der bestimmt, ob die Kompositionsleuchte leuchtet, oder legt diesen fest. (Geerbt von CompositionLight) Properties Die Auflistung der Eigenschaften, die dem CompositionObject zugeordnet sind. (Geerbt von CompositionObject) Targets Die Sammlung von Visuals, auf die das Licht ausgerichtet ist. (Geerbt von CompositionLight) Methoden Close() Schließt das CompositionObject und gibt Systemressourcen frei. (Geerbt von CompositionObject) Dispose() Führt anwendungsspezifische Aufgaben durch, die mit der Freigabe, der Zurückgabe oder dem Zurücksetzen von nicht verwalteten Ressourcen zusammenhängen. (Geerbt von CompositionObject) PopulatePropertyInfo(String, AnimationPropertyInfo) Definiert eine Eigenschaft, die animiert werden kann. (Geerbt von CompositionObject) StartAnimation(String, CompositionAnimation, AnimationController) Verbindet eine Animation mit der angegebenen Eigenschaft des Objekts und startet die Animation. (Geerbt von CompositionObject) StartAnimation(String, CompositionAnimation) Verbindet eine Animation mit der angegebenen Eigenschaft des Objekts und startet die Animation. (Geerbt von CompositionObject) StartAnimationGroup(ICompositionAnimationBase) Startet eine Animationsgruppe. Mit der StartAnimationGroup-Methode für CompositionObject können Sie CompositionAnimationGroup starten. Alle Animationen in der Gruppe werden gleichzeitig für das Objekt gestartet. (Geerbt von CompositionObject) StopAnimation(String) Trennt eine Animation von der angegebenen Eigenschaft und beendet die Animation. (Geerbt von CompositionObject) StopAnimationGroup(ICompositionAnimationBase) Beendet eine Animationsgruppe. (Geerbt von CompositionObject) TryGetAnimationController(String) Gibt einen AnimationController für die Animation zurück, die für die angegebene Eigenschaft ausgeführt wird. (Geerbt von CompositionObject) Weitere Informationen CompositionLight Targets CreateDistantLight()