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 Platform::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가지 광원 형식의 기본 클래스입니다.

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

참고

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

버전 기록

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

속성

Comment	CompositionObject와 연결할 문자열입니다. (다음에서 상속됨 CompositionObject)
Compositor	이 CompositionObject를 만드는 데 사용되는 Compositor입니다. (다음에서 상속됨 CompositionObject)
Dispatcher	CompositionObject의 디스패처입니다. (다음에서 상속됨 CompositionObject)
DispatcherQueue	CompostionObject에 대한 DispatcherQueue 를 가져옵니다. (다음에서 상속됨 CompositionObject)
ExclusionsFromTargets	조명의 대상이 아닌 시각적 개체의 컬렉션을 가져옵니다.
ImplicitAnimations	이 개체에 연결된 암시적 애니메이션의 컬렉션입니다. (다음에서 상속됨 CompositionObject)
IsEnabled	컴퍼지션 표시등이 켜져 있는지 여부를 결정하는 값을 가져오거나 설정합니다.
Properties	CompositionObject와 연결된 속성의 컬렉션입니다. (다음에서 상속됨 CompositionObject)
Targets	조명을 대상으로 하는 시각적 개체의 컬렉션입니다.

메서드

Close()	CompositionObject를 닫고 시스템 리소스를 해제합니다. (다음에서 상속됨 CompositionObject)
ConnectAnimation(String, CompositionAnimation)	연결 및 애니메이션. (다음에서 상속됨 CompositionObject)
DisconnectAnimation(String)	애니메이션의 연결을 끊습니다. (다음에서 상속됨 CompositionObject)
Dispose()	관리되지 않는 리소스의 확보, 해제 또는 다시 설정과 관련된 애플리케이션 정의 작업을 수행합니다. (다음에서 상속됨 CompositionObject)
PopulatePropertyInfo(String, AnimationPropertyInfo)	애니메이션 효과를 적용할 수 있는 속성을 정의합니다. (다음에서 상속됨 CompositionObject)
StartAnimation(String, CompositionAnimation)	개체의 지정된 속성과 애니메이션을 연결하고 애니메이션을 시작합니다. (다음에서 상속됨 CompositionObject)
StartAnimation(String, CompositionAnimation, AnimationController)	개체의 지정된 속성과 애니메이션을 연결하고 애니메이션을 시작합니다. (다음에서 상속됨 CompositionObject)
StartAnimationGroup(ICompositionAnimationBase)	애니메이션 그룹을 시작합니다. CompositionObject의 StartAnimationGroup 메서드를 사용하면 CompositionAnimationGroup을 시작할 수 있습니다. 그룹의 모든 애니메이션은 개체에서 동시에 시작됩니다. (다음에서 상속됨 CompositionObject)
StopAnimation(String)	지정된 속성에서 애니메이션의 연결을 끊고 애니메이션을 중지합니다. (다음에서 상속됨 CompositionObject)
StopAnimationGroup(ICompositionAnimationBase)	애니메이션 그룹을 중지합니다. (다음에서 상속됨 CompositionObject)
TryGetAnimationController(String)	지정된 속성에서 실행되는 애니메이션에 대한 AnimationController를 반환합니다. (다음에서 상속됨 CompositionObject)

추가 정보

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