CompositionPropertySet Classe

Definição

Namespace:

Windows.UI.Composition

Armazena valores como pares chave-valor.

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

Herança

Object Platform::Object IInspectable CompositionObject CompositionPropertySet

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Exemplos

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);
}

Comentários

CompositionPropertySets são CompositionObjects que permitem o armazenamento de pares de valores de chave que podem ser compartilhados em todo o aplicativo e não estão vinculados ao tempo de vida de outro objeto de composição. CompositionPropertySetssão mais comumente usados com animações, em que mantêm pares chave-valor referenciados para conduzir partes de animações de composição. CompositionPropertySetsfornecem a capacidade de inserir pares chave-valor ou recuperar um valor para uma determinada chave. Para obter mais informações sobre como usar CompositionPropertySet com animações, consulte a página Visão geral de animações .

CompositionPropertySet não dá suporte a uma função de exclusão – certifique-se de usar CompositionPropertySet para armazenar valores que serão compartilhados no aplicativo.

Observação

Inserir um novo valor em um CompositionPropertySet para uma chave que já existe substituirá o valor antigo pelo novo.

Histórico de versão

Versão do Windows	Versão do SDK	Valor adicionado
1607	14393	InsertBoolean
1607	14393	TryGetBoolean

Propriedades

Comment	Uma cadeia de caracteres a ser associada ao CompositionObject. (Herdado de CompositionObject)
Compositor	O Compositor usado para criar esse CompositionObject. (Herdado de CompositionObject)
Dispatcher	O dispatcher para CompositionObject. (Herdado de CompositionObject)
DispatcherQueue	Obtém o DispatcherQueue para o CompostionObject. (Herdado de CompositionObject)
ImplicitAnimations	A coleção de animações implícitas anexadas a esse objeto. (Herdado de CompositionObject)
Properties	A coleção de propriedades associadas ao CompositionObject. (Herdado de CompositionObject)

Métodos

Close()	Fecha o CompositionObject e libera os recursos do sistema. (Herdado de CompositionObject)
ConnectAnimation(String, CompositionAnimation)	Conecta e animação. (Herdado de CompositionObject)
DisconnectAnimation(String)	Desconecta uma animação. (Herdado de CompositionObject)
Dispose()	Realiza tarefas definidas pelo aplicativo associadas à liberação ou à redefinição de recursos não gerenciados. (Herdado de CompositionObject)
InsertBoolean(String, Boolean)	Insere um par de chave-valor booliano.
InsertColor(String, Color)	Insere um par chave-valor de cor .
InsertMatrix3x2(String, Matrix3x2)	Insere um par de chave-valor Matrix3x2.
InsertMatrix4x4(String, Matrix4x4)	Insere um par de chave-valor Matrix4x4.
InsertQuaternion(String, Quaternion)	Insere um par chave-valor de quatérnio.
InsertScalar(String, Single)	Insere um par chave-valor único.
InsertVector2(String, Vector2)	Insere um par chave-valor Vector2.
InsertVector3(String, Vector3)	Insere um par chave-valor Vector3.
InsertVector4(String, Vector4)	Insere um par chave-valor Vector4.
PopulatePropertyInfo(String, AnimationPropertyInfo)	Define uma propriedade que pode ser animada. (Herdado de CompositionObject)
StartAnimation(String, CompositionAnimation)	Conecta uma animação com a propriedade especificada do objeto e inicia a animação. (Herdado de CompositionObject)
StartAnimation(String, CompositionAnimation, AnimationController)	Conecta uma animação com a propriedade especificada do objeto e inicia a animação. (Herdado de CompositionObject)
StartAnimationGroup(ICompositionAnimationBase)	Inicia um grupo de animação. O método StartAnimationGroup em CompositionObject permite iniciar CompositionAnimationGroup. Todas as animações no grupo serão iniciadas ao mesmo tempo no objeto . (Herdado de CompositionObject)
StopAnimation(String)	Desconecta uma animação da propriedade especificada e interrompe a animação. (Herdado de CompositionObject)
StopAnimationGroup(ICompositionAnimationBase)	Interrompe um grupo de animação. (Herdado de CompositionObject)
TryGetAnimationController(String)	Retorna um AnimationController para a animação em execução na propriedade especificada. (Herdado de CompositionObject)
TryGetBoolean(String, Boolean)	Recupera o valor da propriedade booliana especificada.
TryGetColor(String, Color)	Recupera o valor da propriedade Color especificado.
TryGetMatrix3x2(String, Matrix3x2)	Recupera o valor da propriedade Matrix3x2 especificado.
TryGetMatrix4x4(String, Matrix4x4)	Recupera o valor da propriedade Matrix4x4 especificado.
TryGetQuaternion(String, Quaternion)	Recupera o valor da propriedade quatérnio especificado.
TryGetScalar(String, Single)	Recupera o valor da propriedade Single especificado.
TryGetVector2(String, Vector2)	Recupera o valor da propriedade Vector2 especificado.
TryGetVector3(String, Vector3)	Recupera o valor da propriedade Vector3 especificado.
TryGetVector4(String, Vector4)	Recupera o valor da propriedade Vector4 especificado.

Confira também

• CompositionObject
• IClosable