Microsoft.UI.Composition Namespace
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 à |
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 |
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 |