Microsoft.UI.Composition Spazio dei nomi

Fornisce API per la composizione dell'interfaccia utente.

Classi

Nome Descrizione
AmbientLight

Una luce che illumina ogni oggetto visivo mirato allo stesso modo .

AnimationController

Fornisce controlli di riproduzione per un KeyFrameAnimation.

AnimationPropertyInfo

Rappresenta informazioni su una proprietà che può essere animata.

BackEasingFunction

Rappresenta una funzione di interpolazione che ritrae leggermente il movimento di un'animazione prima che inizi ad animare nel percorso indicato.

BooleanKeyFrameAnimation

Animazione basata sul tempo destinata a una proprietà booleana con uno o più fotogrammi chiave.

BounceEasingFunction

Rappresenta una funzione di interpolazione che crea un effetto di rimbalzo animato.

BounceScalarNaturalMotionAnimation

Animazione basata sulla fisica di rimbalzo destinata a qualsiasi proprietà basata su Scalare.

BounceVector2NaturalMotionAnimation

Animazione basata sulla fisica di rimbalzo destinata a qualsiasi proprietà basata su Vector2.

BounceVector3NaturalMotionAnimation

Animazione basata sulla fisica di rimbalzo destinata a qualsiasi proprietà basata su Vector3.

CircleEasingFunction

Rappresenta una funzione di interpolazione che crea un'animazione che accelera e/o decelera usando una funzione circolare.

ColorKeyFrameAnimation

Animazione basata sul tempo destinata alla proprietà Color con uno o più fotogrammi chiave colore.

La classe ColorKeyFrameAnimation è uno dei tipi supportati di KeyFrameAnimations utilizzati per animare la proprietà Color dalla proprietà Brush in uno SpriteVisual. Quando si lavora con ColorKeyFrameAnimation s, usare Windows. UI. Oggetti color per i valori dei fotogrammi chiave. Utilizzare la proprietà InterpolationColorSpace per definire lo spazio dei colori che verrà interpolato dal sistema per l'animazione.

CompositionAnimation

Rappresenta la classe di animazione di base.

CompositionAnimationGroup

Definisce un gruppo di animazioni.

CompositionAnimationGroup consente di raggruppare CompositionAnimations in un elenco che verrà avviato contemporaneamente quando StartAnimationGroup viene chiamato su CompositionObject. Tutto CompositionAnimation in CompositionAnimationGroup deve assegnare un valore alla proprietà Target nell'animazione stessa. CompositionAnimationGroup può anche essere associato a ImplicitAnimationCollection come animazione che viene eseguita come risultato di un trigger.

CompositionApiInformation

Rappresenta informazioni sulle API di composizione.

CompositionBackdropBrush

Pennello che applica un effetto (o una catena di effetti) all'area dietro un oggetto SpriteVisual.

CompositionBatchCompletedEventArgs

Argomenti per gli eventi CompositionCommitBatch.Completed o CompositionScopedBatch.Completed .

CompositionBrush

Classe di base per i pennelli utilizzati per disegnare un oggetto SpriteVisual.

CompositionCapabilities

Offre la possibilità di controllare le funzionalità hardware di sistema in modo che gli effetti di livello visivo possano essere ridimensionati di conseguenza. In questo modo è possibile assicurarsi che l'uso delle operazioni a elevato utilizzo di rendering dell'applicazione sia personalizzato in base alle funzionalità del dispositivo, offrendo prestazioni ottimali e risultati visivi piacevoli.

CompositionClip

Classe di base per gli oggetti di ritaglio, ad esempio InsetClip.

CompositionColorBrush

Disegna un oggetto SpriteVisual con un colore a tinta unita.

CompositionColorGradientStop

Descrive la posizione e il colore di un punto di transizione in una sfumatura.

CompositionColorGradientStopCollection

Rappresenta un insieme di oggetti CompositionColorGradientStop a cui è possibile accedere singolarmente in base all'indice.

