Freigeben über


DistantLight Klasse

Definition

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.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
Vererbung
Object Platform::Object IInspectable CompositionObject CompositionLight DistantLight
Attribute

Windows-Anforderungen

Gerätefamilie
Windows 10 Anniversary Edition (eingeführt in 10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v3.0)

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
Ambientlight Eine Lichtquelle, die nicht direktionales Licht ausgibt, das von allem in der Szene reflektiert zu sein scheint.
DistantLight Eine unendlich große, weit entfernte Lichtquelle, die Licht in eine einzige Richtung ausgibt.
Pointlight Eine Punktlichtquelle, die Licht in alle Richtungen ausgibt.
Spotlight Eine Lichtquelle, die innere und äußere Lichtkegel ausgibt.

Hinweis

Ein Visual kann nicht von mehr als zwei Nicht-Umgebungslichtern (PointLight, SpotLight oder DistantLight) als Ziel verwendet werden.

Versionsverlauf

Windows-Version SDK-Version Mehrwert
1709 16299 Intensität

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.

Dispatcher

Der Verteiler für das CompositionObject.

(Geerbt von CompositionObject)
DispatcherQueue

Ruft die DispatcherQueue für das CompostionObject 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)
ConnectAnimation(String, CompositionAnimation)

Verbindet und Animation.

(Geerbt von CompositionObject)
DisconnectAnimation(String)

Trennt eine Animation.

(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)

Gilt für:

Weitere Informationen