DistantLight 類別

定義

命名空間:

Microsoft.UI.Composition

無限大型遠距光源，會以單一方向發出光線。 例如，遠距光線可用來代表 S。

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

繼承

Object Platform::Object IInspectable CompositionObject CompositionLight DistantLight

屬性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

範例

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

備註

DistantLight和 SpotLight支援方向。

DistantLight 是衍生自 CompositionLight的四種光線類型之一。

淺色

描述

注意 Visual 無法以兩個以上的非環境光線為目標， (PointLight、SpotLight 或 DistantLight) 。 屬性 Color 發出之 DistantLight 的色彩。 Comment 要與 CompositionObject 建立關聯的字串。 (繼承來源 CompositionObject) Compositor 用來建立這個CompositionObject的Compositor。 (繼承來源 CompositionObject) CoordinateSpace 用來判斷光線方向的視覺效果。 光線的 Direction 屬性相對於這個視覺效果的座標空間。 **CoordinateSpace** 是必要屬性。 如果未設定 CoordinateSpace ， 則 DistantLight 將不會轉譯。 Direction 光線指向的方向，相對於其 CoordinateSpace Visual 指定。 DispatcherQueue 取得 CompositionObject 的 DispatcherQueue。 (繼承來源 CompositionObject) ExclusionsFromTargets 取得不是以光線為目標的視覺效果集合。 (繼承來源 CompositionLight) ImplicitAnimations 附加至這個 物件的隱含動畫集合。 (繼承來源 CompositionObject) Intensity 取得或設定光線的強度。 IsEnabled 取得或設定值，這個值會判斷組合光線是否開啟。 (繼承來源 CompositionLight) Properties 與 CompositionObject相關聯的屬性集合。 (繼承來源 CompositionObject) Targets 以光線為目標的視覺效果集合。 (繼承來源 CompositionLight) 方法 Close() 關閉 CompositionObject 並釋放系統資源。 (繼承來源 CompositionObject) Dispose() 執行與釋放 (Free)、釋放 (Release) 或重設 Unmanaged 資源相關聯之應用程式定義的工作。 (繼承來源 CompositionObject) PopulatePropertyInfo(String, AnimationPropertyInfo) 定義可以產生動畫效果的屬性。 (繼承來源 CompositionObject) StartAnimation(String, CompositionAnimation, AnimationController) 將動畫與物件的指定屬性連接，並啟動動畫。 (繼承來源 CompositionObject) StartAnimation(String, CompositionAnimation) 將動畫與物件的指定屬性連接，並啟動動畫。 (繼承來源 CompositionObject) StartAnimationGroup(ICompositionAnimationBase) 啟動動畫群組。 CompositionObject上的StartAnimationGroup 方法可讓您啟動 CompositionAnimationGroup。 群組中的所有動畫都會在 物件上同時啟動。 (繼承來源 CompositionObject) StopAnimation(String) 中斷動畫與指定屬性的連接，並停止動畫。 (繼承來源 CompositionObject) StopAnimationGroup(ICompositionAnimationBase) 停止動畫群組。 (繼承來源 CompositionObject) TryGetAnimationController(String) 傳回在指定屬性上執行之動畫的 AnimationController。 (繼承來源 CompositionObject) 另請參閱 CompositionLight Targets CreateDistantLight()