BitmapDecoder Klass

Definition

Namnområde:
System.Windows.Media.Imaging
Sammansättning:
PresentationCore.dll

Representerar en container för bitmappsramar. Varje bitmappsram är en BitmapSource. Den här abstrakta klassen innehåller en grundläggande uppsättning funktioner för alla härledda avkodarobjekt.

public ref class BitmapDecoder abstract : System::Windows::Threading::DispatcherObject
public abstract class BitmapDecoder : System.Windows.Threading.DispatcherObject
type BitmapDecoder = class
    inherit DispatcherObject
Public MustInherit Class BitmapDecoder
Inherits DispatcherObject
Arv
Object
DispatcherObject
BitmapDecoder
Härledda

Exempel

I följande exempel visas hur du använder Create(Uri, BitmapCreateOptions, BitmapCacheOption) metoden för att skapa en avkodare för en viss bild. Den första BitmapFrame av bilden används som källa för en Image kontroll.

BitmapDecoder uriBitmap = BitmapDecoder.Create(
   new Uri("sampleImages/waterlilies.jpg", UriKind.Relative),
   BitmapCreateOptions.None,
   BitmapCacheOption.Default);

// Create an image element;
Image uriImage = new Image();
uriImage.Width = 200;
// Set image source.
uriImage.Source = uriBitmap.Frames[0];

Dim uriBitmap As BitmapDecoder = BitmapDecoder.Create(New Uri("sampleImages/waterlilies.jpg", UriKind.Relative), BitmapCreateOptions.None, BitmapCacheOption.Default)

' Create an image element;
Dim uriImage As New Image()
uriImage.Width = 200
' Set image source.
uriImage.Source = uriBitmap.Frames(0)

Följande kodexempel visar hur du använder den inbyggda TiffBitmapDecoder för att öppna och avkoda en TIFF-bitmapp (Tagged Image File Format). Resultatet BitmapSource används som Source element Image .


// Open a Stream and decode a TIFF image
Stream imageStreamSource = new FileStream("tulipfarm.tif", FileMode.Open, FileAccess.Read, FileShare.Read);
TiffBitmapDecoder decoder = new TiffBitmapDecoder(imageStreamSource, BitmapCreateOptions.PreservePixelFormat, BitmapCacheOption.Default);
BitmapSource bitmapSource = decoder.Frames[0];

// Draw the Image
Image myImage1 = new Image();
myImage1.Source = bitmapSource;
myImage1.Stretch = Stretch.None;
myImage1.Margin = new Thickness(20);

' Open a Stream and decode a TIFF image
Dim imageStreamSource As New FileStream("tulipfarm.tif", FileMode.Open, FileAccess.Read, FileShare.Read)
Dim decoder As New TiffBitmapDecoder(imageStreamSource, BitmapCreateOptions.PreservePixelFormat, BitmapCacheOption.Default)
Dim bitmapSource As BitmapSource = decoder.Frames(0)

' Draw the Image
Dim myImage1 As New Image()
myImage1.Source = bitmapSource
myImage1.Stretch = Stretch.None
myImage1.Margin = New Thickness(20)

Kommentarer

BitmapDecoder är inte en BitmapFrame sig själv, snarare är det en container för BitmapFrame objekt. Var och BitmapFrame en i containern kan ha olika attribut, inklusive olika storlekar, upplösningar eller paletter.

Om inte en specifik codec har valts använder Windows Presentation Foundation (WPF) automatisk körningsidentifiering för att identifiera formatet på en bild och matcha den med lämplig codec. Den här identifieringsprocessen gör att en codec som utvecklats av en oberoende programvaruleverantör (ISV) automatiskt kan identifieras av systemet. Om du vill välja en specifik codec ska härledda BitmapDecoder eller BitmapEncoder, till exempel TiffBitmapDecoder klassen, användas.

TIFF (Image File Format) och Graphics Interchange Format (GIF) är de enda implementerade bildformaten som stöder flera bildrutor.

Konstruktorer

Name Description
BitmapDecoder()

Initierar en ny instans av BitmapDecoder.

Egenskaper

Name Description
CodecInfo

Hämtar information som beskriver denna codec.
ColorContexts

Hämtar ett värde som representerar den färgprofil som är associerad med en bitmapp, om en har definierats.
Dispatcher

Hämtar det Dispatcher som DispatcherObject är associerat med.

(Ärvd från DispatcherObject)
Frames

Hämtar innehållet i en enskild ram i en bitmapp.
IsDownloading

Hämtar ett värde som anger om avkodaren för närvarande laddar ned innehåll.
Metadata

Hämtar en instans av BitmapMetadata som representerar de globala metadata som är associerade med den här bitmappen, om metadata har definierats.
Palette

Hämtar den BitmapPalette associerade med den här avkodaren.
Preview

Hämtar en BitmapSource som representerar den globala förhandsversionen av den här bitmappen, om en har definierats.
Thumbnail

Hämtar en BitmapSource som representerar miniatyrbilden av bitmappen, om en definieras.

Metoder

Name Description
CheckAccess()

Avgör om den anropande tråden har åtkomst till den här DispatcherObject.

(Ärvd från DispatcherObject)
Create(Stream, BitmapCreateOptions, BitmapCacheOption)

Skapar en BitmapDecoder från en Stream med hjälp av angivet BitmapCreateOptions och BitmapCacheOption.
Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy)

Skapar en BitmapDecoder från en Uri med hjälp av angiven BitmapCreateOptions, BitmapCacheOption och RequestCachePolicy.
Create(Uri, BitmapCreateOptions, BitmapCacheOption)

Skapar en BitmapDecoder från en Uri med hjälp av angivet BitmapCreateOptions och BitmapCacheOption.
CreateInPlaceBitmapMetadataWriter()

Skapar en instans av InPlaceBitmapMetadataWriter, som kan användas för att uppdatera metadata för en bitmapp.
Equals(Object)

Avgör om det angivna objektet är lika med det aktuella objektet.

(Ärvd från Object)
Finalize()

Frigör resurser och utför andra rensningsåtgärder innan de BitmapDecoder frigörs av skräpinsamlingen.
GetHashCode()

Fungerar som standard-hash-funktion.

(Ärvd från Object)
GetType()

Hämtar den aktuella instansen Type .

(Ärvd från Object)
MemberwiseClone()

Skapar en ytlig kopia av den aktuella Object.

(Ärvd från Object)
ToString()

Konverterar det aktuella värdet för en BitmapDecoder till en String.
VerifyAccess()

Framtvingar att den anropande tråden har åtkomst till den här DispatcherObject.

(Ärvd från DispatcherObject)

Händelser

Name Description
DownloadCompleted

Inträffar när en BitmapDecoder har laddat ned bitmappsinnehåll.
DownloadFailed

Inträffar när bitmappsinnehållet inte kunde laddas ned.
DownloadProgress

Inträffar när en BitmapDecoder har gjort framsteg med att ladda ned bitmappsinnehåll.

Gäller för

Se även