AmbientLight 類別

定義

命名空間:

Windows.UI.Composition

一種光線，會同樣地照亮每個目標視覺效果。

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

Public NotInheritable Class AmbientLight
Inherits CompositionLight

繼承

Object Platform::Object IInspectable CompositionObject CompositionLight AmbientLight

屬性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 需求

裝置系列	Windows 10 Anniversary Edition (已於 10.0.14393.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v3.0 引進)

範例

_ambientLight = _compositor.CreateAmbientLight(); 
_ambientLight.Color = Colors.Yellow; 
_ambientLight.Targets.Add(root);         

備註

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

淺色	描述
AmbientLight	光源，發出看似已由場景中所有專案反映的非方向光線。
DistantLight	無限大型遠距光源，會以單一方向發出光線。
PointLight	光源的點來源，會以所有方向發出光線。
聚光燈	發出內部和外部光錐的光源。

注意

Visual 不能以兩個非環境光線為目標， (PointLight、SpotLight 或 DistantLight) 。

版本歷程記錄

Windows 版本	SDK 版本	已新增值
1709	16299	強度

屬性

Color	燈光的色彩。 可產生動畫效果。
Comment	要與 CompositionObject 建立關聯的字串。 (繼承來源 CompositionObject)
Compositor	用來建立這個CompositionObject的Compositor。 (繼承來源 CompositionObject)
Dispatcher	CompositionObject的發送器。 (繼承來源 CompositionObject)
DispatcherQueue	取得 CompostionObject 的 DispatcherQueue 。 (繼承來源 CompositionObject)
ExclusionsFromTargets	取得不是以光線為目標的視覺效果集合。 (繼承來源 CompositionLight)
ImplicitAnimations	附加至這個物件的隱含動畫集合。 (繼承來源 CompositionObject)
Intensity	取得或設定光線的濃度。
IsEnabled	取得或設定值，判斷組合光線是否開啟。 (繼承來源 CompositionLight)
Properties	與 CompositionObject相關聯的屬性集合。 (繼承來源 CompositionObject)
Targets	以光線為目標的視覺效果集合。 (繼承來源 CompositionLight)

方法

Close()	關閉 CompositionObject 並釋放系統資源。 (繼承來源 CompositionObject)
ConnectAnimation(String, CompositionAnimation)	連接和動畫。 (繼承來源 CompositionObject)
DisconnectAnimation(String)	中斷動畫的連接。 (繼承來源 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
• CreateAmbientLight()