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 |
Представляет содержимое поверхности, которую можно использовать для закраски |
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 |