BitmapImage Klass

Definition

Tillhandahåller en specialiserad BitmapSource som är optimerad för att läsa in bilder med XAML (Extensible Application Markup Language).

public ref class BitmapImage sealed : System::Windows::Media::Imaging::BitmapSource, System::ComponentModel::ISupportInitialize, System::Windows::Markup::IUriContext
public sealed class BitmapImage : System.Windows.Media.Imaging.BitmapSource, System.ComponentModel.ISupportInitialize, System.Windows.Markup.IUriContext
type BitmapImage = class
    inherit BitmapSource
    interface ISupportInitialize
    interface IUriContext
Public NotInheritable Class BitmapImage
Inherits BitmapSource
Implements ISupportInitialize, IUriContext
Arv
Implementeringar

Exempel

Följande kodexempel visar hur du använder en BitmapImage i XAML (Extensible Application Markup Language) och kod.

<!-- Property Tag XAML Syntax -->
<Image Width="200"  Margin="5" Grid.Column="1" Grid.Row="1" >
   <Image.Source>
      <BitmapImage UriSource="sampleImages/bananas.jpg" />
   </Image.Source>
</Image>
<!-- Property Tag XAML Syntax -->
<Image Width="200"  Margin="5" Grid.Column="1" Grid.Row="1" >
   <Image.Source>
      <BitmapImage UriSource="sampleImages/bananas.jpg" />
   </Image.Source>
</Image>
// Create the image element.
Image simpleImage = new Image();    
simpleImage.Width = 200;
simpleImage.Margin = new Thickness(5);

// Create source.
BitmapImage bi = new BitmapImage();
// BitmapImage.UriSource must be in a BeginInit/EndInit block.
bi.BeginInit();
bi.UriSource = new Uri(@"/sampleImages/cherries_larger.jpg",UriKind.RelativeOrAbsolute);
bi.EndInit();
// Set the image source.
simpleImage.Source = bi;
' Create the image element.
Dim simpleImage As New Image()
simpleImage.Width = 200
simpleImage.Margin = New Thickness(5)

' Create source.
Dim bi As New BitmapImage()
' BitmapImage.UriSource must be in a BeginInit/EndInit block.
bi.BeginInit()
bi.UriSource = New Uri("/sampleImages/cherries_larger.jpg", UriKind.RelativeOrAbsolute)
bi.EndInit()
' Set the image source.
simpleImage.Source = bi

Kommentarer

BitmapImage finns främst för att stödja XAML-syntax (Extensible Application Markup Language) och introducerar ytterligare egenskaper för bitmappsinläsning som inte definieras av BitmapSource.

BitmapImage implementerar ISupportInitialize gränssnittet för att optimera initieringen av flera egenskaper. Egenskapsändringar kan bara ske under objektinitiering. Anropa BeginInit för att signalera att initieringen har påbörjats och EndInit för att signalera att initieringen har slutförts. Efter initieringen ignoreras egenskapsändringar.

BitmapImage objekt som skapas med konstruktorn BitmapImage initieras automatiskt och egenskapsändringar ignoreras.

Konstruktorer

Name Description
BitmapImage()

Initierar en ny instans av BitmapImage klassen.

BitmapImage(Uri, RequestCachePolicy)

Initierar en ny instans av BitmapImage klassen med en avbildning vars källa är en Uri, och cachelagras enligt den angivna RequestCachePolicy.

BitmapImage(Uri)

Initierar en ny instans av BitmapImage klassen med hjälp av den angivna Uri.

Fält

Name Description
CacheOptionProperty

Identifierar beroendeegenskapen CacheOption .

CreateOptionsProperty

Identifierar beroendeegenskapen CreateOptions .

DecodePixelHeightProperty

Identifierar beroendeegenskapen DecodePixelHeight .

DecodePixelWidthProperty

Identifierar beroendeegenskapen DecodePixelWidth .

RotationProperty

Identifierar beroendeegenskapen Rotation .

SourceRectProperty

Identifierar beroendeegenskapen SourceRect .

StreamSourceProperty

Identifierar beroendeegenskapen StreamSource .

UriCachePolicyProperty

Identifierar beroendeegenskapen UriCachePolicy .

UriSourceProperty

Identifierar beroendeegenskapen UriSource .