CompositionCommitBatch

Gruppo di animazioni o effetti attivi.

CompositionContainerShape

Rappresenta un contenitore per CompositionShapes, utilizzato per raggruppare elementi che condividono trasformazioni 2D.

CompositionDrawingSurface

Superficie di disegno per l'interoperabilità con Direct2D o Direct3D.

CompositionEasingFunction

Classe di base per le funzioni interpolatori da usare con KeyFrameAnimations.

La classe CompositionEasingFunction è la classe base per le funzioni di interpolazione usate con KeyFrameAnimation s. Le funzioni di interpolazione vengono usate per descrivere come il sistema esegue l'interpolazione tra due fotogrammi chiave diversi. Attualmente sono disponibili tre funzioni di interpolazione supportate: Linear, Cubic Bezier e Step.

CompositionEffectBrush

Disegna un oggetto SpriteVisual con l'output di un effetto filtro. La descrizione dell'effetto filtro viene definita usando la classe CompositionEffectFactory .

CompositionEffectFactory

Crea un oggetto composizione che contiene un formato di descrizione dell'effetto Win2D nel Microsoft. Spazio dei nomi Graphics.Canvas.Effects (SDK per app di Windows (WinUI 3) / UWP (WinUI 2)).

Note

Gli effetti non supportati sono contrassegnati come [NoComposition] nello spazio dei nomi Degli effetti di Riferimento api Win2D .

CompositionEffectSourceParameter

