Partilhar via


Microsoft.UI.Composition Namespace

Fornece APIs para composição de interface do usuário.

Classes

AmbientLight

Uma luz que ilumina todos os visuais de destino igualmente .

AnimationController

Fornece controles de reprodução para um KeyFrameAnimation.

AnimationPropertyInfo

Representa informações sobre uma propriedade que pode ser animada.

BackEasingFunction

Representa uma função de facilitação que retrai o movimento de uma animação um pouco antes do início da animação no caminho indicado.

BooleanKeyFrameAnimation

Uma animação baseada em tempo que tem como destino uma propriedade booliana com um ou mais quadros-chave.

BounceEasingFunction

Representa uma função de easing que cria um efeito de balanço animado.

BounceScalarNaturalMotionAnimation

Uma animação baseada em física de salto que tem como alvo qualquer propriedade baseada em Escalar.

BounceVector2NaturalMotionAnimation

Uma animação baseada em física de salto que tem como alvo qualquer propriedade baseada em Vector2.

BounceVector3NaturalMotionAnimation

Uma animação baseada em física de salto que tem como alvo qualquer propriedade baseada em Vector3.

CircleEasingFunction

Representa uma função de easing que cria uma animação que acelera e/ou desacelera usando uma função circular.

ColorKeyFrameAnimation

Uma animação baseada em tempo direcionada à propriedade Color com um ou mais quadros-chave de cor.

A classe ColorKeyFrameAnimation é um dos tipos com suporte de KeyFrameAnimations que é usado para animar a propriedade Color fora da propriedade Brush em um SpriteVisual. Ao trabalhar com ColorKeyFrameAnimation s, utilize objetos Windows.UI.Color para os valores de quadros-chave. Utilize a propriedade InterpolationColorSpace para definir por qual espaço de cor o sistema interpolará para a animação.

CompositionAnimation

Representa a classe de animação base.

CompositionAnimationGroup

Define um grupo de animações.

CompositionAnimationGroup fornece uma maneira de agrupar CompositionAnimations em uma lista que será iniciada ao mesmo tempo em que StartAnimationGroup é chamado em CompositionObject. Todos os CompositionAnimation em CompositionAnimationGroup precisam atribuir um valor à propriedade Target na própria animação. CompositionAnimationGroup também pode ser associado a ImplicitAnimationCollection como uma animação que é executada como resultado de um gatilho.

CompositionApiInformation

Representa informações sobre as APIs de composição.

CompositionBackdropBrush

Um pincel que aplica um efeito (ou uma cadeia de efeitos) à região por trás de um SpriteVisual.

CompositionBatchCompletedEventArgs

Argumentos para os eventos CompositionCommitBatch.Completed ou CompositionScopedBatch.Completed .

CompositionBrush

Classe base para pincéis usados para pintar um SpriteVisual.

CompositionCapabilities

Fornece a capacidade de marcar recursos de hardware do sistema para que os Efeitos de Camada Visual possam ser dimensionados adequadamente. Isso permite que você garanta que o uso de operações com uso intensivo de renderização pelo aplicativo seja adaptado para corresponder aos recursos do dispositivo, fornecendo um desempenho ideal e resultados visuais agradáveis.

CompositionClip

Classe base para objetos de recorte, como InsetClip.

CompositionColorBrush

Pinta um SpriteVisual com uma cor sólida.

CompositionColorGradientStop

Descreve o local e a cor de um ponto de transição em um gradiente.

CompositionColorGradientStopCollection

Representa uma coleção de objetos CompositionColorGradientStop que podem ser acessados individualmente pelo índice.

CompositionCommitBatch

Um grupo de animações ou efeitos ativos.

CompositionContainerShape

Representa um contêiner para CompositionShapes, usado para agrupar itens que compartilham transformações 2D.

CompositionDrawingSurface

Uma superfície de desenho para interoperação com Direct2D ou Direct3D.

CompositionEasingFunction

Classe base para funções de interpolador a serem usadas com KeyFrameAnimations.

