LoadedImageSurface Klasse

Definition

Namespace:

Windows.UI.Xaml.Media

Stellt eine Kompositionsoberfläche dar, auf die ein Bild heruntergeladen, decodiert und geladen werden kann. Sie können ein Bild mit einem URI (Uniform Resource Identifier) laden, der auf eine Bildquelldatei verweist, oder einen IRandomAccessStream bereitstellen.

public ref class LoadedImageSurface sealed : IClosable, ICompositionSurface

/// [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 LoadedImageSurface final : IClosable, ICompositionSurface

[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 sealed class LoadedImageSurface : System.IDisposable, ICompositionSurface

Public NotInheritable Class LoadedImageSurface
Implements ICompositionSurface, IDisposable

Vererbung

Object Platform::Object IInspectable LoadedImageSurface

Attribute

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementiert

IClosable IDisposable ICompositionSurface

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)

Beispiele

In diesem Beispiel wird gezeigt, wie Ein Bild aus einem lokalen URI auf eine Oberfläche geladen und in einem CompositionSurfaceBrush verwendet wird.

Compositor compositor = new Compositor();
CompositionSurfaceBrush imageBrush = compositor.CreateSurfaceBrush();

LoadedImageSurface loadedSurface = LoadedImageSurface.StartLoadFromUri(new Uri("ms-appx:///Assets/myPic.jpg"), new Size(200.0, 400.0));

// The loadedSurface currently has a size of 0x0 since it has not been downloaded, decoded and loaded to the surface yet
imageBrush.Surface = loadedSurface;

Hinweise

Ein LoadedImageSurface kann aus den folgenden Bilddateiformaten stammen:

• JPEG (Joint Photographic Experts Group)
• PNG (Portable Network Graphics)
• Bitmap (BMP)
• GIF (Graphics Interchange Format)
• TIFF (Tagged Image File Format)
• JPEG XR
• Symbole (ICO)

[! HINWEIS] LoadedImageSurface unterstützt keine animierten GIF-Bilder, sodass nur der erste Frame eines animierten GIF angezeigt wird.

Wenn es sich bei der Bildquelle um einen Stream handelt, wird erwartet, dass dieser Stream eine Bilddatei in einem dieser Formate enthält.

LoadedImageSurface-Codierung und -Decodierung

Die zugrunde liegende Codecunterstützung für Bilddateien wird von der WIC-API (Windows Imaging Component) in Windows bereitgestellt. Weitere Informationen zu bestimmten Bildformaten, die für die Codes dokumentiert sind, finden Sie unter Native WIC-Codecs.

Mithilfe einer der Factorymethoden können Sie eine instance von LoadedImageSurface aus verschiedenen Arten von Bildquellen erstellen und die maximale Größe steuern, bei der das Bild decodiert wird. Wenn keine maximale Größe angegeben wird, wird das Bild auf seine natürliche Größe decodiert.

• StartLoadFromUri(Uri)
• StartLoadFromUri(Uri, Size)
• StartLoadFromStream(IRandomAccessStream)
• StartLoadFromStream(IRandomAccessStream, Size)

Verwaltung der Lebensdauer

Wenn ein LoadedImageSurface mit einer der Factorymethoden erstellt wird, wird die zugrunde liegende Oberfläche sofort auf eine Größe von 0x0 initialisiert, und der Bildinhalt beginnt mit dem Herunterladen und Decodieren des UI-Threads. Wenn die Bildquelle erfolgreich decodiert wurde, wird sie auf die Oberfläche geladen, und das LoadCompleted-Ereignis wird ausgelöst, wenn die Oberfläche aufgefüllt wurde. Während des Ladevorgangs wird die Größe der Oberfläche von 0x0 auf ihre endgültige Größe basierend auf der decodierten Größe der Bildquelle geändert.

LoadedImageSurface behält automatisch alle Ressourcen bei, bis der endgültige Verweis verloren geht. Sie können die Ressourcen jedoch explizit über die Close-Methode verwerfen.

[! HINWEIS] LoadedImageSurface ist vor Windows 10 Version 1703 nicht verfügbar. Wenn die Einstellung "Mindestversion der Plattform" Ihrer App in Microsoft Visual Studio kleiner als die im Abschnitt Anforderungen weiter unten auf dieser Seite angezeigte "eingeführte Version" ist, können Sie diese Klasse nicht verwenden.

Eigenschaften

DecodedPhysicalSize	Ruft die Größe des decodierten Bilds in physischen Pixeln ab.
DecodedSize	Ruft die Größe des decodierten Bilds in geräteunabhängigen Pixeln ab.
NaturalSize	Ruft die natürliche Größe des Bilds in physischen Pixeln ab, die in der ursprünglichen Bildquelle definiert ist.

Methoden

Close()	Entsorgt die LoadedImageSurface und die zugeordneten Ressourcen.
Dispose()	Führt anwendungsspezifische Aufgaben durch, die mit der Freigabe, der Zurückgabe oder dem Zurücksetzen von nicht verwalteten Ressourcen zusammenhängen.
StartLoadFromStream(IRandomAccessStream)	Lädt ein Bild aus dem bereitgestellten IRandomAccessStream in der in der Bildquelle definierten natürlichen Größe auf eine LoadedImageSurface.
StartLoadFromStream(IRandomAccessStream, Size)	Lädt ein Bild aus dem bereitgestellten IRandomAccessStream mit der gewünschten maximalen Größe in eine LoadedImageSurface.
StartLoadFromUri(Uri)	Lädt ein Bild aus dem bereitgestellten URI (Uniform Resource Identifier) mit der in der Bildquelle definierten natürlichen Größe in eine LoadedImageSurface .
StartLoadFromUri(Uri, Size)	Lädt ein Bild aus dem bereitgestellten URI (Uniform Resource Identifier) mit der gewünschten maximalen Größe in eine LoadedImageSurface .

Ereignisse

LoadCompleted

Tritt auf, wenn das Image heruntergeladen, decodiert und in die zugrunde liegende ICompositionSurface geladen wurde.

Weitere Informationen

• ICompositionSurface