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 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 à |
| 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 |
| 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 |