CompositionPropertySet 클래스

정의

네임스페이스:

Windows.UI.Composition

값을 키-값 쌍으로 저장합니다.

public ref class CompositionPropertySet sealed : CompositionObject

/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 131072)]
class CompositionPropertySet final : CompositionObject

[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 131072)]
public sealed class CompositionPropertySet : CompositionObject

Public NotInheritable Class CompositionPropertySet
Inherits CompositionObject

상속

Object Platform::Object IInspectable CompositionObject CompositionPropertySet

특성

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 요구 사항

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

예제

void CreatePropertySet()
{
  // Create the CompositionPropertySet and insert a scalar value
  CompositionPropertySet sharedPropSet = _compositor.CreatePropertySet();
  sharedPropSet.InsertScalar("offsetChange", 50f);

  // Reference value in CompositionPropertySet in an Expression
  ExpressionAnimation expression =
  _compositor.CreateExpressionAnimation("this.Target.Offset.X + shared.offsetChange");
  expression.SetReferenceParameter("shared", sharedPropSet);
}

void PropertySetRetrieve(CompositionPropertySet propertySet)
{
  // Retrieve the value of key in a CompositionPropertySet
  float tempOffset;
  propertySet.TryGetScalar("offsetChange", out tempOffset);
}

설명

CompositionPropertySets는 애플리케이션 전체에서 공유할 수 있고 다른 컴퍼지션 개체의 수명에 연결되지 않은 키 값 쌍의 스토리지를 허용하는 CompositionObjects입니다. CompositionPropertySets는 컴퍼지션 애니메이션의 드라이브 부분에 참조되는 키-값 쌍을 유지 관리하는 애니메이션에서 가장 일반적으로 사용됩니다. CompositionPropertySets는 키-값 쌍을 삽입하거나 지정된 키에 대한 값을 검색하는 기능을 제공합니다. 애니메이션과 함께 CompositionPropertySet 을 사용하는 방법에 대한 자세한 내용은 애니메이션 개요 페이지를 참조하세요.

CompositionPropertySet은 삭제 함수를 지원하지 않습니다. CompositionPropertySet을 사용하여 애플리케이션 전체에서 공유되는 값을 저장해야 합니다.

참고

이미 존재하는 키에 대한 CompositionPropertySet에 새 값을 삽입하면 이전 값을 새 값으로 덮어씁니다.

버전 기록

Windows 버전	SDK 버전	추가된 값
1607	14393	InsertBoolean
1607	14393	TryGetBoolean

속성

Comment	CompositionObject와 연결할 문자열입니다. (다음에서 상속됨 CompositionObject)
Compositor	이 CompositionObject를 만드는 데 사용되는 Compositor입니다. (다음에서 상속됨 CompositionObject)
Dispatcher	CompositionObject의 디스패처입니다. (다음에서 상속됨 CompositionObject)
DispatcherQueue	CompostionObject에 대한 DispatcherQueue 를 가져옵니다. (다음에서 상속됨 CompositionObject)
ImplicitAnimations	이 개체에 연결된 암시적 애니메이션의 컬렉션입니다. (다음에서 상속됨 CompositionObject)
Properties	CompositionObject와 연결된 속성의 컬렉션입니다. (다음에서 상속됨 CompositionObject)

메서드

Close()	CompositionObject를 닫고 시스템 리소스를 해제합니다. (다음에서 상속됨 CompositionObject)
ConnectAnimation(String, CompositionAnimation)	연결 및 애니메이션. (다음에서 상속됨 CompositionObject)
DisconnectAnimation(String)	애니메이션의 연결을 끊습니다. (다음에서 상속됨 CompositionObject)
Dispose()	관리되지 않는 리소스의 확보, 해제 또는 다시 설정과 관련된 애플리케이션 정의 작업을 수행합니다. (다음에서 상속됨 CompositionObject)
InsertBoolean(String, Boolean)	부울 키-값 쌍을 삽입합니다.
InsertColor(String, Color)	Color 키-값 쌍을 삽입합니다.
InsertMatrix3x2(String, Matrix3x2)	Matrix3x2 키-값 쌍을 삽입합니다.
InsertMatrix4x4(String, Matrix4x4)	Matrix4x4 키-값 쌍을 삽입합니다.
InsertQuaternion(String, Quaternion)	쿼터니언 키-값 쌍을 삽입합니다.
InsertScalar(String, Single)	단일 키-값 쌍을 삽입합니다.
InsertVector2(String, Vector2)	Vector2 키-값 쌍을 삽입합니다.
InsertVector3(String, Vector3)	Vector3 키-값 쌍을 삽입합니다.
InsertVector4(String, Vector4)	Vector4 키-값 쌍을 삽입합니다.
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)
TryGetBoolean(String, Boolean)	지정된 부울 속성 값을 검색합니다.
TryGetColor(String, Color)	지정된 Color 속성 값을 검색합니다.
TryGetMatrix3x2(String, Matrix3x2)	지정된 Matrix3x2 속성 값을 검색합니다.
TryGetMatrix4x4(String, Matrix4x4)	지정된 Matrix4x4 속성 값을 검색합니다.
TryGetQuaternion(String, Quaternion)	지정된 쿼터니언 속성 값을 검색합니다.
TryGetScalar(String, Single)	지정된 단일 속성 값을 검색합니다.
TryGetVector2(String, Vector2)	지정된 Vector2 속성 값을 검색합니다.
TryGetVector3(String, Vector3)	지정된 Vector3 속성 값을 검색합니다.
TryGetVector4(String, Vector4)	지정된 Vector4 속성 값을 검색합니다.

추가 정보

• CompositionObject
• IClosable