Compartilhar via


CompositionPropertySet Classe

Definição

Armazena valores como pares chave-valor.

public ref class CompositionPropertySet sealed : CompositionObject
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
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(Windows.Foundation.UniversalApiContract, 131072)]
class CompositionPropertySet final : CompositionObject
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class CompositionPropertySet : 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

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, AnimationController)

Conecta uma animação com a propriedade especificada do objeto e inicia a animação.

(Herdado de CompositionObject)
StartAnimation(String, CompositionAnimation)

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.

Aplica-se a

Confira também