Usato per dichiarare un nome arbitrario (un valore String) da associare a compositionBrush (origine dell'effetto). L'associazione del nome specificato e dell'origine dell'effetto si verifica quando viene chiamato il metodo SetSourceParameter di un oggetto CompositionEffectBrush .

CompositionEllipseGeometry

Rappresenta un'ellisse con il centro e il raggio specificati.

CompositionEngine

Fornisce metodi statici per la selezione e il recupero dei motori di composizione. Si tratta di una funzionalità LAF (Limited Access Feature) instabile che consente alle app di acconsentire esplicitamente all'uso del sistema operativo come motore per le API di composizione, anziché il motore in-process predefinito.

CompositionGeometricClip

Rappresenta una forma che ritaglia una parte di un oggetto visivo. La parte visibile dell'oggetto visivo è una forma definita da compositionGeometry. La parte dell'oggetto visivo all'esterno della geometria viene ritagliata.

CompositionGeometry

Rappresenta la classe base per le geometrie di composizione.

CompositionGradientBrush

Rappresenta un pennello che descrive una sfumatura, composta da interruzioni sfumature.

CompositionGradientBrush è supportato solo con Rgb e RgbLinear CompositionColorSpace.

CompositionGraphicsDevice

Usato per creare tutte le risorse associate a hardware per un determinato dispositivo DirectX in una sessione di compositore. CompositionGraphicsDevice contiene un dispositivo DirectX usato per eseguire le operazioni GPU. Gli sviluppatori possono ottenere un dispositivo Graphics dall'oggetto di primo livello compositor.

CompositionLight

Classe di base per una sorgente di luce che può essere destinata a una scena dell'interfaccia utente.

La proprietà CompositionLight.Targets determina quali oggetti visivi sono accesi.

CompositionLinearGradientBrush

Rappresenta un pennello che disegna un'area con una sfumatura lineare.

CompositionLineGeometry

Rappresenta una linea retta tra due punti.

CompositionMaskBrush

Disegna un oggetto SpriteVisual con un oggetto CompositionBrush con una maschera di opacità applicata. L'origine della maschera di opacità può essere qualsiasi CompositionBrush di tipo CompositionColorBrush, CompositionLinearGradientBrush, CompositionSurfaceBrush, CompositionEffectBrush o CompositionNineGridBrush. La maschera di opacità deve essere specificata come CompositionSurfaceBrush.

CompositionMipmapSurface

Rappresenta una superficie di disegno per le trame mipmap.

CompositionNineGridBrush

Disegna un oggetto SpriteVisual con compositionBrush dopo aver applicato Nine-Grid stretching al contenuto del pennello di origine. L'origine dell'estensione a nove griglie può essere eseguita da qualsiasi CompositionBrush di tipo CompositionColorBrush, CompositionSurfaceBrush o CompositionEffectBrush.

CompositionNotificationDeferral

Rappresenta un differire che può essere usato da un'app per rispondere in modo asincrono a una notifica di composizione.

CompositionObject

Classe di base dell'API di composizione che rappresenta un nodo nella struttura ad albero visuale.

Gli oggetti Composition sono la struttura ad albero visuale su cui vengono usate e compilate tutte le altre funzionalità dell'API di composizione. L'API consente agli sviluppatori di definire e creare uno o più oggetti Visual ognuno che rappresenta un singolo nodo in una struttura ad albero visuale.

CompositionPath

Rappresenta una serie di linee e curve connesse.

CompositionPathGeometry

Rappresenta una serie di linee e curve connesse.

CompositionProjectedShadow

Rappresenta un'ombreggiatura basata su scena calcolata utilizzando la relazione tra la luce, l'oggetto visivo che esegue il cast dell'ombreggiatura e l'oggetto visivo che riceve l'ombreggiatura, in modo che l'ombreggiatura venga disegnata in modo diverso su ogni ricevitore.

CompositionProjectedShadowCaster

Rappresenta un oggetto che esegue il cast di un'ombreggiatura proiettata.

CompositionProjectedShadowCasterCollection

Rappresenta un insieme di oggetti CompositionProjectedShadowCaster.

CompositionProjectedShadowReceiver

Rappresenta un oggetto che può avere un'ombreggiatura proiettata su di essa.

CompositionProjectedShadowReceiverUnorderedCollection

Rappresenta un insieme non ordinato di oggetti CompositionProjectedShadowReceiver.

CompositionPropertySet

Archivia i valori come coppie chiave-valore.

CompositionRadialGradientBrush

Rappresenta un pennello che disegna un'area con una sfumatura radiale.

CompositionRectangleGeometry

Rappresenta una forma rettangolo delle dimensioni specificate.

CompositionRoundedRectangleGeometry

Rappresenta una forma rettangolo delle dimensioni specificate con angoli arrotondati.

CompositionScopedBatch

Gruppo di animazioni o effetti attivi creato in modo esplicito.

CompositionShadow

Classe di base per le ombreggiature che possono essere applicate a un oggetto SpriteVisual.

CompositionShape

Rappresenta la classe della forma di base.

CompositionShapeCollection

Rappresenta un insieme di oggetti CompositionShape a cui è possibile accedere singolarmente in base all'indice.

CompositionSpriteShape

Oggetto CompositionShape che disegna i dati Stroked e Filled CompositionGeometry.A CompositionShape that disegna Stroked and Filled CompositionGeometry.

CompositionStrokeDashArray

Rappresenta una raccolta di valori che indica il motivo di trattini e spazi vuoti utilizzati per delineare le forme.

CompositionSurfaceBrush

Disegna un oggetto SpriteVisual con pixel da un oggetto ICompositionSurface.

CompositionTransform

Fornisce supporto per la trasformazione generalizzata per gli oggetti di composizione.

CompositionViewBox

Rappresenta un contenitore che esegue il mapping delle coordinate della struttura ad albero visuale nell'oggetto visivo.

CompositionVirtualDrawingSurface

Rappresenta bitmap allocate in modo sparse che possono essere associate agli oggetti visivi per la composizione in una struttura ad albero visuale.

CompositionVisualSurface

Rappresenta una struttura ad albero visuale come oggetto ICompositionSurface che può essere utilizzata per disegnare un oggetto visivo tramite compositionBrush.

Compositor

Gestisce la sessione tra un'applicazione e il processo di composizione di sistema.

La classe Compositor crea un'istanza del compositore per l'applicazione che può essere usata come factory per un'ampia gamma di tipi nel Microsoft. UI. Spazio dei nomi di composizione che si estende sul livello visivo, sul sistema di effetti e sul sistema di animazione. La classe Compositor gestisce anche la durata degli oggetti creati dalla factory.

ContainerVisual

Nodo nella struttura ad albero visuale che può avere elementi figlio.

CubicBezierEasingFunction

Rappresenta una funzione di bézier cubica per l'interpolazione tra fotogrammi chiave di animazione.

La funzione cubica-bézier è una delle funzioni di interpolazione più comuni usate con KeyFrameAnimations e vengono usate spesso per descrivere curve uniformi che possono essere ridimensionate. Le funzioni di bézier cubiche sono definite da due "punti di controllo" di tipo Vector2 che definiscono la forma della curva. Se utilizzata, la proprietà di animazione cambierà tra due fotogrammi chiave in base alla curva definita.

DistantLight

Sorgente di luce lontana infinitamente grande che emette luce in un'unica direzione. Ad esempio, una luce distante può essere usata per rappresentare la luce solare.

DropShadow

Un'ombreggiatura a discesa eseguita da spriteVisual o LayerVisual.

ElasticEasingFunction

Rappresenta una funzione di interpolazione che crea un'animazione simile a una molla che oscilla avanti e indietro fino a quando non arriva a riposo.

ExponentialEasingFunction

Rappresenta una funzione di interpolazione che crea un'animazione che accelera e/o decelerate usando una formula esponenziale.

ExpressionAnimation

Animazione di composizione che usa un'equazione matematica per calcolare il valore di una proprietà di animazione a ogni fotogramma.

ImplicitAnimationCollection

Raccolta di animazioni attivate quando viene soddisfatta una condizione.

InitialValueExpressionCollection

Raccolta di valori che specificano dove verrà avviata un'animazione.

InsetClip

Rappresenta un rettangolo che ritaglia una parte di un oggetto visivo. La parte dell'oggetto visivo all'interno del rettangolo è visibile; la parte dell'oggetto visivo all'esterno del rettangolo viene ritagliata.

KeyFrameAnimation

Animazione basata sul tempo con uno o più fotogrammi chiave. Questi fotogrammi sono marcatori, consentendo agli sviluppatori di specificare valori in momenti specifici per la proprietà di animazione. Le animazioni con fotogrammi chiave possono essere ulteriormente personalizzate specificando come l'animazione esegue l'interpolazione tra fotogrammi chiave.

LayerVisual

ContainerVisual i cui elementi figlio vengono appiattiti in un singolo livello.

LinearEasingFunction

Rappresenta una funzione lineare per l'interpolazione tra fotogrammi chiave di animazione.

NaturalMotionAnimation

Rappresenta un'animazione basata sulla fisica che usa forze per spostare dinamicamente il contenuto.

PathKeyFrameAnimation

Rappresenta un'animazione basata sul tempo con uno o più fotogrammi chiave in cui ogni valore del fotogramma chiave è rappresentato da compositionPath. L'interpolazione specifica l'interoperabilità tra i percorsi.

PointLight

Fonte di luce che emana luce in tutte le direzioni.

PowerEasingFunction

Rappresenta una funzione di interpolazione che crea un'animazione che accelera e/o decelerate usando la formula f(t) = tp dove p è uguale alla Power proprietà .

QuaternionKeyFrameAnimation

Animazione basata sul tempo destinata alla proprietà Orientation con uno o più fotogrammi chiave.

La classe QuaternionKeyFrameAnimation è uno dei tipi supportati di KeyFrameAnimations usati per animare la proprietà Orientation in un oggetto Visual. I quaternioni sono un modo utile e talvolta più semplice per pensare alle rotazioni: i quaternioni prendono il percorso più breve tra angoli ed evitano problemi come Il blocco Gimbal in cui si verificano matrici di angolo/asse di rotazione e rotazione. Un quaternione è costituito da due componenti: una parte scalare e vettoriale.

RectangleClip

Rappresenta un rettangolo con angoli arrotondati facoltativi che ritaglia una parte di un oggetto visivo. La parte dell'oggetto visivo all'interno del rettangolo è visibile; la parte dell'oggetto visivo all'esterno del rettangolo viene ritagliata.

RedirectVisual

Rappresenta un oggetto visivo che ottiene il contenuto da un altro oggetto visivo.

RenderingDeviceReplacedEventArgs

Argomenti per l'evento RenderingDeviceReplaced .

ScalarKeyFrameAnimation

Animazione basata sul tempo destinata a qualsiasi proprietà basata su Scalare con uno o più fotogrammi chiave.

ScalarNaturalMotionAnimation

La base Scalar NaturalMotionAnimation utilizzata per impostare come destinazione una proprietà Scalare.

ShapeVisual

Rappresenta un nodo della struttura ad albero visuale che rappresenta la radice di un oggetto CompositionShape.

SineEasingFunction

Rappresenta una funzione di interpolazione che crea un'animazione che accelera e/o decelerate usando una formula seno.

SpotLight

Sorgente di luce che proietta i coni interni ed esterni della luce. Ad esempio, una torcia.

SpringScalarNaturalMotionAnimation

Animazione basata sulla fisica di primavera che punta a qualsiasi proprietà basata su Scalare.

SpringVector2NaturalMotionAnimation

Animazione basata sulla fisica di primavera che punta a qualsiasi proprietà basata su Vector2.

SpringVector3NaturalMotionAnimation

Animazione basata sulla fisica di primavera che punta a qualsiasi proprietà basata su Vector3.

SpriteVisual

Ospita contenuto boxed 2D di tipo CompositionBrush. Qualsiasi parte dell'oggetto visivo non coperta da pixel dal pennello viene sottoposta a rendering come pixel trasparenti. CompositionBrush può essere compositionBackdropBrush, CompositionColorBrush, CompositionSurfaceBrush o CompositionEffectBrush.

StepEasingFunction

Funzione step per l'interpolazione tra fotogrammi chiave di animazione.

Avanza le animazioni in incrementi, ad esempio passaggi che possono essere definiti. È possibile personalizzare i comportamenti per i passaggi iniziali e finali.

Vector2KeyFrameAnimation

Animazione basata sul tempo destinata a qualsiasi proprietà basata su Vector2 con uno o più fotogrammi chiave.

Vector2NaturalMotionAnimation

Vector2 NaturalMotionAnimation di base usato per impostare come destinazione una proprietà Vector2.

Vector3KeyFrameAnimation

Animazione basata sul tempo destinata a qualsiasi proprietà basata su Vector3 con uno o più fotogrammi chiave.

Vector3NaturalMotionAnimation

Base Vector3 NaturalMotionAnimation utilizzata per impostare come destinazione una proprietà Vector3.

Vector4KeyFrameAnimation

Animazione basata sul tempo destinata a qualsiasi proprietà basata su Vector4 con uno o più fotogrammi chiave.

Visual

Oggetto visivo di base nella gerarchia visiva.

VisualCollection

Rappresenta una raccolta di istanze visive.

VisualUnorderedCollection

Raccolta non ordinata di oggetti visivi.

Interfacce

Nome Descrizione
IAnimationObject

Rappresenta un oggetto con proprietà a cui è possibile fare riferimento un'animazione.

ICompositionAnimationBase

Classe base per le animazioni di composizione.

ICompositionSupportsSystemBackdrop

Fornisce una proprietà per l'utilizzo di compositionBrush come sfondo di sistema. Un oggetto SpriteVisual con l'oggetto CompositionBrush specificato verrà posizionato nella parte posteriore del sottoalbero dell'oggetto di implementazione.

ICompositionSurface

Rappresenta il contenuto di una superficie che può essere utilizzata per disegnare i limiti di un oggetto SpriteVisual.

ICompositionSurfaceFacade

Rappresenta un segnaposto per una superficie di composizione che può essere utilizzata come una superficie di composizione reale.

IVisualElement

Contrassegna un oggetto per indicare al sistema che può essere risolto in un oggetto visivo di composizione

IVisualElement2

Fornisce un metodo che recupera l'oggetto Visual sottostante di un oggetto.

Enumerazioni

Nome Descrizione
AnimationControllerProgressBehavior

Definisce le costanti che specificano la modalità di determinazione del valore AnimationController.Progress .

AnimationDelayBehavior

Specifica il comportamento di ritardo dell'animazione.

AnimationDirection

Specifica la direzione di riproduzione di un'animazione.

AnimationIterationBehavior

Specifica se l'animazione deve eseguire un ciclo.

AnimationPropertyAccessMode

Definisce le costanti che specificano come è possibile accedere a una proprietà animata.

AnimationStopBehavior

Specifica il comportamento di un'animazione quando si arresta.

CompositionBackfaceVisibility

Specifica se la faccia posteriore di un oggetto visivo è visibile durante una trasformazione 3D.

CompositionBatchTypes

Tipi batch per CompositionCommitBatch e CompositionScopedBatch.

CompositionBitmapInterpolationMode

Specifica l'algoritmo usato per interpolare i pixel da ICompositionSurface quando non formano un mapping uno-a-uno ai pixel sullo schermo.

CompositionBorderMode

Controlla il comportamento di aliasing sui bordi dei bordi dell'oggetto visivo.

CompositionColorSpace

Specifica lo spazio dei colori per l'interpolazione dei valori di colore in ColorKeyFrameAnimation.

CompositionCompositeMode

Determina la modalità di fusione del contenuto di un oggetto visivo non opaco con il contenuto di sfondo sottostante l'oggetto visivo.

CompositionDropShadowSourcePolicy

Specifica i criteri di mascheramento per un'ombreggiatura.

CompositionEasingFunctionMode

Definisce le costanti che specificano la modalità di interpolazione dell'animazione associata a una funzione di interpolazione.

CompositionEffectFactoryLoadStatus

Stato della compilazione asincrona di uno shader per una descrizione dell'effetto.

CompositionEngineType

Definisce il tipo di motore di composizione da usare per le API composition.

CompositionGetValueStatus

Indica il risultato di un tentativo di recuperare il valore di una coppia chiave-valore.

CompositionGradientExtendMode

Definisce costanti che specificano come disegnare la sfumatura all'esterno del vettore o dello spazio sfumatura del pennello.

CompositionMappingMode

Definisce costanti che specificano se le coordinate di posizionamento del pennello sfumato (StartPoint, EndPoint) sono assolute o relative all'area di output.

CompositionProjectedShadowDrawOrder

Fornisce API per la composizione dell'interfaccia utente.

CompositionStretch

Specifica il modo in cui il contenuto viene ridimensionato quando ne viene eseguito il mapping dall'origine a uno spazio di destinazione.

CompositionStrokeCap

Definisce costanti che specificano la forma alla fine di una linea o di un segmento.

CompositionStrokeLineJoin

Definisce le costanti che specificano la forma utilizzata per unire due linee o segmenti.

Commenti

Windows. UI. Cenni preliminari sulla composizione, esempi e problemi noti

Item Descrizione
Windows. UI. Cenni preliminari sulla composizione Panoramica e architettura dell'API
Windows. Interfaccia utente. Esempi di composizione Esempi di API in Github ufficiale
Problemi noti e informazioni più recenti Aggiornamenti più recenti sull'API nei forum MSDN

Vedi anche