Microsoft.UI.Composition Пространство имен

Предоставляет API для композиции пользовательского интерфейса.

Классы

Имя	Описание
AmbientLight	Свет, который освещает каждый целевой визуальный элемент одинаково.
AnimationController	Предоставляет элементы управления воспроизведением для KeyFrameAnimation.
AnimationPropertyInfo	Представляет сведения о свойстве, которое может быть анимировано.
BackEasingFunction	Представляет функцию облегчения, которая немного отнимает движение анимации, прежде чем она начинает анимироваться в указанном пути.
BooleanKeyFrameAnimation	Анимация на основе времени, предназначенная для логического свойства с одним или несколькими ключевыми кадрами.
BounceEasingFunction	Представляет функцию упрощения, которая создает анимированный эффект отскоки.
BounceScalarNaturalMotionAnimation	Анимация на основе физики, предназначенная для любого скалярного свойства.
BounceVector2NaturalMotionAnimation	Анимация на основе физики, предназначенная для любого свойства на основе Vector2.
BounceVector3NaturalMotionAnimation	Анимация на основе физики, предназначенная для любого свойства на основе Vector3.
CircleEasingFunction	Представляет функцию упрощения, которая создает анимацию, которая ускоряет и (или) уменьшается с помощью циклической функции.
ColorKeyFrameAnimation	Анимация на основе времени, предназначенная для свойства Color с одним или несколькими ключевыми кадрами цветов. Класс ColorKeyFrameAnimation является одним из поддерживаемых типов keyFrameAnimations, используемых для анимации свойства Color от свойства Brush в spriteVisual. При работе с ColorKeyFrameAnimation используйте Windows. Пользовательского интерфейса. Цветовые объекты для значений ключевых кадров. Используйте свойство ИнтерполяцияColorSpace, чтобы определить, какое цветовое пространство система будет интерполироваться для анимации.
CompositionAnimation	Представляет базовый класс анимации.
CompositionAnimationGroup	Определяет группу анимаций. CompositionAnimationGroup предоставляет способ группировать s CompositionAnimationв списке, который будет запущен в то же время, когда StartAnimationGroup вызывается в CompositionObject. Все compositionAnimation в CompositionAnimationGroup должны назначить значение свойству Target в самой анимации. CompositionAnimationGroup также может быть связана с НеявнымAnimationCollection как анимация, которая выполняется в результате триггера.
CompositionApiInformation	Представляет сведения об API композиции.
CompositionBackdropBrush	Кисть, которая применяет эффект (или цепочку эффектов) к региону за spriteVisual.
CompositionBatchCompletedEventArgs	Аргументы для событий CompositionCommitBatch.Completed или CompositionScopedBatch.Completed .
CompositionBrush	Базовый класс для кистей, используемых для рисования SpriteVisual.
CompositionCapabilities	Предоставляет возможность проверять возможности системного оборудования таким образом, чтобы эффекты визуального слоя могли масштабироваться соответствующим образом. Это позволяет гарантировать, что использование приложений интенсивной отрисовки предназначено для соответствия возможностям устройства, обеспечивая оптимальную производительность и приятные визуальные результаты.
CompositionClip	Базовый класс для обрезки объектов, таких как InsetClip.
CompositionColorBrush	Рисует spriteVisual с сплошным цветом.
CompositionColorGradientStop	Описывает расположение и цвет точки перехода в градиенте.
CompositionColorGradientStopCollection	Представляет коллекцию объектов CompositionColorGradientStop , к которым можно получить отдельный доступ по индексу.
CompositionCommitBatch	Группа активных анимаций или эффектов.
CompositionContainerShape	Представляет контейнер для CompositionShapes, используемый для группирования элементов, которые совместно используют преобразования 2D.
CompositionDrawingSurface	Область рисования для взаимодействия с Direct2D или Direct3D.
CompositionEasingFunction	Базовый класс для функций интерполятора, используемых с KeyFrameAnimations. Класс CompositionEasingFunction — это базовый класс для функций упрощения, используемых с keyFrameAnimation . Функции упрощения используются для описания интерполяции системы между двумя разными ключевыми кадрами. В настоящее время существуют три поддерживаемых функции упрощения: линейная, кубическая bezier и шаг.
CompositionEffectBrush	Рисует spriteVisual с выходными данными эффекта фильтра. Описание эффекта фильтра определяется с помощью класса CompositionEffectFactory .
CompositionEffectFactory	Создает объект композиции, содержащий формат описания эффекта Win2D в Microsoft. Пространство имен Graphics.Canvas.Effects (Windows App SDK (WinUI 3) / UWP (WinUI 2)). Note Эффекты, которые не поддерживаются, помечены как [NoComposition] в справочнике по API Win2D для пространства имен эффектов.
CompositionEffectSourceParameter	Используется для объявления произвольного имени (строки), связанного с CompositionBrush (источником эффекта). Связь заданного имени и источника эффекта возникает при вызове метода SetSourceParameterобъекта CompositionEffectBrush .
CompositionEllipseGeometry	Представляет многоточие с указанным центром и радиусом.
CompositionEngine	Предоставляет статические методы для выбора и извлечения обработчиков композиции. Это нестабильная функция ограниченного доступа (LAF), которая позволяет приложениям использовать ОС в качестве обработчика API композиции, а не подсистему внутрипроцессного процесса по умолчанию.
CompositionGeometricClip	Представляет фигуру, которая обрезает часть визуального элемента. Видимая часть визуального элемента — это фигура, определяемая композициейGeometry. Часть визуального элемента за пределами геометрии обрезается.
CompositionGeometry	Представляет базовый класс для геометрий композиции.
CompositionGradientBrush	Представляет кисть, описывающую градиент, состоящий из остановок градиента. CompositionGradientBrush поддерживается только с Rgb и RgbLinear CompositionColorSpace.
CompositionGraphicsDevice	Используется для создания всех аппаратных привязанных ресурсов для данного устройства DirectX на сеансе компостора. CompositionGraphicsDevice содержит устройство DirectX, используемое для выполнения операций GPU. Разработчики могут получить графическое устройство из объекта верхнего уровня компостора.
CompositionLight	Базовый класс для источника света, который может нацелиться на сцену пользовательского интерфейса. Свойство CompositionLight.Targets определяет, какие визуальные элементы зажигаются.
CompositionLinearGradientBrush	Представляет кисть, которая красит область с линейным градиентом.
CompositionLineGeometry	Представляет прямую линию между двумя точками.
CompositionMaskBrush	Рисует SpriteVisual с помощью CompositionBrush с маской непрозрачности, примененной к нему. Источником маски непрозрачности может быть любой CompositionBrush типа CompositionColorBrush, CompositionLinearGradientBrush, CompositionSurfaceBrush, CompositionEffectBrush или CompositionNineGridBrush. Маска непрозрачности должна быть указана как CompositionSurfaceBrush.
CompositionMipmapSurface	Представляет область рисования для текстур mipmap.
CompositionNineGridBrush	Рисует SpriteVisual с помощью CompositionBrush после применения Nine-Grid Stretching к содержимому исходной кисти. Источник девятисетевой растяжения может быть любой CompositionBrush типа CompositionColorBrush, CompositionSurfaceBrush или CompositionEffectBrush.
CompositionObject	Базовый класс API композиции, представляющий узел в структуре визуального дерева. Объекты композиции — это структура визуального дерева, на которой используются и строятся все остальные функции API композиции. API позволяет разработчикам определять и создавать один или несколько визуальных объектов, каждый из которых представляет один узел в визуальном дереве.
CompositionPath	Представляет ряд подключенных линий и кривых.
CompositionPathGeometry	Представляет ряд подключенных линий и кривых.
CompositionProjectedShadow	Представляет тень на основе сцены, вычисляемую с помощью связи между светом, визуальным элементом, который вызывает тень, и визуальный элемент, получающий тень, таким образом, тень рисуется по-разному на каждом приемнике.
CompositionProjectedShadowCaster	Представляет объект, который вызывает проецированную тень.
CompositionProjectedShadowCasterCollection	Представляет коллекцию объектов CompositionProjectedShadowCaster.
CompositionProjectedShadowReceiver	Представляет объект, который может иметь проецируемый теневой приведение к нему.
CompositionProjectedShadowReceiverUnorderedCollection	Представляет неупорядоченную коллекцию объектов CompositionProjectedShadowReceiver.
CompositionPropertySet	Сохраняет значения в виде пар "ключ-значение".
CompositionRadialGradientBrush	Представляет кисть, которая красит область радиальным градиентом.
CompositionRectangleGeometry	Представляет прямоугольную фигуру указанного размера.
CompositionRoundedRectangleGeometry	Представляет прямоугольник указанного размера с округленными углами.
CompositionScopedBatch	Явно созданная группа активных анимаций или эффектов.
CompositionShadow	Базовый класс для теней, которые можно применить к SpriteVisual.
CompositionShape	Представляет базовый класс фигуры.
CompositionShapeCollection	Представляет коллекцию объектов CompositionShape , к которым можно получить отдельный доступ по индексу.
CompositionSpriteShape	КомпозицияShape, которая рисует росчерк и заполненную композициюGeometry.
CompositionStrokeDashArray	Представляет коллекцию значений, указывающих шаблон дефисов и пробелов, используемых для контура фигур.
CompositionSurfaceBrush	Рисует spriteVisual с пикселями из ICompositionSurface.
CompositionTransform	Предоставляет обобщенную поддержку преобразования для объектов композиции.
CompositionViewBox	Представляет контейнер, который сопоставляет координаты визуального дерева фигуры с визуальным элементом.
CompositionVirtualDrawingSurface	Представляет разреженные растровые изображения, которые могут быть связаны с визуальными элементами для композиции в визуальном дереве.
CompositionVisualSurface	Представляет визуальное дерево как ICompositionSurface, которое можно использовать для рисования визуального элемента с помощью CompositionBrush.
Compositor	Управляет сеансом между приложением и процессом компостатора системы. Класс Compositor создает экземпляр Compositor для приложения, который можно использовать в качестве фабрики для различных типов в Microsoft. Пользовательского интерфейса. Пространство имен композиции, охватывающее визуальный слой, систему эффектов и систему анимации. Класс Compositor также управляет жизненным циклом объектов, созданных фабрикой.
ContainerVisual	Узел в визуальном дереве, который может иметь дочерние элементы.
CubicBezierEasingFunction	Представляет функцию кубо-bezier для интерполяции между ключевыми кадрами анимации. Функция кубо-bezier является одной из наиболее распространенных функций упрощения, используемых с keyFrameAnimations и часто используется для описания гладких кривых, которые можно масштабировать. Функции кубо-безье определяются двумя "контрольными точками" типа Vector2, определяющими форму кривой. При использовании свойство анимации изменится между двумя ключевыми кадрами на основе определенной кривой.
DistantLight	Бесконечно большой удаленный источник света, который выдает свет в одном направлении. Например, удаленный свет может использоваться для представления солнечного света.
DropShadow	Падение тени, отбрасываемой spriteVisual или LayerVisual.
ElasticEasingFunction	Представляет функцию упрощения, которая создает анимацию, которая напоминает весеннюю колебания назад и вперед, пока не придется отдохнуть.
ExponentialEasingFunction	Представляет функцию упрощения, которая создает анимацию, которая ускоряет и (или) уменьшается с помощью экспоненциальной формулы.
ExpressionAnimation	Анимация композиции, использующая математическое уравнение для вычисления значения для анимации свойства каждого кадра.
ImplicitAnimationCollection	Коллекция анимаций, активируется при выполнении условия.
InitialValueExpressionCollection	Коллекция значений, указывающая, где будет начинаться анимация.
InsetClip	Представляет прямоугольник, который обрезает часть визуального элемента. Часть визуального элемента внутри прямоугольника отображается; Часть визуального элемента за пределами прямоугольника обрезается.
KeyFrameAnimation	Анимация на основе времени с одним или несколькими ключевыми кадрами. Эти кадры являются маркерами, что позволяет разработчикам указывать значения в определенное время для свойства анимации. Анимации ключевых кадров можно дополнительно настроить, указав способ интерполяции анимации между ключевыми кадрами.
LayerVisual	КонтейнерVisual, дочерние элементы которого плоские в один слой.
LinearEasingFunction	Представляет линейную функцию для интерполяции между ключевыми кадрами анимации.
NaturalMotionAnimation	Представляет анимацию на основе физики, которая использует силы для динамического перемещения содержимого.
PathKeyFrameAnimation	Представляет анимацию на основе времени с одним или несколькими ключевыми кадрами, где каждое значение ключевого кадра представлено CompositionPath. Упрощение определяет взаимодействие между путями.
PointLight	Источник света, который исходят светом во всех направлениях.
PowerEasingFunction	Представляет функцию упрощения, которая создает анимацию, которая ускоряет и/или уменьшается с помощью формулы f(t) = tp , где p равно свойству Power .
QuaternionKeyFrameAnimation	Анимация на основе времени, предназначенная для свойства Orientation с одним или несколькими ключевыми кадрами. Класс QuaternionKeyFrameAnimation является одним из поддерживаемых типов ключей KeyFrameAnimation, используемых для анимации свойства Orientation в визуальном элементе. Кватернионы — это удобный и иногда простой способ подумать о поворотах — Кватернионы принимают самый короткий путь между углами и избежать таких проблем, как Гимблальная блокировка, вращающаяся угол или ось и матрицы поворота. Кватернион состоит из двух компонентов: скалярной и векторной части.
RectangleClip	Представляет прямоугольник с необязательными закругленными углами, которые обрезают часть визуального элемента. Часть визуального элемента внутри прямоугольника отображается; Часть визуального элемента за пределами прямоугольника обрезается.
RedirectVisual	Представляет визуальный элемент, который получает его содержимое из другого визуального элемента.
RenderingDeviceReplacedEventArgs	Аргументы события RenderingDeviceReplaced .
ScalarKeyFrameAnimation	Анимация на основе времени, предназначенная для любого скалярного свойства с одним или несколькими ключевыми кадрами.
ScalarNaturalMotionAnimation	Базовая Scalar NaturalMotionAnimation, используемая для целевого свойства Scalar.
ShapeVisual	Представляет узел визуального дерева, который является корнем объекта CompositionShape.
SineEasingFunction	Представляет функцию упрощения, которая создает анимацию, которая ускоряет и/или уменьшается с помощью синусовой формулы.
SpotLight	Источник света, который приводит внутренние и внешние конусы света. Например, фонарик.
SpringScalarNaturalMotionAnimation	Анимация на основе весны, предназначенная для любого свойства скалярной физики.
SpringVector2NaturalMotionAnimation	Анимация на основе весны, предназначенная для любого свойства на основе Vector2.
SpringVector3NaturalMotionAnimation	Анимация на основе весны на основе физики, предназначенная для любого свойства на основе Vector3.
SpriteVisual	Содержит 2D-содержимое типа CompositionBrush. Любая часть визуального элемента, не охватываемая пикселями с кисти, отображается как прозрачные пиксели. CompositionBrush может быть композициейBackdropBrush, CompositionColorBrush, CompositionSurfaceBrush или CompositionEffectBrush.
StepEasingFunction	Функция шага для интерполяции между ключевыми кадрами анимации. Перемещает анимацию в добавочных шагах, которые можно определить. Можно настроить поведение для начальных и окончательных шагов.
Vector2KeyFrameAnimation	Анимация на основе времени, предназначенная для любого свойства на основе Vector2 с одним или несколькими ключевыми кадрами.
Vector2NaturalMotionAnimation	Base Vector2 NaturalMotionAnimation, используемый для назначения свойства Vector2.
Vector3KeyFrameAnimation	Анимация на основе времени, предназначенная для любого свойства на основе Vector3 с одним или несколькими ключевыми кадрами.
Vector3NaturalMotionAnimation	Base Vector3 NaturalMotionAnimation, используемый для назначения свойства Vector3.
Vector4KeyFrameAnimation	Анимация на основе времени, предназначенная для любого свойства на основе Vector4 с одним или несколькими ключевыми кадрами.
Visual	Базовый визуальный объект в визуальной иерархии.
VisualCollection	Представляет коллекцию визуальных экземпляров.
VisualUnorderedCollection	Неупорядоченная коллекция визуальных элементов.