A classe CompositionEasingFunction é a classe base para facilitar funções que são usadas com KeyFrameAnimation s. As funções de easing são usadas para descrever como o sistema interpola entre dois quadros-chave diferentes. Atualmente, há três funções de easing com suporte: Linear, Bézier cúbica e Step.

CompositionEffectBrush

Pinta um SpriteVisual com a saída de um efeito de filtro. A descrição do efeito de filtro é definida usando a classe CompositionEffectFactory .

CompositionEffectFactory

Cria um objeto de composição que contém um formato de descrição de efeito Win2D no namespace Microsoft.Graphics.Canvas.Effects (WinAppSDK (WinUI 3) / UWP (WinUI 2)).

Observação

Os efeitos sem suporte são marcados como [NoComposition] no namespace Referência da API do Win2D para efeitos.

CompositionEffectSourceParameter

Usado para declarar um nome arbitrário (uma cadeia de caracteres) a ser associado a um CompositionBrush (a "fonte de efeito"). A associação do nome fornecido e da fonte de efeito ocorre quando o método SetSourceParameter de um CompositionEffectBrush é chamado.

CompositionEllipseGeometry

Representa uma elipse com o centro e o raio especificados.

CompositionGeometricClip

Representa uma forma que corta uma parte de um visual. A parte visível do visual é uma forma definida por um CompositionGeometry. A parte do visual fora da geometria é recortada.

CompositionGeometry

Representa a classe base para geometrias de composição.

CompositionGradientBrush

Representa um pincel que descreve um gradiente, composto por paradas de gradiente.

CompositionGradientBrush tem suporte apenas com Rgb e RgbLinear CompositionColorSpace.

CompositionGraphicsDevice

Usado para criar todos os recursos associados ao hardware para um determinado dispositivo DirectX em uma sessão compositora. CompositionGraphicsDevice contém um dispositivo DirectX usado para executar as operações de GPU. Os desenvolvedores podem obter um dispositivo gráfico do objeto de nível superior compositor.

CompositionLight

Classe base para uma fonte de luz que pode direcionar uma cena de interface do usuário.

A propriedade CompositionLight.Targets determina quais visuais estão acesos.

CompositionLinearGradientBrush

Representa um pincel que pinta uma área com um gradiente linear.

CompositionLineGeometry

Representa uma linha reta entre dois pontos.

CompositionMaskBrush

Pinta um SpriteVisual com um CompositionBrush com uma máscara de opacidade aplicada a ele. A origem da máscara de opacidade pode ser qualquer CompositionBrush do tipo CompositionColorBrush, CompositionLinearGradientBrush, CompositionSurfaceBrush, CompositionEffectBrush ou compositionNineGridBrush. A máscara de opacidade deve ser especificada como um CompositionSurfaceBrush.

CompositionMipmapSurface

Representa uma superfície de desenho para texturas mipmap.

CompositionNineGridBrush

Pinta um SpriteVisual com um CompositionBrush depois de aplicar Nine-Grid Stretching ao conteúdo do pincel de origem. A origem do trecho de nove grades pode ser qualquer CompositionBrush do tipo CompositionColorBrush, CompositionSurfaceBrush ou compositionEffectBrush.

CompositionNotificationDeferral

Representa um adiamento que pode ser usado por um aplicativo para responder de forma assíncrona a uma notificação de composição.

CompositionObject

Classe base da API de composição que representa um nó na estrutura da árvore visual.

Os objetos de composição são a estrutura de árvore visual na qual todos os outros recursos da API de composição usam e se baseiam. A API permite que os desenvolvedores definam e criem um ou muitos objetos Visuais que representam um único nó em uma árvore visual.

CompositionPath

Representa uma série de linhas e curvas conectadas.

CompositionPathGeometry

Representa uma série de linhas e curvas conectadas.

CompositionProjectedShadow

Representa uma sombra baseada em cena calculada usando a relação entre a luz, o visual que converte a sombra e o visual que recebe a sombra, de modo que a sombra seja desenhada de forma diferente em cada receptor.

CompositionProjectedShadowCaster

Representa um objeto que converte uma sombra projetada.

