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

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

Классы

AmbientLight

Свет, который освещает каждый целевой визуальный элемент одинаково .

AnimationController

Предоставляет элементы управления воспроизведением для KeyFrameAnimation.

AnimationEndedEventArgs

Предоставляет данные события CompositionPropertyAnimator.AnimationEnded.

AnimationPropertyInfo

Представляет сведения о свойстве, которое можно анимировать.

BackEasingFunction

Представляет функцию плавности, которая изменяет значение в противоположном направлении функции main в течение части длительности, а затем изменяет и завершает поведение функции с течением времени обычным способом.

BooleanKeyFrameAnimation

Анимация на основе времени, предназначенная для логического свойства с одним или несколькими ключевыми кадрами.

BounceEasingFunction

Представляет функцию плавности, создающую анимированный эффект отскока.

BounceScalarNaturalMotionAnimation

Анимация на основе физики, предназначенная для любого скалярного свойства.

BounceVector2NaturalMotionAnimation

Анимация на основе физики, предназначенная для любого свойства на основе Vector2.

BounceVector3NaturalMotionAnimation

Анимация на основе физики, предназначенная для любого свойства на основе Vector3.

CircleEasingFunction

Представляет функцию плавности, которая создает анимацию для ускорения и замедления с помощью тригонометрической функции.

ColorKeyFrameAnimation

Анимация на основе времени, предназначенная для свойства Color с одним или несколькими ключевыми цветными кадрами.

Класс ColorKeyFrameAnimation является одним из поддерживаемых типов KeyFrameAnimation, который используется для анимации свойства Color вне свойства Brush в SpriteVisual. При работе с ColorKeyFrameAnimation используйте объекты Windows.UI.Color для значений ключевых кадров. Используйте свойство ИнтерполяцияColorSpace, чтобы определить, какое цветовое пространство система будет интерполировать для анимации.

CompositionAnimation

Представляет базовый класс анимации.

CompositionAnimationGroup

Определяет группу анимаций.

CompositionAnimationGroup предоставляет способ группировки CompositionAnimationв списке, который будет запущен одновременно при вызове StartAnimationGroup в CompositionObject. Для всех CompositionAnimation в CompositionAnimationGroup необходимо присвоить значение свойству Target в самой анимации. CompositionAnimationGroup также можно связать с ImplicitAnimationCollection как анимацию, которая выполняется в результате триггера.

CompositionBackdropBrush

Кисть, которая применяет эффект (или цепочку эффектов) к области за SpriteVisual.

CompositionBatchCompletedEventArgs

Аргументы для событий CompositionCommitBatch.Completed или CompositionScopedBatch.Completed .

CompositionBrush

Базовый класс для кистей, используемых для рисования SpriteVisual.

CompositionCapabilities

Предоставляет возможность проверка аппаратных возможностей системы, чтобы масштабировать эффекты визуального слоя соответствующим образом. Это позволяет гарантировать, что использование приложением операций с интенсивным использованием рендеринга соответствует возможностям устройства, обеспечивая оптимальную производительность и приятные визуальные результаты.

CompositionClip

Базовый класс для обрезки объектов, таких как InsetClip.

CompositionColorBrush

Закрашивает spriteVisual сплошным цветом.

CompositionColorGradientStop

Описывает местоположение и цвет точки перехода в градиенте.

CompositionColorGradientStopCollection

Представляет коллекцию объектов CompositionColorGradientStop , к которым можно получить отдельный доступ по индексу.

CompositionCommitBatch

Группа активных анимаций или эффектов.

CompositionContainerShape

Представляет контейнер для CompositionShapes, используемый для группировки элементов, совместно использующих двухd-преобразования.

CompositionDrawingSurface

Поверхность рисования для взаимодействия с Direct2D или Direct3D.

CompositionEasingFunction

Базовый класс для функций интерполятора, используемых с KeyFrameAnimations.

Класс CompositionEasingFunction является базовым классом для упрощения функций, используемых с keyFrameAnimation . Функции упрощения используются для описания интерполяции системы между двумя разными ключевыми кадрами. Список поддерживаемых функций для облегчения см. в разделе Типы в разделе Производные функции.

CompositionEffect

Представляет эффект.

CompositionEffectBrush

