Microsoft.UI.Composition Spazio dei nomi
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 |
| 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 |
| 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 |