CompositionProjectedShadowCasterCollection

Representa uma coleção de objetos CompositionProjectedShadowCaster.

CompositionProjectedShadowReceiver

Representa um objeto que pode ter uma sombra projetada convertida nele.

CompositionProjectedShadowReceiverUnorderedCollection

Representa uma coleção não ordenada de objetos CompositionProjectedShadowReceiver.

CompositionPropertySet

Armazena valores como pares chave-valor.

CompositionRadialGradientBrush

Representa um pincel que pinta uma área com um gradiente radial.

CompositionRectangleGeometry

Representa uma forma de retângulo do tamanho especificado.

CompositionRoundedRectangleGeometry

Representa uma forma de retângulo do tamanho especificado com cantos arredondados.

CompositionScopedBatch

Um grupo explicitamente criado de animações ou efeitos ativos.

CompositionShadow

Classe base para sombras que podem ser aplicadas a um SpriteVisual.

CompositionShape

Representa a classe de forma base.

CompositionShapeCollection

Representa uma coleção de objetos CompositionShape que podem ser acessados individualmente pelo índice.

CompositionSpriteShape

Uma CompositionShape que desenha Stroked e Filled CompositionGeometry.

CompositionStrokeDashArray

Representa uma coleção de valores que indica o padrão de traços e lacunas usados para estruturar formas.

CompositionSurfaceBrush

Pinta um SpriteVisual com pixels de um ICompositionSurface.

CompositionTransform

Fornece suporte de transformação generalizado para objetos de composição.

CompositionViewBox

Representa um contêiner que mapeia coordenadas de árvore visual de forma para o visual.

CompositionVirtualDrawingSurface

Representa bitmaps alocados esparsamente que podem ser associados a visuais para composição em uma árvore visual.

CompositionVisualSurface

Representa uma árvore visual como um ICompositionSurface que pode ser usado para pintar um Visual usando um CompositionBrush.

Compositor

Gerencia a sessão entre um aplicativo e o processo compositor do sistema.

A classe Compositor cria uma instância do Compositor para o aplicativo que pode ser usada como uma fábrica para uma variedade de tipos no namespace Windows.UI.Composition que abrange a camada visual, o sistema de efeitos e o sistema de animação. A classe Compositor também gerencia a vida útil dos objetos criados na fábrica.

ContainerVisual

Um nó na árvore visual que pode ter filhos.

CubicBezierEasingFunction

Representa uma função de bézier cúbica para interpolar entre quadros-chave de animação.

A função de bézier cúbica é uma das funções de easing mais comuns usadas com KeyFrameAnimations e são usadas com frequência para descrever curvas suaves que podem ser dimensionadas. As funções de bézier cúbica são definidas por dois "pontos de controle" do tipo Vector2 que definem a forma da curva. Quando usada, a propriedade de animação será alterada entre dois quadros-chave com base na curva definida.

DistantLight

Uma fonte de luz distante infinitamente grande que emite luz em uma única direção. Por exemplo, uma luz distante pode ser usada para representar a luz solar.

DropShadow

Uma sombra solta convertida por um SpriteVisual ou LayerVisual.

ElasticEasingFunction

Representa uma função de facilitação que cria uma animação que se parece com uma mola oscilando para frente e para trás até parar.

ExponentialEasingFunction

Representa uma função de easing que cria uma animação que acelera e/ou desacelera usando uma fórmula exponencial.

ExpressionAnimation

Uma animação de composição que usa uma equação matemática para calcular o valor de uma propriedade de animação a cada quadro.

ImplicitAnimationCollection

Uma coleção de animações disparadas quando uma condição é atendida.

InitialValueExpressionCollection

Uma coleção de valores que especificam onde uma animação será iniciada.

InsetClip

Representa um retângulo que corta uma parte de um visual. A parte do visual dentro do retângulo é visível; a parte do visual fora do retângulo é recortada.

KeyFrameAnimation