Закрашивает SpriteVisual выходными данными эффекта фильтра. Описание эффекта фильтра определяется с помощью класса CompositionEffectFactory .

CompositionEffectFactory

Создает объект композиции, содержащий формат описания эффекта Win2D в пространстве имен Microsoft.Graphics.Canvas.Effects .

Примечание

Эффекты, которые не поддерживаются, помечены как [NoComposition] в справочнике по API Win2D для пространства имен эффектов.

CompositionEffectFactoryLoadResult

Представляет сведения о результатах вызова состояния вызова CompositionEffectFactory.CompleteLoadAsync.

CompositionEffectSourceParameter

Используется для объявления произвольного имени (string), связанного с CompositionBrush ("источник эффекта"). Связь заданного имени и источника эффекта возникает при вызове метода SetSourceParameterобъекта CompositionEffectBrush .

CompositionEllipseGeometry

Представляет эллипс с указанным центром и радиусом.

CompositionGeometricClip

Представляет фигуру, которая обрезает часть визуального элемента. Видимая часть визуального элемента — это фигура, определяемая CompositionGeometry. Часть визуального элемента за пределами геометрии обрезается.

CompositionGeometry

Представляет базовый класс для геометрических объектов композиции.

CompositionGradientBrush

Представляет кисть, описывающую градиент, состоящий из остановок градиента.

CompositionGradientBrush поддерживается только в Rgb и RgbLinear CompositionColorSpace.

CompositionGraphicsDevice

Используется для создания всех аппаратных ресурсов для данного устройства DirectX в сеансе компонатора. CompositionGraphicsDevice содержит устройство DirectX, используемое для выполнения операций GPU. Разработчики могут получить графическое устройство из объекта верхнего уровня композитатора.

CompositionImage

Представляет изображение.

CompositionImageLoadResult

Представляет результат загрузки CompositionImage.

CompositionImageOptions

Представляет параметры для объекта CompositionImage.

CompositionLight

Базовый класс для источника света, который может ориентироваться на сцену пользовательского интерфейса.

Свойство CompositionLight.Targets определяет, какие визуальные элементы освещаются.

CompositionLinearGradientBrush

Представляет кисть, которая закрашивает область линейным градиентом.

CompositionLineGeometry

Представляет прямую линию между двумя точками.

CompositionMaskBrush

Рисует spriteVisual с помощью CompositionBrush с примененной к нему маской непрозрачности. Источником маски непрозрачности может быть любой объект CompositionBrush типа CompositionColorBrush, CompositionLinearGradientBrush, CompositionSurfaceBrush, CompositionEffectBrush или CompositionNineGridBrush. Маска непрозрачности должна быть указана как CompositionSurfaceBrush.

CompositionMipmapSurface

Представляет поверхность рисования для текстур MIP-карты.

CompositionNineGridBrush

Рисует SpriteVisual с помощью CompositionBrush после применения Nine-Grid Растяжения к содержимому исходной кисти. Источник растяжения с девятью сетками может быть любым CompositionBrush типа CompositionColorBrush, CompositionSurfaceBrush или CompositionEffectBrush.

CompositionObject

Базовый класс API композиции, представляющий узел в структуре визуального дерева.

Объекты композиции — это структура визуального дерева, на основе которой используются и опираются все остальные функции API композиции. API позволяет разработчикам определять и создавать один или несколько объектов Visual , каждый из которых представляет один узел в визуальном дереве.

CompositionPath

Представляет последовательность соединенных линий и кривых.

CompositionPathGeometry

Представляет последовательность соединенных линий и кривых.

CompositionProjectedShadow

Представляет тень на основе сцены, вычисленную с помощью связи между светом, визуальным элементом, который отбрасывает тень, и визуальным элементом, получающим тень, таким образом, тень рисуется по-разному на каждом приемнике.

CompositionProjectedShadowCaster

Представляет объект, который отбрасывает проецированную тень.

CompositionProjectedShadowCasterCollection

Представляет коллекцию объектов CompositionProjectedShadowCaster.

CompositionProjectedShadowReceiver

Представляет объект, на который может быть проецирована тень.

CompositionProjectedShadowReceiverUnorderedCollection

Представляет неупорядоченную коллекцию объектов CompositionProjectedShadowReceiver.

CompositionPropertyAnimator

