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

Комментарии

CompositionPropertySet— это compositionObjects, которые позволяют хранить пары ключевых значений, которые могут совместно использоваться в приложении и не привязаны к времени существования другого объекта композиции. CompositionPropertySetчаще всего используются с анимациями, где они поддерживают пары "ключ-значение", которые ссылаются на основные части анимации композиции. CompositionPropertySetпредоставляет возможность вставки пар "ключ-значение" или получения значения для заданного ключа. Дополнительные сведения об использовании CompositionPropertySet с анимациями см. на странице Обзор анимаций .

CompositionPropertySet не поддерживает функцию удаления. Убедитесь, что вы используете CompositionPropertySet для хранения значений, которые будут совместно использоваться в приложении.

Примечание

Вставка нового значения в CompositionPropertySet для уже существующего ключа приведет к перезаписи старого значения новым.

Журнал версий

Версия Windows	Версия пакета SDK	Добавленная стоимость
1607	14393	InsertBoolean
1607	14393	TryGetBoolean

Свойства

Comment	Строка, связанная с CompositionObject. (Унаследовано от CompositionObject)
Compositor	Составитель, используемый для создания этого объекта CompositionObject. (Унаследовано от CompositionObject)
Dispatcher	Диспетчер для CompositionObject. (Унаследовано от CompositionObject)
DispatcherQueue	Возвращает dispatcherQueue для объекта CompostionObject. (Унаследовано от CompositionObject)
ImplicitAnimations	Коллекция неявных анимаций, присоединенных к этому объекту. (Унаследовано от CompositionObject)
Properties	Коллекция свойств, связанных с CompositionObject. (Унаследовано от CompositionObject)

Методы

Close()	Закрывает объект CompositionObject и освобождает системные ресурсы. (Унаследовано от CompositionObject)
ConnectAnimation(String, CompositionAnimation)	Соединения и анимация. (Унаследовано от CompositionObject)
DisconnectAnimation(String)	Отключает анимацию. (Унаследовано от CompositionObject)
Dispose()	Выполняет определяемые приложением задачи, связанные с удалением, высвобождением или сбросом неуправляемых ресурсов. (Унаследовано от CompositionObject)
InsertBoolean(String, Boolean)	Вставляет логическую пару "ключ-значение".
InsertColor(String, 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)	Запускает группу анимации. Метод StartAnimationGroup в CompositionObject позволяет запустить 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)	Извлекает указанное значение свойства Single .
TryGetVector2(String, Vector2)	Извлекает указанное значение свойства Vector2 .
TryGetVector3(String, Vector3)	Извлекает указанное значение свойства Vector3 .
TryGetVector4(String, Vector4)	Извлекает указанное значение свойства Vector4 .

См. также раздел

• CompositionObject
• IClosable