CompositionPropertySet Classe

Definizione

Spazio dei nomi:

Windows.UI.Composition

Archivia i valori come coppie chiave-valore.

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

Ereditarietà

Object Platform::Object IInspectable CompositionObject CompositionPropertySet

Attributi

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Esempio

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

Commenti

CompositionPropertySets sono CompositionObjectche consentono l'archiviazione di coppie di valori chiave che possono essere condivise nell'applicazione e non sono associate alla durata di un altro oggetto di composizione. CompositionPropertySets viene usato più comunemente con le animazioni, in cui mantengono coppie chiave-valore a cui si fa riferimento per guidare parti di animazioni di composizione. CompositionPropertySets consente di inserire coppie chiave-valore o recuperare un valore per una determinata chiave. Per altre informazioni sull'uso di CompositionPropertySet con le animazioni, vedi la pagina Cenni preliminari sulle animazioni .

CompositionPropertySet non supporta una funzione di eliminazione. Assicurarsi di usare CompositionPropertySet per archiviare i valori che verranno condivisi nell'applicazione.

Nota

L'inserimento di un nuovo valore in compositionPropertySet per una chiave già esistente sovrascriverà il valore precedente con quello nuovo.

Cronologia delle versioni

Versione di Windows	Versione dell'SDK	Valore aggiunto
1607	14393	InsertBoolean
1607	14393	TryGetBoolean

Proprietà

Comment	Stringa da associare a CompositionObject. (Ereditato da CompositionObject)
Compositor	Compositor utilizzato per creare questo CompositionObject. (Ereditato da CompositionObject)
Dispatcher	Dispatcher per CompositionObject. (Ereditato da CompositionObject)
DispatcherQueue	Ottiene dispatcherQueue per CompostionObject. (Ereditato da CompositionObject)
ImplicitAnimations	Raccolta di animazioni implicite associate a questo oggetto. (Ereditato da CompositionObject)
Properties	Raccolta di proprietà associate a CompositionObject. (Ereditato da CompositionObject)

Metodi

Close()	Chiude CompositionObject e rilascia le risorse di sistema. (Ereditato da CompositionObject)
ConnectAnimation(String, CompositionAnimation)	Connette e animazione. (Ereditato da CompositionObject)
DisconnectAnimation(String)	Disconnette un'animazione. (Ereditato da CompositionObject)
Dispose()	Esegue attività definite dall'applicazione, come rilasciare o reimpostare risorse non gestite. (Ereditato da CompositionObject)
InsertBoolean(String, Boolean)	Inserisce una coppia chiave-valore booleana.
InsertColor(String, Color)	Inserisce una coppia chiave-valore color .
InsertMatrix3x2(String, Matrix3x2)	Inserisce una coppia chiave-valore Matrix3x2.
InsertMatrix4x4(String, Matrix4x4)	Inserisce una coppia chiave-valore Matrix4x4.
InsertQuaternion(String, Quaternion)	Inserisce una coppia chiave-valore quaternione.
InsertScalar(String, Single)	Inserisce una coppia chiave-valore singolo .
InsertVector2(String, Vector2)	Inserisce una coppia chiave-valore Vector2.
InsertVector3(String, Vector3)	Inserisce una coppia chiave-valore Vector3.
InsertVector4(String, Vector4)	Inserisce una coppia chiave-valore Vector4.
PopulatePropertyInfo(String, AnimationPropertyInfo)	Definisce una proprietà che può essere animata. (Ereditato da CompositionObject)
StartAnimation(String, CompositionAnimation)	Connette un'animazione con la proprietà specificata dell'oggetto e avvia l'animazione. (Ereditato da CompositionObject)
StartAnimation(String, CompositionAnimation, AnimationController)	Connette un'animazione con la proprietà specificata dell'oggetto e avvia l'animazione. (Ereditato da CompositionObject)
StartAnimationGroup(ICompositionAnimationBase)	Avvia un gruppo di animazioni. Il metodo StartAnimationGroup in CompositionObject consente di avviare CompositionAnimationGroup. Tutte le animazioni nel gruppo verranno avviate contemporaneamente sull'oggetto . (Ereditato da CompositionObject)
StopAnimation(String)	Disconnette un'animazione dalla proprietà specificata e arresta l'animazione. (Ereditato da CompositionObject)
StopAnimationGroup(ICompositionAnimationBase)	Arresta un gruppo di animazioni. (Ereditato da CompositionObject)
TryGetAnimationController(String)	Restituisce un oggetto AnimationController per l'animazione in esecuzione sulla proprietà specificata. (Ereditato da CompositionObject)
TryGetBoolean(String, Boolean)	Recupera il valore della proprietà booleana specificato.
TryGetColor(String, Color)	Recupera il valore della proprietà Color specificato.
TryGetMatrix3x2(String, Matrix3x2)	Recupera il valore della proprietà Matrix3x2 specificato.
TryGetMatrix4x4(String, Matrix4x4)	Recupera il valore della proprietà Matrix4x4 specificato.
TryGetQuaternion(String, Quaternion)	Recupera il valore della proprietà quaternione specificato.
TryGetScalar(String, Single)	Recupera il valore della proprietà Single specificato.
TryGetVector2(String, Vector2)	Recupera il valore della proprietà Vector2 specificato.
TryGetVector3(String, Vector3)	Recupera il valore della proprietà Vector3 specificato.
TryGetVector4(String, Vector4)	Recupera il valore della proprietà Vector4 specificato.

Vedi anche

• CompositionObject
• IClosable