CompositionVirtualDrawingSurface Klasse

Definition

Namespace:

Windows.UI.Composition

Stellt nur spär zugeordnete Bitmaps dar, die Visuals für die Komposition in einer visuellen Struktur zugeordnet werden können.

public ref class CompositionVirtualDrawingSurface : CompositionDrawingSurface

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 262144)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class CompositionVirtualDrawingSurface : CompositionDrawingSurface

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 262144)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class CompositionVirtualDrawingSurface : CompositionDrawingSurface

Public Class CompositionVirtualDrawingSurface
Inherits CompositionDrawingSurface

Vererbung

Object Platform::Object IInspectable CompositionObject CompositionDrawingSurface CompositionVirtualDrawingSurface

Attribute

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 Creators Update (eingeführt in 10.0.15063.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v4.0)

Hinweise

CompositionVirtualDrawingSurface ähnelt CompositionDrawingSurface, mit der Ausnahme, dass die Oberfläche nur spärlich zugeordnet ist. Der Inhalt kann mit Win2D (oder D2D) gerendert werden.

Die virtuelle Zeichnungsoberfläche ist für die Verwendung in Szenarien konzipiert, in denen eine Anwendung eine große Menge an Inhalt definieren muss, aber nur erwartet, dass ein kleiner Teil des Inhalts zu einem bestimmten Zeitpunkt für einen Benutzer sichtbar ist. Stellen Sie sich beispielsweise ein dokument- oder webseitenlanges Scrollen vor. In solchen Fällen muss die App nur den Teil der Oberfläche zeichnen, der derzeit für den Benutzer sichtbar ist, und kann Zeichnungsteile zurückstellen, die nicht sichtbar sind, bis sie später sichtbar werden.

Die maximale Größe einer virtuellen Oberfläche beträgt 2^24(16M) Pixel. Diese Grenze wurde aufgrund von Gleitkommagenauigkeitsgrenzwerten eingeführt, die über diese Größe hinaus ins Spiel kommen, wodurch eine garantierte genaue Pixelausrichtung von gezeichneten Patches verhindert wird.

Eigenschaften

AlphaMode	Der Alphamodus der Zeichnungsoberfläche. (Geerbt von CompositionDrawingSurface)
Comment	Eine Zeichenfolge, die dem CompositionObject zugeordnet werden soll. (Geerbt von CompositionObject)
Compositor	Der Compositor , der zum Erstellen dieses CompositionObject verwendet wird. (Geerbt von CompositionObject)
Dispatcher	Der Verteiler für das CompositionObject. (Geerbt von CompositionObject)
DispatcherQueue	Ruft die DispatcherQueue für das CompostionObject ab. (Geerbt von CompositionObject)
ImplicitAnimations	Die Auflistung impliziter Animationen, die an dieses Objekt angefügt sind. (Geerbt von CompositionObject)
PixelFormat	Das Pixelformat der Zeichnungsoberfläche. (Geerbt von CompositionDrawingSurface)
Properties	Die Auflistung der Eigenschaften, die dem CompositionObject zugeordnet sind. (Geerbt von CompositionObject)
Size	Die Größe der Zeichnungsoberfläche. (Geerbt von CompositionDrawingSurface)
SizeInt32	Die Größe der Zeichnungsoberfläche. (Geerbt von CompositionDrawingSurface)

Methoden

Close()	Schließt das CompositionObject und gibt Systemressourcen frei. (Geerbt von CompositionObject)
ConnectAnimation(String, CompositionAnimation)	Verbindet und Animation. (Geerbt von CompositionObject)
DisconnectAnimation(String)	Trennt eine Animation. (Geerbt von CompositionObject)
Dispose()	Führt anwendungsspezifische Aufgaben durch, die mit der Freigabe, der Zurückgabe oder dem Zurücksetzen von nicht verwalteten Ressourcen zusammenhängen. (Geerbt von CompositionObject)
PopulatePropertyInfo(String, AnimationPropertyInfo)	Definiert eine Eigenschaft, die animiert werden kann. (Geerbt von CompositionObject)
Resize(SizeInt32)	Ändert die Größe der Zeichnungsoberfläche auf die angegebene Größe. (Geerbt von CompositionDrawingSurface)
Scroll(PointInt32)	Scrollt auf der Zeichnungsoberfläche. (Geerbt von CompositionDrawingSurface)
Scroll(PointInt32, RectInt32)	Scrollt auf der Zeichnungsoberfläche. (Geerbt von CompositionDrawingSurface)
ScrollWithClip(PointInt32, RectInt32)	Scrollt mithilfe des angegebenen Cliprechtecks auf der Zeichnungsoberfläche. (Geerbt von CompositionDrawingSurface)
ScrollWithClip(PointInt32, RectInt32, RectInt32)	Scrollt die Zeichnungsoberfläche mit dem angegebenen Cliprechteck. (Geerbt von CompositionDrawingSurface)
StartAnimation(String, CompositionAnimation)	Verbindet eine Animation mit der angegebenen Eigenschaft des Objekts und startet die Animation. (Geerbt von CompositionObject)
StartAnimation(String, CompositionAnimation, AnimationController)	Verbindet eine Animation mit der angegebenen Eigenschaft des Objekts und startet die Animation. (Geerbt von CompositionObject)
StartAnimationGroup(ICompositionAnimationBase)	Startet eine Animationsgruppe. Mit der StartAnimationGroup-Methode für CompositionObject können Sie CompositionAnimationGroup starten. Alle Animationen in der Gruppe werden gleichzeitig für das Objekt gestartet. (Geerbt von CompositionObject)
StopAnimation(String)	Trennt eine Animation von der angegebenen Eigenschaft und beendet die Animation. (Geerbt von CompositionObject)
StopAnimationGroup(ICompositionAnimationBase)	Beendet eine Animationsgruppe. (Geerbt von CompositionObject)
Trim(RectInt32[])	Löscht Teile einer virtuellen Zeichnungsoberfläche, die zuvor definiert wurden. Bereiche, die gelöscht werden, werden wieder als leer behandelt, und der zuvor gesicherte Videospeicher wird wieder freigegeben.
TryGetAnimationController(String)	Gibt einen AnimationController für die Animation zurück, die für die angegebene Eigenschaft ausgeführt wird. (Geerbt von CompositionObject)