CompositionLight 클래스

정의

네임스페이스:

Windows.UI.Composition

UI 장면을 대상으로 지정할 수 있는 광원의 기본 클래스입니다.

이 속성은 CompositionLight.Targets 어떤 시각적 개체가 켜졌는지 결정합니다.

public ref class CompositionLight : CompositionObject

/// [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 CompositionLight : CompositionObject

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

Public Class CompositionLight
Inherits CompositionObject

상속

Object IInspectable CompositionObject CompositionLight

파생

Windows.UI.Composition.AmbientLight

Windows.UI.Composition.DistantLight

Windows.UI.Composition.PointLight

Windows.UI.Composition.SpotLight

특성

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 요구 사항

디바이스 패밀리	Windows 10 Anniversary Edition (10.0.14393.0에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v3.0에서 도입되었습니다.)

설명

CompositionLight는 4가지 광원 유형의 기본 클래스입니다.

밝음	Description
AmbientLight	장면의 모든 항목에 의해 반사된 것처럼 보이는 비방향 광원을 내보낸 광원입니다.
DistantLight	한 방향으로 조명을 방출하는 무한히 큰 원거리 광원.
PointLight	모든 방향으로 조명을 방출하는 점광원.
SpotLight	조명의 내부 및 외부 원뿔을 방출하는 광원.

참고

시각적 개체는 둘 이상의 비앰비언트 조명(PointLight, SpotLight 또는 DistantLight)의 대상이 될 수 없습니다.

버전 기록

Windows 버전	SDK 버전	추가된 값
1709	16299	ExclusionsFromTargets
1803	17134	IsEnabled

속성

Comment	CompositionObject와 연결할 문자열입니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Composition.CompositionObject.Comment(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 CompositionObject)
Compositor	Compositor 이 CompositionObject값을 만드는 데 사용됩니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Composition.CompositionObject.Compositor(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 CompositionObject)
Dispatcher	에 대한 디스패처입니다 CompositionObject. (다음에서 상속됨 CompositionObject)
DispatcherQueue	DispatcherQueue CompostionObject에 대한 값을 가져옵니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Composition.CompositionObject.DispatcherQueue(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 CompositionObject)
ExclusionsFromTargets	조명의 대상이 아닌 시각적 개체의 컬렉션을 가져옵니다.
ImplicitAnimations	이 개체에 연결된 암시적 애니메이션의 컬렉션입니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Composition.CompositionObject.ImplicitAnimations(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 CompositionObject)
IsEnabled	컴퍼지션 조명이 켜지는지 여부를 결정하는 값을 가져오거나 설정합니다.
Properties	에 연결된 CompositionObject속성의 컬렉션입니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Composition.CompositionObject.Properties(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 CompositionObject)
Targets	조명을 대상으로 하는 시각적 개체의 컬렉션입니다.

메서드

Close()	CompositionObject를 닫고 시스템 리소스를 해제합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Composition.CompositionObject.Close(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 CompositionObject)
ConnectAnimation(String, CompositionAnimation)	연결 및 애니메이션. (다음에서 상속됨 CompositionObject)
DisconnectAnimation(String)	애니메이션의 연결을 끊습니다. (다음에서 상속됨 CompositionObject)
PopulatePropertyInfo(String, AnimationPropertyInfo)	애니메이션 효과를 적용할 수 있는 속성을 정의합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Composition.CompositionObject.PopulatePropertyInfo(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 CompositionObject)
StartAnimation(String, CompositionAnimation)	개체의 지정된 속성에 애니메이션을 연결하고 애니메이션을 시작합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Composition.CompositionObject.StartAnimation(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 CompositionObject)
StartAnimation(String, CompositionAnimation, AnimationController)	개체의 지정된 속성에 애니메이션을 연결하고 애니메이션을 시작합니다. (다음에서 상속됨 CompositionObject)
StartAnimationGroup(ICompositionAnimationBase)	애니메이션 그룹을 시작합니다. StartAnimationGroup 메서드를 사용하여 CompositionObject 시작할 CompositionAnimationGroup수 있습니다. 그룹의 모든 애니메이션은 개체에서 동시에 시작됩니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Composition.CompositionObject.StartAnimationGroup(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 CompositionObject)
StopAnimation(String)	지정된 속성에서 애니메이션의 연결을 끊고 애니메이션을 중지합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Composition.CompositionObject.StopAnimation(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 CompositionObject)
StopAnimationGroup(ICompositionAnimationBase)	애니메이션 그룹을 중지합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Composition.CompositionObject.StopAnimationGroup(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 CompositionObject)
TryGetAnimationController(String)	지정된 속성에서 실행되는 애니메이션에 대한 AnimationController를 반환합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Composition.CompositionObject.TryGetAnimationController(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 CompositionObject)

추가 정보

• CompositionObject
• Targets
• CreateAmbientLight()
• CreatePointLight()
• CreateSpotLight()
• CreateDistantLight()