Uma animação baseada em tempo com um ou mais quadros-chave. Esses quadros são marcadores, permitindo que os desenvolvedores especifiquem valores em momentos específicos para a propriedade de animação. As animações de quadro-chave podem ser personalizadas ainda mais especificando como a animação interpola entre quadros-chave.

LayerVisual

Um ContainerVisual cujos filhos são mesclados em uma única camada.

LinearEasingFunction

Representa uma função linear para interpolação entre quadros-chave de animação.

NaturalMotionAnimation

Representa uma animação baseada em física que usa forças para mover conteúdo dinamicamente.

PathKeyFrameAnimation

Representa uma animação baseada em tempo com um ou mais quadros-chave em que cada valor de quadro-chave é representado por um CompositionPath. A easing especifica a interpolação entre caminhos.

PointLight

Uma fonte de luz que emana a luz em todas as direções.

PowerEasingFunction

Representa uma função de easing que cria uma animação que acelera e/ou desacelera usando a fórmula f(t) = tp em que p é igual à Power propriedade .

QuaternionKeyFrameAnimation

Uma animação baseada em tempo direcionada à propriedade Orientation com um ou mais quadros-chave.

A classe QuaternionKeyFrameAnimation é um dos tipos com suporte de KeyFrameAnimations que é usado para animar a propriedade Orientation em um Visual. Quatérnions são uma maneira útil e, às vezes, mais simples de pensar sobre rotações – os quatérnions tomam o caminho mais curto entre ângulos e evitam problemas como Gimbal Lock em que o ângulo/eixo de rotação e as matrizes de rotação se encontram. Um Quatérnion é composto por dois componentes: uma parte escalar e vetor.

RectangleClip

Representa um retângulo com cantos arredondados opcionais que cortam uma parte de um visual. A parte do visual dentro do retângulo é visível; a parte do visual fora do retângulo é recortada.

RedirectVisual

Representa um visual que obtém seu conteúdo de outro visual.

RenderingDeviceReplacedEventArgs

Argumentos para o evento RenderingDeviceReplaced .

ScalarKeyFrameAnimation

Uma animação baseada em tempo direcionada a qualquer propriedade baseada em Escalar com um ou mais quadros-chave.

ScalarNaturalMotionAnimation

O NaturalMotionAnimation escalar base usado para direcionar uma propriedade escalar.

ShapeVisual

Representa um nó de árvore visual que é a raiz de um CompositionShape.

SineEasingFunction

Representa uma função de easing que cria uma animação que é acelerada e/ou desacelerada usando uma fórmula de seno.

SpotLight

Uma fonte de luz que converte cones internos e externos de luz. Por exemplo, uma lanterna.

SpringScalarNaturalMotionAnimation

Uma animação baseada em física spring que tem como alvo qualquer propriedade baseada em Escalar.

SpringVector2NaturalMotionAnimation

Uma animação baseada em física spring que tem como alvo qualquer propriedade baseada em Vector2.

SpringVector3NaturalMotionAnimation

Uma animação baseada em física spring que tem como alvo qualquer propriedade baseada em Vector3.

SpriteVisual

Hospeda o conteúdo em caixa 2D do tipo CompositionBrush. Qualquer parte do visual não coberta por pixels do pincel é renderizada como pixels transparentes. CompositionBrush pode ser um CompositionBackdropBrush, CompositionColorBrush, um CompositionSurfaceBrush ou um CompositionEffectBrush.

StepEasingFunction

Uma função de etapa para interpolar entre quadros-chave de animação.

Avança animações em incrementos como etapas que podem ser definidas. Comportamentos para etapas iniciais e finais podem ser personalizados.

Vector2KeyFrameAnimation

Uma animação baseada em tempo que tem como destino qualquer propriedade baseada em Vector2 com um ou mais quadros-chave.

Vector2NaturalMotionAnimation

O Vector2 NaturalMotionAnimation base usado para direcionar uma propriedade Vector2.

Vector3KeyFrameAnimation

Uma animação baseada em tempo que tem como destino qualquer propriedade baseada em Vector3 com um ou mais quadros-chave.

Vector3NaturalMotionAnimation

O Vector3 NaturalMotionAnimation base usado para direcionar uma propriedade Vector3.

