BitmapImage Klasse

Definition

public ref class BitmapImage sealed : BitmapSource

/// [Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
/// [Windows.Foundation.Metadata.Activatable(Microsoft.UI.Xaml.Media.Imaging.IBitmapImageFactory, 65536, "Microsoft.UI.Xaml.WinUIContract")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class BitmapImage final : BitmapSource

[Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
[Windows.Foundation.Metadata.Activatable(typeof(Microsoft.UI.Xaml.Media.Imaging.IBitmapImageFactory), 65536, "Microsoft.UI.Xaml.WinUIContract")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class BitmapImage : BitmapSource

Public NotInheritable Class BitmapImage
Inherits BitmapSource

<BitmapImage .../>

Vererbung

Object Platform::Object IInspectable DependencyObject ImageSource BitmapSource BitmapImage

Attribute

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Beispiele

Hier sehen Sie ein Beispiel für die Verwendung eines BitmapImage-Objekts zum Festlegen von Image.Source in C#. In diesem Beispiel wurde das Image-Objekt in XAML erstellt, verfügt aber nicht über eine Quelle oder andere Eigenschaftswerte. Stattdessen werden diese Werte zur Laufzeit bereitgestellt, wenn das Image aus XAML geladen wird.

<Image Loaded="Image_Loaded"/>

void Image_Loaded(object sender, RoutedEventArgs e)
{
    Image img = sender as Image; 
    BitmapImage bitmapImage = new BitmapImage();
    img.Width = bitmapImage.DecodePixelWidth = 80; 
    // Natural px width of image source.
    // You don't need to set Height; the system maintains aspect ratio, and calculates the other
    // dimension, as long as one dimension measurement is provided.
    bitmapImage.UriSource = new Uri(img.BaseUri,"Assets/StoreLogo.png");
    img.Source = bitmapImage;
}

Hinweise

Ein BitmapImage kann aus den folgenden Bilddateiformaten stammen:

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

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

Die BitmapImage-Klasse stellt eine Abstraktion dar, sodass eine Bildquelle asynchron festgelegt werden kann, aber dennoch im XAML-Markup als Eigenschaftswert oder im Code als Objekt verwiesen werden kann, das keine erwartbare Syntax verwendet. Wenn Sie ein BitmapImage-Objekt im Code erstellen, verfügt es zunächst über keine gültige Quelle. Anschließend sollten Sie die Quelle mit einer der folgenden Techniken festlegen:

• Verwenden Sie den BitmapImage(Uri)- Konstruktor anstelle des Standardkonstruktors. Obwohl es sich um einen Konstruktor handelt, können Sie sich dies als implizites asynchrones Verhalten vorstellen: BitmapImage ist erst einsatzbereit, wenn es ein ImageOpened-Ereignis auslöst, das auf einen erfolgreichen asynchronen Quellsatzvorgang hinweist.
• Legen Sie die UriSource-Eigenschaft fest. Wie bei der Verwendung des URI-Konstruktors ist diese Aktion implizit asynchron, und BitmapImage ist erst einsatzbereit, wenn ein ImageOpened-Ereignis ausgelöst wird .
• Verwenden Sie SetSourceAsync. Diese Methode ist explizit asynchron. Die Eigenschaften, in denen Sie ein BitmapImage verwenden können, z . B. Image.Source, sind für dieses asynchrone Verhalten konzipiert und lösen keine Ausnahmen aus, wenn sie mit einem BitmapImage festgelegt werden, das noch keine vollständige Quelle hat. Anstatt Ausnahmen zu behandeln, sollten Sie ImageOpened - oder ImageFailed-Ereignisse entweder direkt für BitmapImage oder für das Steuerelement behandeln, das die Quelle verwendet (wenn diese Ereignisse für die Steuerelementklasse verfügbar sind).

ImageFailed und ImageOpened schließen sich gegenseitig aus. Das eine oder andere Ereignis wird immer ausgelöst, wenn für ein BitmapImage-Objekt der Quellwert festgelegt oder zurückgesetzt wird.

BitmapImage und Codierung

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 Codecs dokumentiert sind, finden Sie unter Native WIC-Codecs. Weitere Informationen zu Formaten und zur Verwendung des URI (Uniform Resource Identifier) für den Zugriff auf Bildquelldateien, die aus App-Ressourcen stammen, finden Sie unter Image und ImageBrush.

Die API für Image, BitmapImage und BitmapSource enthält keine dedizierten Methoden zum Codieren und Decodieren von Medienformaten. Sämtliche Codier- und Decodiervorgänge sind integriert. Aspekte dieser Vorgänge sind auf der Oberfläche allenfalls als Bestandteil von Ereignisdaten für Load-Ereignisse sichtbar. Wenn Sie spezielle Aufgaben mit der Bildcodierung oder -decodierung ausführen möchten, die Sie möglicherweise verwenden können, wenn Ihre App Bildkonvertierungen oder -manipulationen durchführt, sollten Sie die API verwenden, die im Windows.Graphics.Imaging-Namespace verfügbar ist. Diese Imageerstellungs-API kann entweder von UWP-Apps mit C++, C#, Visual Basic oder Windows-App mit JavaScript verwendet werden. Diese APIs werden auch von der WIC-Komponente (Windows Imaging Component) von Windows 8 unterstützt.

Animierte Bilder

Ab Windows 10 Version 1607 unterstützt das XAML Image-Element animierte GIF-Bilder. Wenn Sie ein BitmapImage als Bildquelle verwenden, können Sie auf die BitmapImage-API zugreifen, um die Wiedergabe des animierten GIF-Bilds zu steuern.

• Verwenden Sie die AutoPlay-Eigenschaft , die standardmäßig auf true festgelegt ist, um anzugeben, ob eine animierte Bitmap beim Laden wiedergegeben wird.
• Verwenden Sie die IsAnimatedBitmap-Eigenschaft , um zu überprüfen, ob eine Bitmap animiert ist.
• Verwenden Sie die IsPlaying-Eigenschaft zusammen mit den Play- und Stop-Methoden, um die Wiedergabe einer animierten Bitmap zu steuern.

Wenn Ihre App in Releases von Windows 10 vor Version 1607 ausgeführt wird, müssen Sie die ApiInformation-Klasse verwenden, um zu überprüfen, ob diese Member vorhanden sind, bevor Sie sie verwenden. Weitere Informationen finden Sie unter Versionsadaptiver Code: Verwenden neuer APIs unter Beibehaltung der Kompatibilität mit früheren Versionen.

In diesem Beispiel wird gezeigt, wie ein animiertes GIF verwendet wird. Mit einer Schaltfläche kann der Benutzer die Animation starten oder beenden. In diesem Beispiel wird versionsadaptiven Code verwendet, damit er in allen Versionen von Windows 10 ausgeführt werden kann. In Versionen vor Version 1607 wird der erste Frame des GIF angezeigt, jedoch nicht animiert.

<Grid Background="{ThemeResource ApplicationPageBackgroundThemeBrush}">
    <Image Loaded="Image_Loaded">
        <Image.Source>
            <BitmapImage x:Name="imageSource"
                         UriSource="Assets/example.gif"
                         ImageOpened="imageSource_ImageOpened"/>
        </Image.Source>
    </Image>

    <AppBarButton x:Name="playButton"
              Icon="Play"
              Visibility="Collapsed"
              Click="playButton_Click"/>
</Grid>

// Set the AutoPlay property.
private void Image_Loaded(object sender, RoutedEventArgs e)
{
    if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Media.Imaging.BitmapImage", "AutoPlay") == true)
    {
        imageSource.AutoPlay = false;
    }
}

// Show the play/stop button if the image is animated.
private void imageSource_ImageOpened(object sender, RoutedEventArgs e)
{
    var bitmapImage = (BitmapImage)sender;
    // At this point you can query whether the image is animated or not.
    if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Media.Imaging.BitmapImage", "IsAnimatedBitmap") 
        && bitmapImage.IsAnimatedBitmap == true)
    {
        // Enable the play button
        playButton.Visibility = Visibility.Visible;
    }
}

// Play or stop the animated bitmap.
void playButton_Click(object sender, RoutedEventArgs e)
{
    if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Media.Imaging.BitmapImage", "IsPlaying"))
    {
        // You can call the Play and Stop methods safely because is the IsPlaying property is
        // present, these methods are also present.
        if (imageSource.IsPlaying == true)
        {
            playButton.Icon = new SymbolIcon(Symbol.Play);
            imageSource.Stop();
        }
        else
        {
            playButton.Icon = new SymbolIcon(Symbol.Stop);
            imageSource.Play();
        }
    }
}

Weitere Beispiele finden Sie im Beispiel für die Animierte GIF-Wiedergabe.

Konstruktoren

Eigenschaften

Methoden

Ereignisse

Gilt für:

Weitere Informationen

• Image
• BitmapSource
• Source
• ImageSource
• Image und ImageBrush
• Beispiel für animierte GIF-Wiedergabe (XAML)