Egenskaper

Name Description
BaseUri

Hämtar eller anger ett värde som representerar basen Uri för den aktuella BitmapImage kontexten.

CacheOption

Hämtar eller anger den BitmapCacheOption som ska användas för den här instansen av BitmapImage.

CanFreeze

Hämtar ett värde som anger om objektet kan göras ommodifierbart.

(Ärvd från Freezable)
CreateOptions

Hämtar eller anger BitmapCreateOptions för en BitmapImage.

DecodePixelHeight

Hämtar eller anger den höjd, i bildpunkter, som bilden avkodas till.

DecodePixelWidth

Hämtar eller anger bredden i bildpunkter som bilden avkodas till.

DependencyObjectType

DependencyObjectType Hämtar som omsluter CLR-typen för den här instansen.

(Ärvd från DependencyObject)
Dispatcher

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

(Ärvd från DispatcherObject)
DpiX

Hämtar bildens vågräta punkter per tum (dpi).

(Ärvd från BitmapSource)
DpiY

Hämtar bildens lodräta punkter per tum (dpi).

(Ärvd från BitmapSource)
Format

Hämtar inbyggda PixelFormat bitmappsdata.

(Ärvd från BitmapSource)
HasAnimatedProperties

Hämtar ett värde som anger om ett eller flera AnimationClock objekt är associerade med något av det här objektets beroendeegenskaper.

(Ärvd från Animatable)
Height

Hämtar höjden på källbitmappen i enhetsoberoende enheter (1/96 tum per enhet).

(Ärvd från BitmapSource)
IsDownloading

Hämtar ett värde som anger om innehållet BitmapImage för närvarande laddas ned.

IsFrozen

Hämtar ett värde som anger om objektet för närvarande kan ändras.

(Ärvd från Freezable)
IsSealed

Hämtar ett värde som anger om den här instansen för närvarande är förseglad (skrivskyddad).

(Ärvd från DependencyObject)
Metadata

Stöds ej. BitmapImage stöder inte egenskapen Metadata och genererar en NotSupportedException.

Palette

Hämtar bitmappens färgpalett, om en anges.

(Ärvd från BitmapSource)
PixelHeight

Hämtar bitmappens höjd i bildpunkter.

(Ärvd från BitmapSource)
PixelWidth

Hämtar bitmappens bredd i bildpunkter.

(Ärvd från BitmapSource)
Rotation

Hämtar eller anger den vinkel som detta BitmapImage roteras till.

SourceRect

Hämtar eller anger den rektangel som används som källa för BitmapImage.

StreamSource

Hämtar eller anger dataströmkällan för BitmapImage.

UriCachePolicy

Hämtar eller anger ett värde som representerar cachelagringsprincipen för bilder som kommer från en HTTP-källa.

UriSource

Hämtar eller anger Uri källan för BitmapImage.

Width

Hämtar bitmappens bredd i enhetsoberoende enheter (1/96 tum per enhet).

(Ärvd från BitmapSource)

Metoder

Name Description
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)

Tillämpar en AnimationClock på den angivna DependencyProperty. Om egenskapen redan är animerad används den angivna HandoffBehavior .

(Ärvd från Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock)

Tillämpar en AnimationClock på den angivna DependencyProperty. Om egenskapen redan är animerad används överlämningsbeteendet SnapshotAndReplace .

(Ärvd från Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)

Tillämpar en animering på den angivna DependencyProperty. Animeringen startas när nästa bildruta återges. Om den angivna egenskapen redan är animerad används den angivna HandoffBehavior egenskapen.

(Ärvd från Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)

Tillämpar en animering på den angivna DependencyProperty. Animeringen startas när nästa bildruta återges. Om den angivna egenskapen redan är animerad används överlämningsbeteendet SnapshotAndReplace .

(Ärvd från Animatable)
BeginInit()

Signalerar början av BitmapImage initieringen.

CheckAccess()

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

(Ärvd från DispatcherObject)
CheckIfSiteOfOrigin()

Kontrollerar om bitmappens källinnehåll kommer från en känd ursprungsplats. Den här metoden används för att se till att pixelkopieringsåtgärder är säkra.

(Ärvd från BitmapSource)
ClearValue(DependencyProperty)