Vector4KeyFrameAnimation

Uma animação baseada em tempo direcionada a qualquer propriedade baseada em Vector4 com um ou mais quadros-chave.

Visual

O objeto visual base na hierarquia visual.

VisualCollection

Representa uma coleção de instâncias visuais.

VisualUnorderedCollection

Uma coleção não ordenada de visuais.

Interfaces

IAnimationObject

Representa um objeto que tem propriedades que podem ser referenciadas por uma animação.

ICompositionAnimationBase

Classe base para animações de composição.

ICompositionSupportsSystemBackdrop

Fornece uma propriedade para trabalhar com um CompositionBrush como pano de fundo do sistema. Um SpriteVisual com o CompositionBrush fornecido será colocado na parte de trás da subárvore do objeto de implementação.

ICompositionSurface

Representa o conteúdo de uma superfície que pode ser usada para pintar os limites de um SpriteVisual.

ICompositionSurfaceFacade

Representa um espaço reservado para uma superfície de composição que pode ser usada como uma superfície de composição real.

IVisualElement

Marca um objeto para indicar ao sistema que ele pode resolve a um visual de composição

IVisualElement2

Fornece um método que recupera o visual subjacente de um objeto.

Enumerações

AnimationControllerProgressBehavior

Define constantes que especificam como o valor AnimationController.Progress é determinado.

AnimationDelayBehavior

Especifica o comportamento de atraso de animação.

AnimationDirection

Especifica a direção de reprodução de uma animação.

AnimationIterationBehavior

Especifica se a animação deve ser loop.

AnimationPropertyAccessMode

Define constantes que especificam como uma propriedade animada pode ser acessada.

AnimationStopBehavior

Especifica o comportamento de uma animação quando ela é interrompida.

CompositionBackfaceVisibility

Especifica se a face traseira de um visual fica visível durante uma transformação 3D.

CompositionBatchTypes

Tipos de lote para CompositionCommitBatch e CompositionScopedBatch.

CompositionBitmapInterpolationMode

Especifica o algoritmo usado para interpolar pixels de ICompositionSurface quando eles não formam um mapeamento um-para-um para pixels na tela.

CompositionBorderMode

Controla o comportamento de alias nas bordas das bordas visuais.

CompositionColorSpace

Especifica o espaço de cor para interpolar valores de cor em ColorKeyFrameAnimation.

CompositionCompositeMode

Determina como o conteúdo de um visual não opaco é combinado com o conteúdo em segundo plano por trás do visual.

CompositionDropShadowSourcePolicy

Especifica a política de mascaramento para uma sombra.

CompositionEasingFunctionMode

Define constantes que especificam como a animação associada a uma função de easing interpola.

CompositionEffectFactoryLoadStatus

O status da compilação assíncrona de um sombreador para uma descrição de efeito.

CompositionGetValueStatus

Indica o resultado de uma tentativa de recuperar o valor de um par chave-valor.

CompositionGradientExtendMode

Define constantes que especificam como desenhar o gradiente fora do vetor ou espaço de gradiente do pincel.

CompositionMappingMode

Define constantes que especificam se as coordenadas de posicionamento do pincel de gradiente (StartPoint, EndPoint) são absolutas ou relativas à área de saída.

CompositionProjectedShadowDrawOrder

Fornece APIs para composição de interface do usuário.

CompositionStretch

Especifica como o conteúdo é dimensionado quando mapeado de sua origem para um espaço de destino.

CompositionStrokeCap

Define constantes que especificam a forma no final de uma linha ou segmento.

CompositionStrokeLineJoin

Define constantes que especificam a forma usada para unir duas linhas ou segmentos.

Comentários

Visões gerais, exemplos e problemas conhecidos do Windows.UI.Composition

Item Descrição
Visão geral de Windows.UI.Composition Visão geral e arquitetura da API
Exemplos de Windows.UI.Composition Exemplos de API no Github oficial
Problemas conhecidos e informações mais recentes Atualizações mais recentes na API nos Fóruns do MSDN

Confira também