Анимирует свойства композиции.

CompositionPropertySet

Хранит значения в виде пар "ключ-значение".

CompositionRadialGradientBrush

Представляет кисть, которая закрашивает область радиальным градиентом.

CompositionRectangleGeometry

Предупреждение

Этот API содержит известную проблему в Windows 10 версии 2004 и ниже. Не используйте этот API в коде.

Представляет форму прямоугольника указанного размера. Чтобы получить экземпляр CompositionRectangleGeometry , вызовите Compositor.CreateRectangleGeometry.

CompositionRoundedRectangleGeometry

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

CompositionScopedBatch

Явно созданная группа активных анимаций или эффектов.

CompositionShadow

Базовый класс для теней, которые можно применить к SpriteVisual.

CompositionShape

Представляет базовый класс фигуры.

CompositionShapeCollection

Представляет коллекцию объектов CompositionShape , доступ к которым можно получить по отдельности по индексу.

CompositionSpriteShape

Объект CompositionShape, который рисует Stroked и Filled CompositionGeometry.

CompositionStrokeDashArray

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

CompositionSurfaceBrush

Закрашивает объект SpriteVisual пикселями из объекта ICompositionSurface.

CompositionTarget

Представляет окно, в котором отображается дерево композиции.

CompositionTexture

Представляет необработанную текстуру Direct3D, которую можно привязать к визуальному элементу композиции в качестве содержимого. Объект можно использовать в любом месте, где в настоящее время можно использовать универсальную поверхность композиции в этих API, например в качестве содержимого визуального элемента спрайта или поверхностной кисти. Объект предоставляет доступное ограждение, которое можно использовать для синхронизации отрисовки и композиции приложения. Также может принимать различные атрибуты, такие как альфа-режим, исходный прямоугольник и цветовое пространство, для более точного определения отображаемого содержимого.

API текстур композиции поддерживает только Direct3D 11.

CompositionTransform

Обеспечивает поддержку универсального преобразования для объектов композиции.

CompositionViewBox

Представляет контейнер, который сопоставляет координаты визуального дерева с визуальным элементом.

CompositionVirtualDrawingSurface

Представляет редко выделенные растровые изображения, которые могут быть связаны с визуальными элементами для композиции в визуальном дереве.

CompositionVisualSurface

Представляет визуальное дерево в виде ICompositionSurface, которое можно использовать для рисования визуального элемента с помощью CompositionBrush.

Compositor

Управляет сеансом между приложением и процессом композитора системы.

Класс Compositor создает экземпляр Compositor для приложения, который можно использовать в качестве фабрики для различных типов в пространстве имен Windows.UI.Composition, охватывающем визуальный слой, систему эффектов и систему анимации. Класс Compositor также управляет временем существования объектов, созданных из фабрики.

ContainerVisual

Узел в визуальном дереве, который может иметь дочерние элементы.

CubicBezierEasingFunction

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

DelegatedInkTrailVisual

Представляет "мокрый" росчерк рукописного ввода, отображаемый системой, в то время как приложение обрабатывает "сухой" проход отрисовки рукописного ввода.

DistantLight

Бесконечно большой удаленный источник света, излучающий свет в одном направлении. Например, для представления солнечного света можно использовать далекий свет.

DropShadow

Тени, отбрасываемые spriteVisual или LayerVisual.

EffectVisual

Представляет узел визуального дерева, который является корнем compositionEffect.

ElasticEasingFunction

Представляет функцию плавности для создания анимации, напоминающую пружину, которая колеблется вперед-назад до полного успокоения.

ExponentialEasingFunction

Представляет функцию плавности, создающую анимацию, в которой ускорение и замедление задается с помощью экспоненциальной формулы.

ExpressionAnimation

Анимация композиции, использующая математическое уравнение для вычисления значения свойства анимации для каждого кадра.

ImageVisual

Представляет узел визуального дерева, который является корнем compositionImage.

ImplicitAnimationCollection

Коллекция анимаций, активируется при выполнении условия.

InitialValueExpressionCollection

Коллекция значений, указывающих, с чего начнется анимация.

InsetClip

Представляет прямоугольник, который обрезает часть визуального элемента. Часть визуального элемента внутри прямоугольника видна; Часть визуального элемента за пределами прямоугольника обрезается.