Интерфейсы

Имя	Описание
IAnimationObject	Представляет объект с свойствами, на которые можно ссылаться анимацией.
ICompositionAnimationBase	Базовый класс для анимаций композиции.
ICompositionSupportsSystemBackdrop	Предоставляет свойство для работы с CompositionBrush в качестве системного фона. SpriteVisual с заданным CompositionBrush будет помещен в задней части поддерев объекта реализации.
ICompositionSurface	Представляет содержимое поверхности, которую можно использовать для рисования границы.SpriteVisual
ICompositionSurfaceFacade	Представляет заполнитель для поверхности композиции, которая может использоваться как реальная поверхность композиции.
IVisualElement	Помечает объект, указывающий системе, которую она может разрешить в состав Visual
IVisualElement2	Предоставляет метод, который извлекает базовый визуальный элемент объекта.

Перечисления

Имя	Описание
AnimationControllerProgressBehavior	Определяет константы, определяющие, как определяется значение AnimationController.Progress .
AnimationDelayBehavior	Указывает поведение задержки анимации.
AnimationDirection	Указывает направление воспроизведения анимации.
AnimationIterationBehavior	Указывает, должна ли анимация циклироваться.
AnimationPropertyAccessMode	Определяет константы, определяющие способ доступа к анимированному свойству.
AnimationStopBehavior	Указывает поведение анимации при его остановке.
CompositionBackfaceVisibility	Указывает, отображается ли заднее лицо визуального элемента во время трехмерного преобразования.
CompositionBatchTypes	Типы пакетов для CompositionCommitBatch и CompositionScopedBatch.
CompositionBitmapInterpolationMode	Задает алгоритм, используемый для интерполяции пикселей из ICompositionSurface, если они не образуют одно-одно сопоставление с пикселями на экране.
CompositionBorderMode	Управляет поведением псевдонима на краях визуальных границ.
CompositionColorSpace	Задает цветовое пространство для интерполяции значений цветов в ColorKeyFrameAnimation.
CompositionCompositeMode	Определяет, как содержимое непрозрачного визуального элемента смешивается с фоновым содержимым, лежащим в основе визуального элемента.
CompositionDropShadowSourcePolicy	Задает политику маскирования для тени.
CompositionEasingFunctionMode	Определяет константы, указывающие, как анимация, связанная с интерполяцией функции упрощения.
CompositionEffectFactoryLoadStatus	Состояние асинхронной компиляции шейдера для описания эффекта.
CompositionEngineType	Определяет тип обработчика композиции, используемого для API композиции.
CompositionGetValueStatus	Указывает результат попытки получить значение пары "ключ-значение".
CompositionGradientExtendMode	Определяет константы, определяющие способ рисования градиента за пределами вектора градиента или пространства кисти.
CompositionMappingMode	Определяет константы, указывающие, являются ли координаты расположения градиентной кисти (StartPoint, EndPoint) абсолютными или относительными к области вывода.
CompositionStretch	Указывает, как содержимое масштабируется при сопоставлении с его источником с целевого пространства.
CompositionStrokeCap	Определяет константы, указывающие фигуру в конце линии или сегмента.
CompositionStrokeLineJoin	Определяет константы, указывающие фигуру, используемую для объединения двух линий или сегментов.

Комментарии

Windows. Пользовательского интерфейса. Обзоры композиции, примеры и известные проблемы

Элемент	Описание
Windows. Пользовательского интерфейса. Обзор композиции	Обзор и архитектура API
Windows. Пользовательский интерфейс. Примеры композиции	Примеры API в официальном Github
Известные проблемы и последние сведения	Последние обновления API на форумах MSDN

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

• ElementCompositionPreview
• Визуальный элемент композиции без примера платформы (Windows 10)
• Пример адаптивного кода версии