Microsoft.UI.Composition Namespace

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

Classes

Nome Description
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 easing que retrai o movimento de uma animação ligeiramente antes de começar a animar no caminho indicado.

BooleanKeyFrameAnimation

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

BounceEasingFunction

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

BounceScalarNaturalMotionAnimation

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

BounceVector2NaturalMotionAnimation

Uma animação baseada em física de salto que tem como destino 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 que tem como destino a propriedade Color com um ou mais quadros de 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 Windows. UI. Objetos de cor para os valores de keyframes. 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. Toda CompositionAnimation em CompositionAnimationGroup precisa 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 verificar os recursos de hardware do sistema para que os Efeitos de Camada Visual possam ser dimensionados adequadamente. Isso permite garantir que o uso de operações com uso intensivo de renderização do aplicativo seja personalizado 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 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, Cub Bezier 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 Microsoft. Namespace Graphics.Canvas.Effects (SDK do Aplicativo Windows (WinUI 3) / UWP (WinUI 2)).

Note

Os efeitos que não têm suporte são marcados como [NoComposition] na Referência da API Win2D para o namespace de 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 reticência com o centro e o raio especificados.

CompositionEngine

Fornece métodos estáticos para selecionar e recuperar mecanismos de composição. Esse é um LAF (Recurso de Acesso Limitado) instável que permite que os aplicativos optem por usar o sistema operacional como o mecanismo para as APIs de Composição, em vez do mecanismo padrão em processo.

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.

O 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 de compositor. 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 sã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 de mipmap.

CompositionNineGridBrush

Pinta um SpriteVisual com um CompositionBrush depois de aplicar Nine-Grid Alongamento ao conteúdo do pincel de origem. A origem do trecho de nove grades pode ser realizada por 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.

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 , cada um representando 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 criado explicitamente 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 generalizado de transformação para objetos de composição.

CompositionViewBox

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

CompositionVirtualDrawingSurface

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

CompositionVisualSurface

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

Compositor

Gerencia a sessão entre um aplicativo e o processo de 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 Microsoft. UI. Namespace de composição que abrange a camada visual, o sistema de efeitos e o sistema de animação. A classe Compositor também gerencia o tempo de vida dos objetos criados a partir da fábrica.

ContainerVisual

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

CubicBezierEasingFunction

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

A função de bezier cúbico é 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ézir cúbico 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 de soltar lançada por um SpriteVisual ou LayerVisual.

ElasticEasingFunction

Representa uma função de easing que cria uma animação que se assemelha a uma mola oscilando para frente e para trás até que se trata de descansar.

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 KeyFrame podem ser personalizadas ainda mais especificando como a animação interpola entre quadros-chave.

LayerVisual

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

LinearEasingFunction

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

NaturalMotionAnimation

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

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 flexibilização especifica a interopolaçã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 que tem como destino a propriedade Orientation com um ou mais quadros-chave.

A classe QuaternionKeyFrameAnimation é um dos tipos com suporte de KeyFrameAnimations usados para animar a propriedade Orientation em um Visual. Quatérnios são uma maneira útil e, às vezes, mais simples de pensar sobre rotações – quatérnios tomam o caminho mais curto entre ângulos e evitam problemas como Gimbal Lock em que matrizes de rotação e eixo e rotação são executadas. Um Quatérnio é 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 que tem como destino qualquer propriedade baseada em Escalar com um ou mais quadros-chave.

ScalarNaturalMotionAnimation

A base Scalar NaturalMotionAnimation usada 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 acelera e/ou desacelera 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 de mola que tem como alvo qualquer propriedade baseada em Escalar.

SpringVector2NaturalMotionAnimation

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

SpringVector3NaturalMotionAnimation

Uma animação baseada em física de mola 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 de 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 que tem como destino 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

Nome Description
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 um cenário 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 resolver para um visual de composição

IVisualElement2

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

Enumerações

Nome Description
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 está 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 aliasing nas bordas das bordas visuais.

CompositionColorSpace

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

CompositionCompositeMode

Determina como o conteúdo de um visual não opaco é misturado 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 é interpolada.

CompositionEffectFactoryLoadStatus

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

CompositionEngineType

Define o tipo de mecanismo de composição a ser usado para as APIs de Composição.

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 gradiente ou espaço 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 a composição da 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

Windows. UI. Visão geral da composição, exemplos e problemas conhecidos

Item Descrição
Windows. UI. Visão geral da composição Visão geral e arquitetura da API
Windows. Interface do usuário. Exemplos de composição 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