KeyFrameAnimation

Анимация на основе времени с одним или несколькими ключевыми кадрами. Эти кадры представляют собой маркеры, позволяющие разработчикам указывать значения в определенное время для свойства анимации. Анимацию по ключевым кадрам можно дополнительно настроить, указав способ интерполяции анимации между ключевыми кадрами.

LayerVisual

Объект ContainerVisual, дочерние элементы которого разделены в один слой.

LinearEasingFunction

Представляет линейную функцию для интерполяции между ключевыми кадрами анимации.

NaturalMotionAnimation

Представляет анимацию на основе физики, которая использует силы для динамического перемещения содержимого.

PathKeyFrameAnimation

Предупреждение

Этот API содержит известную проблему в Windows 10 версии 20H2 и ниже. Не используйте этот API в коде.

Представляет анимацию на основе времени с одним или несколькими ключевыми кадрами, где каждое значение ключевого кадра представлено CompositionPath. Реалистичная анимация определяет взаимодействие между путями.

PointLight

Точечный источник света, который излучает свет во всех направлениях.

PowerEasingFunction

Представляет функцию для реалистичной анимации, которая создает анимацию, которая ускоряется и (или) замедляется с помощью формулы f (t) = t*p*, где p равно свойству Power .

QuaternionKeyFrameAnimation

Анимация на основе времени, ориентированная на свойство Orientation с одним или несколькими ключевыми кадрами.

Класс QuaternionKeyFrameAnimation является одним из поддерживаемых типов keyFrameAnimation, который используется для анимации свойства Orientationв визуальном элементе. Кватернионы — это полезный, а иногда и более простой способ думать о поворотах. Кватернионы принимают кратчайший путь между углами и избежать таких проблем, как gimbal Lock, с которыми возникают угол/ось поворота и матрицы поворота. Кватернион состоит из двух компонентов: скалярной и векторной части.

RectangleClip

Представляет прямоугольник с необязательными скругленными углами, который обрезает часть визуального элемента. Часть визуального элемента внутри прямоугольника видна; Часть визуального элемента за пределами прямоугольника обрезается.

RedirectVisual

Представляет визуальный элемент, который получает свое содержимое из другого визуального элемента.

RenderingDeviceReplacedEventArgs

Аргументы для события RenderingDeviceReplaced .

ScalarKeyFrameAnimation

Анимация на основе времени, ориентированная на любое скалярное свойство с одним или несколькими ключевыми кадрами.

ScalarNaturalMotionAnimation

Базовый Scalar NaturalMotionAnimation, используемый для нацеливания на скалярное свойство.

ShapeVisual

Представляет узел визуального дерева, который является корнем CompositionShape.

SineEasingFunction

Представляет функцию для реалистичной анимации, создающую анимацию, которая ускоряется и замедляется по формуле синуса.

SolidColorVisual

Представляет сплошной цвет.

SpotLight

Источник света, который отбрасывает внутренние и внешние конусы света. Например, фонарик.

SpringScalarNaturalMotionAnimation

Весенняя физическая анимация, ориентированная на любое скалярное свойство.

SpringVector2NaturalMotionAnimation

Анимация на основе физики spring, которая нацелена на любое свойство на основе Vector2.

SpringVector3NaturalMotionAnimation

Весенняя физическая анимация, ориентированная на любое свойство на основе Vector3.

SpriteVisual

Размещает двухd-упакованое содержимое типа CompositionBrush. Любая часть визуального элемента, не покрытая пикселями от кисти, отрисовывается как прозрачные пиксели. CompositionBrush может быть CompositionBackdropBrush, CompositionColorBrush, CompositionSurfaceBrush или CompositionEffectBrush.

StepEasingFunction

Пошаговая функция для интерполяции между ключевыми кадрами анимации, которая перемещает анимации с шагом, например шаги, которые можно определить. Поведение для начального и заключительного шагов можно настроить.

Vector2KeyFrameAnimation

Анимация на основе времени, ориентированная на любое свойство на основе Vector2 с одним или несколькими ключевыми кадрами.

Vector2NaturalMotionAnimation

Базовый Vector2 NaturalMotionAnimation, используемый для назначения свойства Vector2.

Vector3KeyFrameAnimation