Rensar det lokala värdet för en egenskap. Egenskapen som ska rensas anges av en DependencyProperty identifierare.

(Ärvd från DependencyObject)
ClearValue(DependencyPropertyKey)

Rensar det lokala värdet för en skrivskyddad egenskap. Egenskapen som ska rensas anges av en DependencyPropertyKey.

(Ärvd från DependencyObject)
Clone()

Skapar en modifierbar klon av detta BitmapImageoch gör djupa kopior av objektets värden.

CloneCore(Freezable)

Gör den här instansen till en djup kopia av den angivna BitmapSource. När du kopierar beroendeegenskaper kopierar den här metoden resursreferenser och databindningar (men de kanske inte längre matchar) men inte animeringar eller deras aktuella värden.

(Ärvd från BitmapSource)
CloneCurrentValue()

Skapar en modifierbar klon av det här BitmapImage objektet, vilket gör djupa kopior av objektets aktuella värden. Resursreferenser, databindningar och animeringar kopieras inte, men deras aktuella värden är det.

CloneCurrentValueCore(Freezable)

Gör den här instansen till en ändringsbar djupkopia av den angivna BitmapSource med hjälp av aktuella egenskapsvärden. Resursreferenser, databindningar och animeringar kopieras inte, men deras aktuella värden är det.

(Ärvd från BitmapSource)
CoerceValue(DependencyProperty)

Tvingar fram värdet för den angivna beroendeegenskapen. Detta uppnås genom att anropa alla CoerceValueCallback funktioner som anges i egenskapsmetadata för beroendeegenskapen eftersom den finns på anropet DependencyObject.

(Ärvd från DependencyObject)
CopyPixels(Array, Int32, Int32)

Kopierar bitmappspixeldata till en matris med pixlar med angivet steg, med början vid den angivna förskjutningen.

(Ärvd från BitmapSource)
CopyPixels(Int32Rect, Array, Int32, Int32)

Kopierar bitmappspixeldata i den angivna rektangeln till en matris med pixlar som har den angivna stegen från och med den angivna förskjutningen.

(Ärvd från BitmapSource)
CopyPixels(Int32Rect, IntPtr, Int32, Int32)

Kopierar bitmappspixeldata i den angivna rektangeln.

(Ärvd från BitmapSource)
CreateInstance()

Initierar en ny instans av Freezable klassen.

(Ärvd från Freezable)
CreateInstanceCore()

När den implementeras i en härledd klass skapar du en ny instans av den Freezable härledda klassen.

(Ärvd från Freezable)
EndInit()

Signalerar slutet av BitmapImage initieringen.

Equals(Object)

Avgör om en angivet DependencyObject motsvarar den aktuella DependencyObject.

(Ärvd från DependencyObject)
Freeze()

Gör det aktuella objektet ommodifierbart och anger dess IsFrozen egenskap till true.

(Ärvd från Freezable)
FreezeCore(Boolean)

Gör en instans av BitmapSource eller en härledd klass oföränderlig.

(Ärvd från BitmapSource)
GetAnimationBaseValue(DependencyProperty)

Returnerar det icke-animerade värdet för det angivna DependencyProperty.

(Ärvd från Animatable)
GetAsFrozen()

Skapar en frusen Freezablekopia av , med hjälp av grundläggande (icke-animerade) egenskapsvärden. Eftersom kopian är låst kopieras alla frysta underobjekt som referens.

(Ärvd från Freezable)
GetAsFrozenCore(Freezable)

Gör den här instansen till en klon av det angivna BitmapSource objektet.

(Ärvd från BitmapSource)
GetCurrentValueAsFrozen()

Skapar en frusen Freezable kopia av med aktuella egenskapsvärden. Eftersom kopian är låst kopieras alla frysta underobjekt som referens.

(Ärvd från Freezable)
GetCurrentValueAsFrozenCore(Freezable)

Gör den här instansen till en frusen klon av angiven BitmapSource. Resursreferenser, databindningar och animeringar kopieras inte, men deras aktuella värden är det.

(Ärvd från BitmapSource)
GetHashCode()

Hämtar en hash-kod för den här DependencyObject.

(Ärvd från DependencyObject)
GetLocalValueEnumerator()

Skapar en specialiserad uppräknare för att avgöra vilka beroendeegenskaper som har lokalt angivna värden för den här DependencyObject.

