Microsoft.UI.Composition Пространство имен
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет API для создания пользовательского интерфейса.
Классы
AmbientLight |
Свет, который освещает каждый целевой визуальный элемент одинаково . |
AnimationController |
Предоставляет элементы управления воспроизведением для KeyFrameAnimation. |
AnimationPropertyInfo |
Представляет сведения о свойстве, которое можно анимировать. |
BackEasingFunction |
Представляет функцию плавности, возвращающую движение анимации незадолго до того, как начинается анимация по заданному пути. |
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 как анимация, которая выполняется в результате триггера. |
CompositionApiInformation |
Представляет сведения об API композиции. |
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 . Функции для упрощения используются для описания того, как система интерполирует два разных ключевых кадра. В настоящее время поддерживаются три функции для реалистичной анимации: Linear, Cubic Bezier и Step. |
CompositionEffectBrush |
Закрашивает объект SpriteVisual с выходными данными эффекта фильтра. Описание эффекта фильтра определяется с помощью класса CompositionEffectFactory . |
CompositionEffectFactory |
Создает объект композиции, содержащий формат описания эффекта Win2D в пространстве имен Microsoft.Graphics.Canvas.Effects (WinAppSDK (WinUI 3) / UWP (WinUI 2)). Примечание Эффекты, которые не поддерживаются, помечены как [NoComposition] в справочнике по API Win2D для пространства имен эффектов. |
CompositionEffectSourceParameter |
Используется для объявления произвольного имени (string), связанного с CompositionBrush ("источник эффекта"). Связь заданного имени и источника эффекта возникает при вызове метода SetSourceParameterобъекта CompositionEffectBrush . |
CompositionEllipseGeometry |
Представляет эллипс с указанным центром и радиусом. |
CompositionGeometricClip |
Представляет фигуру, которая обрезает часть визуального элемента. Видимая часть визуального элемента — это фигура, определяемая compositionGeometry. Часть визуального элемента за пределами геометрии обрезается. |
CompositionGeometry |
Представляет базовый класс для геометрических объектов композиции. |
CompositionGradientBrush |
Представляет кисть, описывающую градиент, состоящий из остановок градиента. CompositionGradientBrush поддерживается только с rgb и RgbLinear CompositionColorSpace. |
CompositionGraphicsDevice |
Используется для создания всех ресурсов, привязанных к оборудованию, для данного устройства DirectX в сеансе композитора. CompositionGraphicsDevice содержит устройство DirectX, которое используется для выполнения операций GPU. Разработчики могут получить графическое устройство из объекта верхнего уровня compositor. |
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. |
CompositionNotificationDeferral |
Представляет отсрочку, которую приложение может использовать для асинхронного реагирования на уведомление о композиции. |
CompositionObject |
Базовый класс API композиции, представляющий узел в структуре визуального дерева. Объекты композиции — это структура визуального дерева, на основе которой используются и строятся все остальные функции API композиции. API позволяет разработчикам определять и создавать один или несколько объектов Visual , каждый из которых представляет один узел в визуальном дереве. |
CompositionPath |
Представляет последовательность соединенных линий и кривых. |
CompositionPathGeometry |
Представляет последовательность соединенных линий и кривых. |
CompositionProjectedShadow |
Представляет тень на основе сцены, вычисленную на основе связи между светом, визуальным элементом, который отбрасывает тень, и визуальным элементом, получающим тень, таким образом, тень рисуется по-разному на каждом приемнике. |
CompositionProjectedShadowCaster |
Представляет объект, который отбрасывает проецируемый тень. |
CompositionProjectedShadowCasterCollection |
Представляет коллекцию объектов CompositionProjectedShadowCaster. |
CompositionProjectedShadowReceiver |
Представляет объект, на который может быть проецирована тень. |
CompositionProjectedShadowReceiverUnorderedCollection |
Представляет неупорядоченную коллекцию объектов CompositionProjectedShadowReceiver. |
CompositionPropertySet |
Хранит значения в виде пар "ключ-значение". |
CompositionRadialGradientBrush |
Представляет кисть, которая закрашивает область радиальным градиентом. |
CompositionRectangleGeometry |
Представляет форму прямоугольника указанного размера. |
CompositionRoundedRectangleGeometry |
Представляет форму прямоугольника указанного размера со скругленными углами. |
CompositionScopedBatch |
Явно созданная группа активных анимаций или эффектов. |
CompositionShadow |
Базовый класс для теней, которые можно применить к SpriteVisual. |
CompositionShape |
Представляет базовый класс фигуры. |
CompositionShapeCollection |
Представляет коллекцию объектов CompositionShape , доступ к которым можно получить по отдельности по индексу. |
CompositionSpriteShape |
Объект CompositionShape, который рисует Stroked и Filled CompositionGeometry. |
CompositionStrokeDashArray |
Представляет коллекцию значений, указывающих шаблон дефисов и пробелов, используемый для контура фигур. |
CompositionSurfaceBrush |
Закрашивает объект SpriteVisual пикселями из объекта ICompositionSurface. |
CompositionTransform |
Обеспечивает поддержку универсального преобразования для объектов композиции. |
CompositionViewBox |
Представляет контейнер, который сопоставляет координаты визуального дерева с визуальным элементом. |
CompositionVirtualDrawingSurface |
Представляет редко выделенные растровые изображения, которые могут быть связаны с визуальными элементами для композиции в визуальном дереве. |
CompositionVisualSurface |
Представляет визуальное дерево в виде ICompositionSurface, которое можно использовать для рисования визуального элемента с помощью CompositionBrush. |
Compositor |
Управляет сеансом между приложением и процессом композитора системы. Класс Compositor создает экземпляр Compositor для приложения, который можно использовать в качестве фабрики для различных типов в пространстве имен Windows.UI.Composition, охватывающем визуальный слой, систему эффектов и систему анимации. Класс Compositor также управляет временем существования объектов, созданных из фабрики. |
ContainerVisual |
Узел в визуальном дереве, который может иметь дочерние элементы. |
CubicBezierEasingFunction |
Представляет функцию кубических безье для интерполяции между ключевыми кадрами анимации. Функция cubic-bezier является одной из наиболее распространенных функций, используемых с KeyFrameAnimationи часто используется для описания гладких кривых, которые можно масштабировать. Функции кубического безье определяются двумя контрольными точками типа Vector2, которые определяют форму кривой. При использовании свойство анимации будет изменяться между двумя ключевыми кадрами в зависимости от определенной кривой. |
DistantLight |
Бесконечно большой удаленный источник света, излучающий свет в одном направлении. Например, для представления солнечного света можно использовать далекий свет. |
DropShadow |
Тени, отбрасываемые spriteVisual или LayerVisual. |
ElasticEasingFunction |
Представляет функцию плавности для создания анимации, напоминающую пружину, которая колеблется вперед-назад до полного успокоения. |
ExponentialEasingFunction |
Представляет функцию плавности, создающую анимацию, в которой ускорение и замедление задается с помощью экспоненциальной формулы. |
ExpressionAnimation |
Анимация композиции, использующая математическое уравнение для вычисления значения свойства анимации для каждого кадра. |
ImplicitAnimationCollection |
Коллекция анимаций, активируется при выполнении условия. |
InitialValueExpressionCollection |
Коллекция значений, указывающих, с чего начнется анимация. |
InsetClip |
Представляет прямоугольник, который обрезает часть визуального элемента. Часть визуального элемента внутри прямоугольника видна; Часть визуального элемента за пределами прямоугольника обрезается. |
KeyFrameAnimation |
Анимация на основе времени с одним или несколькими ключевыми кадрами. Эти кадры представляют собой маркеры, позволяющие разработчикам указывать значения в определенное время для свойства анимации. Анимацию по ключевым кадрам можно дополнительно настроить, указав способ интерполяции анимации между ключевыми кадрами. |
LayerVisual |
Объект ContainerVisual, дочерние элементы которого разделены в один слой. |
LinearEasingFunction |
Представляет линейную функцию для интерполяции между ключевыми кадрами анимации. |
NaturalMotionAnimation |
Представляет анимацию на основе физики, которая использует силы для динамического перемещения содержимого. |
PathKeyFrameAnimation |
Представляет анимацию на основе времени с одним или несколькими ключевыми кадрами, где каждое значение ключевого кадра представлено CompositionPath. Реалистичная анимация определяет взаимодействие между путями. |
PointLight |
Точечный источник света, который излучает свет во всех направлениях. |
PowerEasingFunction |
Представляет функцию реалистичной анимации, которая создает анимацию, которая ускоряется и (или) замедляется с помощью формулы f(t) = tp , где p равно свойству |
QuaternionKeyFrameAnimation |
Анимация на основе времени, ориентированная на свойство Orientation с одним или несколькими ключевыми кадрами. Класс QuaternionKeyFrameAnimation является одним из поддерживаемых типов keyFrameAnimation, который используется для анимации свойства Orientationв визуальном элементе. Кватернионы — это полезный, а иногда и более простой способ думать о поворотах. Кватернионы принимают кратчайший путь между углами и избежать таких проблем, как gimbal Lock, с которыми возникают угол/ось поворота и матрицы поворота. Кватернион состоит из двух компонентов: скалярной и векторной части. |
RectangleClip |
Представляет прямоугольник с необязательными скругленными углами, который обрезает часть визуального элемента. Часть визуального элемента внутри прямоугольника видна; Часть визуального элемента за пределами прямоугольника обрезается. |
RedirectVisual |
Представляет визуальный элемент, который получает свое содержимое из другого визуального элемента. |
RenderingDeviceReplacedEventArgs |
Аргументы для события RenderingDeviceReplaced . |
ScalarKeyFrameAnimation |
Анимация на основе времени, ориентированная на любое скалярное свойство с одним или несколькими ключевыми кадрами. |
ScalarNaturalMotionAnimation |
Базовый Scalar NaturalMotionAnimation, используемый для нацеливания на скалярное свойство. |
ShapeVisual |
Представляет узел визуального дерева, который является корнем CompositionShape. |
SineEasingFunction |
Представляет функцию для реалистичной анимации, создающую анимацию, которая ускоряется и замедляется по формуле синуса. |
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 |
Неупорядоченная коллекция визуальных элементов. |
Интерфейсы
IAnimationObject |
Представляет объект со свойствами, на которые можно ссылаться с помощью анимации. |
ICompositionAnimationBase |
Базовый класс для анимаций композиции. |
ICompositionSupportsSystemBackdrop |
Предоставляет свойство для работы с CompositionBrush в качестве системного фона. SpriteVisual с заданным CompositionBrush будет помещен в задней части поддеревь реализующего объекта. |
ICompositionSurface |
Представляет содержимое поверхности, которую можно использовать для закраски |
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 |
Состояние асинхронной компиляции шейдера для описания эффекта. |
CompositionGetValueStatus |
Указывает результат попытки получить значение пары "ключ-значение". |
CompositionGradientExtendMode |
Определяет константы, определяющие способ рисования градиента за пределами вектора градиента или пространства кисти. |
CompositionMappingMode |
Определяет константы, указывающие, являются ли координаты положения кисти градиента (StartPoint, EndPoint) абсолютными или относительно области вывода. |
CompositionProjectedShadowDrawOrder |
Предоставляет API для создания пользовательского интерфейса. |
CompositionStretch |
Указывает, как масштабируется содержимое при сопоставлении из источника в целевое пространство. |
CompositionStrokeCap |
Определяет константы, указывающие фигуру в конце линии или сегмента. |
CompositionStrokeLineJoin |
Определяет константы, указывающие фигуру, используемую для соединения двух линий или сегментов. |
Комментарии
Общие сведения, примеры и известные проблемы Windows.UI.Composition
Элемент | Описание |
---|---|
Общие сведения о Windows.UI.Composition | Обзор и архитектура API |
Примеры Windows.UI.Composition | Примеры API на официальном сайте GitHub |
Известные проблемы и последние сведения | Последние обновления API на форумах MSDN |