Анимация на основе времени, ориентированная на любое свойство на основе Vector3 с одним или несколькими ключевыми кадрами.

Vector3NaturalMotionAnimation

Базовый Vector3 NaturalMotionAnimation, используемый для назначения свойства Vector3.

Vector4KeyFrameAnimation

Анимация на основе времени, ориентированная на любое свойство на основе Vector4 с одним или несколькими ключевыми кадрами.

Visual

Базовый визуальный объект в визуальной иерархии.

VisualCollection

Представляет коллекцию визуальных экземпляров.

VisualUnorderedCollection

Неупорядоченная коллекция визуальных элементов.

Структуры

InkTrailPoint

Представляет одну точку для DelegatedInkTrailVisual.

Интерфейсы

IAnimationObject

Представляет объект со свойствами, на которые можно ссылаться с помощью анимации.

ICompositionAnimationBase

Базовый класс для анимаций композиции.

ICompositionSupportsSystemBackdrop

Предоставляет свойство для работы с CompositionBrush в качестве системного фона. SpriteVisual с заданным CompositionBrush будет помещен в задней части поддеревь реализующего объекта.

ICompositionSurface

Представляет содержимое поверхности, которую можно использовать для закраски SpriteVisualграниц объекта .

ICompositionSurfaceFacade

Представляет заполнитель для поверхности композиции, которую можно использовать как реальную поверхность композиции.

IVisualElement

Помечает объект , чтобы указать системе, что он может разрешить в визуальный элемент композиции.

IVisualElement2

Предоставляет метод, который извлекает базовый визуальный элемент объекта.

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

AnimationControllerProgressBehavior

Определяет константы, определяющие способ определения значения AnimationController.Progress .

AnimationDelayBehavior

Задает поведение задержки анимации.

AnimationDirection

Задает направление воспроизведения анимации.

AnimationEndReason

Определяет константы, определяющие причину завершения анимации.

AnimationIterationBehavior

Указывает, должна ли анимация циклически выполняться.

AnimationPropertyAccessMode

Определяет константы, определяющие, как можно получить доступ к анимированному свойству.

AnimationStopBehavior

Указывает поведение анимации при ее остановке.

CompositionBackfaceVisibility

Указывает, отображается ли задняя часть визуального элемента во время трехмерного преобразования.

CompositionBatchTypes

Типы пакетов для CompositionCommitBatch и CompositionScopedBatch.

CompositionBitmapInterpolationMode

Задает алгоритм, используемый для интерполяции пикселей из ICompositionSurface, если они не формируют сопоставление "один к одному" с пикселями на экране.

CompositionBorderMode

Управляет поведением псевдонимов на краях границ визуальных элементов.

CompositionColorSpace

Задает цветовое пространство для интерполяции значений цвета в ColorKeyFrameAnimation.

CompositionCompositeMode

Определяет, как содержимое непрозрачного визуального элемента смешивается с фоновым содержимым, лежащим в основе визуального элемента.

CompositionDropShadowSourcePolicy

Задает политику маскирования для тени.

CompositionEasingFunctionMode

Определяет константы, указывающие способ интерполяции анимации, связанной с функцией облегчения.

CompositionEffectFactoryLoadStatus

Состояние асинхронной компиляции шейдера для описания эффекта.

CompositionGetValueStatus

Указывает результат попытки получить значение пары "ключ-значение".

CompositionGradientExtendMode

Определяет константы, определяющие способ рисования градиента за пределами вектора градиента или пространства кисти.

CompositionImageLoadStatus

Определяет константы, определяющие состояние вызова CompositionImage.CompleteLoadAsync.

CompositionImageProgressStage

Определяет константы, определяющие ход загрузки CompositionImage.

CompositionMappingMode

Определяет константы, указывающие, являются ли координаты положения кисти градиента (StartPoint, EndPoint) абсолютными или относительно области вывода.

CompositionStretch

Указывает, как масштабируется содержимое при сопоставлении из источника в целевое пространство.

CompositionStrokeCap

Определяет константы, указывающие фигуру в конце линии или сегмента.

CompositionStrokeLineJoin

Определяет константы, указывающие фигуру, используемую для соединения двух линий или сегментов.

Комментарии

Общие сведения, примеры и известные проблемы Windows.UI.Composition

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

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