(Ärvd från DependencyObject)
GetType()

Hämtar den aktuella instansen Type .

(Ärvd från Object)
GetValue(DependencyProperty)

Returnerar det aktuella effektiva värdet för en beroendeegenskap för den här instansen av en DependencyObject.

(Ärvd från DependencyObject)
InvalidateProperty(DependencyProperty)

Utvärderar det effektiva värdet för den angivna beroendeegenskapen igen.

(Ärvd från DependencyObject)
MemberwiseClone()

Skapar en ytlig kopia av den aktuella Object.

(Ärvd från Object)
OnChanged()

Anropas när det aktuella Freezable objektet ändras.

(Ärvd från Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)

Den här medlemmen stöder infrastrukturen för Windows Presentation Foundation (WPF) och är inte avsedd att användas direkt från koden.

(Ärvd från Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)

Ser till att lämpliga kontextpekare upprättas för en DependencyObjectType datamedlem som just har angetts.

(Ärvd från Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Åsidosätter implementeringen DependencyObject av OnPropertyChanged(DependencyPropertyChangedEventArgs) för att även anropa alla Changed hanterare som svar på en ändrad beroendeegenskap av typen Freezable.

(Ärvd från Freezable)
ReadLocalValue(DependencyProperty)

Returnerar det lokala värdet för en beroendeegenskap, om den finns.

(Ärvd från DependencyObject)
ReadPreamble()

Säkerställer att åtkomsten Freezable görs från en giltig tråd. Arvtagare Freezable till måste anropa den här metoden i början av ett API som läser datamedlemmar som inte är beroendeegenskaper.

(Ärvd från Freezable)
SetCurrentValue(DependencyProperty, Object)

Anger värdet för en beroendeegenskap utan att ändra dess värdekälla.

(Ärvd från DependencyObject)
SetValue(DependencyProperty, Object)

Anger det lokala värdet för en beroendeegenskap som anges av dess beroendeegenskapsidentifierare.

(Ärvd från DependencyObject)
SetValue(DependencyPropertyKey, Object)

Anger det lokala värdet för en skrivskyddad beroendeegenskap som anges av identifieraren DependencyPropertyKey för beroendeegenskapen.

(Ärvd från DependencyObject)
ShouldSerializeProperty(DependencyProperty)

Returnerar ett värde som anger om serialiseringsprocesser ska serialisera värdet för den angivna beroendeegenskapen.

(Ärvd från DependencyObject)
ToString()

Skapar en strängrepresentation av det här objektet baserat på den aktuella kulturen.

(Ärvd från ImageSource)
ToString(IFormatProvider)

Skapar en strängrepresentation av det här objektet baserat på det IFormatProvider skickade objektet. Om providern är nullCurrentCulture används .

(Ärvd från ImageSource)
VerifyAccess()

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

(Ärvd från DispatcherObject)
WritePostscript()

Genererar Changed händelsen för Freezable och anropar dess OnChanged() metod. Klasser som härleds från Freezable bör anropa den här metoden i slutet av alla API:er som ändrar klassmedlemmar som inte lagras som beroendeegenskaper.

(Ärvd från Freezable)
WritePreamble()

Verifierar att Freezable inte är låst och att den nås från en giltig trådkontext. Freezable ärver bör anropa den här metoden i början av ett API som skriver till datamedlemmar som inte är beroendeegenskaper.

(Ärvd från Freezable)

Händelser

Name Description
Changed

Inträffar när eller Freezable ett objekt som det innehåller ändras.

(Ärvd från Freezable)
DecodeFailed

Inträffar när avbildningen inte kan läsas in på grund av ett skadat bildhuvud.

(Ärvd från BitmapSource)
DownloadCompleted

Inträffar när bitmappsinnehållet har laddats ned helt.

(Ärvd från BitmapSource)
DownloadFailed

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

(Ärvd från BitmapSource)
DownloadProgress

Inträffar när nedladdningsstatusen för bitmappsinnehållet har ändrats.

(Ärvd från BitmapSource)

Explicita gränssnittsimplementeringar

Name Description
IFormattable.ToString(String, IFormatProvider)

Formaterar värdet för den aktuella instansen med det angivna formatet.

(Ärvd från ImageSource)

Gäller för

Se även