Bagikan melalui


BitmapImage Kelas

Definisi

Menyediakan khusus BitmapSource yang dioptimalkan untuk memuat gambar menggunakan Extensible Application Markup Language (XAML).

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
Warisan
Penerapan

Contoh

Contoh kode berikut menunjukkan cara menggunakan BitmapImage dalam Extensible Application Markup Language (XAML) dan kode.

<!-- 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

Keterangan

BitmapImage terutama ada untuk mendukung sintaks Extensible Application Markup Language (XAML) dan memperkenalkan properti tambahan untuk pemuatan bitmap yang tidak ditentukan oleh BitmapSource.

BitmapImage mengimplementasikan antarmuka untuk mengoptimalkan inisialisasi ISupportInitialize pada beberapa properti. Perubahan properti hanya dapat terjadi selama inisialisasi objek. Panggil BeginInit untuk memberi sinyal bahwa inisialisasi telah dimulai dan EndInit untuk memberi sinyal bahwa inisialisasi telah selesai. Setelah inisialisasi, perubahan properti diabaikan.

BitmapImage objek yang dibuat menggunakan BitmapImage konstruktor secara otomatis diinisialisasi dan perubahan properti diabaikan.

Konstruktor

BitmapImage()

Menginisialisasi instans baru kelas BitmapImage.

BitmapImage(Uri)

Menginisialisasi instans BitmapImage baru kelas dengan menggunakan yang disediakan Uri.

BitmapImage(Uri, RequestCachePolicy)

Menginisialisasi instans BitmapImage baru kelas dengan gambar yang sumbernya adalah Uri, dan di-cache sesuai dengan yang disediakan RequestCachePolicy.

Bidang

CacheOptionProperty

CacheOption Mengidentifikasi properti dependensi.

CreateOptionsProperty

CreateOptions Mengidentifikasi properti dependensi.

DecodePixelHeightProperty

DecodePixelHeight Mengidentifikasi properti dependensi.

DecodePixelWidthProperty

DecodePixelWidth Mengidentifikasi properti dependensi.

RotationProperty

Rotation Mengidentifikasi properti dependensi.

SourceRectProperty

SourceRect Mengidentifikasi properti dependensi.

StreamSourceProperty

StreamSource Mengidentifikasi properti dependensi.

UriCachePolicyProperty

UriCachePolicy Mengidentifikasi properti dependensi.

UriSourceProperty

UriSource Mengidentifikasi properti dependensi.

Properti

BaseUri

Mendapatkan atau menetapkan nilai yang mewakili dasar Uri konteks saat ini BitmapImage .

CacheOption

Mendapatkan atau mengatur untuk digunakan untuk instans BitmapCacheOption ini dari BitmapImage.

CanFreeze

Mendapatkan nilai yang menunjukkan apakah objek dapat dibuat tidak dapat dimodifikasi.

(Diperoleh dari Freezable)
CreateOptions

Mendapatkan atau mengatur BitmapCreateOptions untuk BitmapImage.

DecodePixelHeight

Mendapatkan atau mengatur tinggi, dalam piksel, tempat gambar didekodekan.

DecodePixelWidth

Mendapatkan atau mengatur lebar, dalam piksel, tempat gambar didekodekan.

DependencyObjectType

Mendapatkan yang membungkus jenis CLR dari instans DependencyObjectType ini.

(Diperoleh dari DependencyObject)
Dispatcher

Dispatcher Mendapatkan ini DispatcherObject dikaitkan dengan.

(Diperoleh dari DispatcherObject)
DpiX

Mendapatkan titik horizontal per inci (dpi) gambar.

(Diperoleh dari BitmapSource)
DpiY

Mendapatkan titik vertikal per inci (dpi) gambar.

(Diperoleh dari BitmapSource)
Format

Mendapatkan asli PixelFormat data bitmap.

(Diperoleh dari BitmapSource)
HasAnimatedProperties

Mendapatkan nilai yang menunjukkan apakah satu atau beberapa AnimationClock objek dikaitkan dengan salah satu properti dependensi objek ini.

(Diperoleh dari Animatable)
Height

Mendapatkan tinggi bitmap sumber di unit independen perangkat (1/96 inci per unit).

(Diperoleh dari BitmapSource)
IsDownloading

Mendapatkan nilai yang menunjukkan apakah BitmapImage saat ini sedang mengunduh konten.

IsFrozen

Mendapatkan nilai yang menunjukkan apakah objek saat ini dapat dimodifikasi.

(Diperoleh dari Freezable)
IsSealed

Mendapatkan nilai yang menunjukkan apakah instans ini saat ini disegel (baca-saja).

(Diperoleh dari DependencyObject)
Metadata

Tidak didukung. BitmapImage tidak mendukung Metadata properti dan akan melempar NotSupportedException.

Palette

Mendapatkan palet warna bitmap, jika ditentukan.

(Diperoleh dari BitmapSource)
PixelHeight

Mendapatkan tinggi bitmap dalam piksel.

(Diperoleh dari BitmapSource)
PixelWidth

Mendapatkan lebar bitmap dalam piksel.

(Diperoleh dari BitmapSource)
Rotation

Mendapatkan atau mengatur sudut tempat ini BitmapImage diputar.

SourceRect

Mendapatkan atau mengatur persegi panjang yang digunakan sebagai sumber BitmapImage.

StreamSource

Mendapatkan atau mengatur sumber aliran dari BitmapImage.

UriCachePolicy

Mendapatkan atau menetapkan nilai yang mewakili kebijakan penembolokan untuk gambar yang berasal dari sumber HTTP.

UriSource

Mendapatkan atau mengatur Uri sumber BitmapImage.

Width

Mendapatkan lebar bitmap dalam unit independen perangkat (1/96 inci per unit).

(Diperoleh dari BitmapSource)

Metode

ApplyAnimationClock(DependencyProperty, AnimationClock)

AnimationClock Menerapkan ke yang ditentukanDependencyProperty. Jika properti sudah dianimasikan, SnapshotAndReplace perilaku handoff digunakan.

(Diperoleh dari Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)

AnimationClock Menerapkan ke yang ditentukanDependencyProperty. Jika properti sudah dianimasikan, yang ditentukan HandoffBehavior akan digunakan.

(Diperoleh dari Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)

Menerapkan animasi ke yang ditentukan DependencyProperty. Animasi dimulai ketika bingkai berikutnya dirender. Jika properti yang ditentukan sudah dianimasikan, SnapshotAndReplace perilaku handoff digunakan.

(Diperoleh dari Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)

Menerapkan animasi ke yang ditentukan DependencyProperty. Animasi dimulai ketika bingkai berikutnya dirender. Jika properti yang ditentukan sudah dianimasikan, properti yang ditentukan HandoffBehavior akan digunakan.

(Diperoleh dari Animatable)
BeginInit()

Memberi sinyal awal inisialisasi BitmapImage .

CheckAccess()

Menentukan apakah utas panggilan memiliki akses ke ini DispatcherObject.

(Diperoleh dari DispatcherObject)
CheckIfSiteOfOrigin()

Memeriksa apakah konten sumber bitmap berasal dari situs asal yang diketahui. Metode ini digunakan untuk memastikan bahwa operasi penyalinan piksel aman.

(Diperoleh dari BitmapSource)
ClearValue(DependencyProperty)

Menghapus nilai lokal properti. Properti yang akan dibersihkan ditentukan oleh DependencyProperty pengidentifikasi.

(Diperoleh dari DependencyObject)
ClearValue(DependencyPropertyKey)

Menghapus nilai lokal properti baca-saja. Properti yang akan dibersihkan ditentukan oleh DependencyPropertyKey.

(Diperoleh dari DependencyObject)
Clone()

Membuat kloning yang dapat dimodifikasi dari ini BitmapImage, membuat salinan mendalam dari nilai objek ini.

CloneCore(Freezable)

Menjadikan instans ini salinan mendalam dari yang ditentukan BitmapSource. Saat menyalin properti dependensi, metode ini menyalin referensi sumber daya dan pengikatan data (tetapi mungkin tidak lagi diselesaikan) tetapi bukan animasi atau nilainya saat ini.

(Diperoleh dari BitmapSource)
CloneCurrentValue()

Membuat klon yang dapat dimodifikasi dari objek ini BitmapImage , membuat salinan mendalam dari nilai objek ini saat ini. Referensi sumber daya, pengikatan data, dan animasi tidak disalin, tetapi nilainya saat ini.

CloneCurrentValueCore(Freezable)

Menjadikan instans ini salinan mendalam yang dapat dimodifikasi dari yang ditentukan BitmapSource menggunakan nilai properti saat ini. Referensi sumber daya, pengikatan data, dan animasi tidak disalin, tetapi nilainya saat ini.

(Diperoleh dari BitmapSource)
CoerceValue(DependencyProperty)

Memaksakan nilai properti dependensi yang ditentukan. Ini dicapai dengan memanggil fungsi apa pun CoerceValueCallback yang ditentukan dalam metadata properti untuk properti dependensi seperti yang ada pada panggilan DependencyObject.

(Diperoleh dari DependencyObject)
CopyPixels(Array, Int32, Int32)

Menyalin data piksel bitmap ke dalam array piksel dengan langkah yang ditentukan, dimulai dari offset yang ditentukan.

(Diperoleh dari BitmapSource)
CopyPixels(Int32Rect, Array, Int32, Int32)

Menyalin data piksel bitmap dalam persegi panjang yang ditentukan ke dalam array piksel yang memiliki langkah yang ditentukan dimulai pada offset yang ditentukan.

(Diperoleh dari BitmapSource)
CopyPixels(Int32Rect, IntPtr, Int32, Int32)

Menyalin data piksel bitmap dalam persegi yang ditentukan.

(Diperoleh dari BitmapSource)
CreateInstance()

Menginisialisasi instans baru kelas Freezable.

(Diperoleh dari Freezable)
CreateInstanceCore()

Saat diimplementasikan di kelas turunan, membuat instans baru dari kelas turunan Freezable .

(Diperoleh dari Freezable)
EndInit()

Menandakan akhir inisialisasi BitmapImage .

Equals(Object)

Menentukan apakah yang disediakan DependencyObject setara dengan saat ini DependencyObject.

(Diperoleh dari DependencyObject)
Freeze()

Membuat objek saat ini tidak dapat dimodifikasi dan mengatur propertinya IsFrozen ke true.

(Diperoleh dari Freezable)
FreezeCore(Boolean)

Membuat instans BitmapSource atau kelas turunan tidak dapat diubah.

(Diperoleh dari BitmapSource)
GetAnimationBaseValue(DependencyProperty)

Mengembalikan nilai non-animasi dari yang ditentukan DependencyProperty.

(Diperoleh dari Animatable)
GetAsFrozen()

Membuat salinan beku dari Freezable, menggunakan nilai properti dasar (non-animasi). Karena salinan dibekukan, sub-objek beku apa pun disalin oleh referensi.

(Diperoleh dari Freezable)
GetAsFrozenCore(Freezable)

Menjadikan instans ini sebagai klon objek yang ditentukan BitmapSource .

(Diperoleh dari BitmapSource)
GetCurrentValueAsFrozen()

Membuat salinan beku dari Freezable menggunakan nilai properti saat ini. Karena salinan dibekukan, sub-objek beku apa pun disalin oleh referensi.

(Diperoleh dari Freezable)
GetCurrentValueAsFrozenCore(Freezable)

Menjadikan instans ini sebagai klon beku dari yang ditentukan BitmapSource. Referensi sumber daya, pengikatan data, dan animasi tidak disalin, tetapi nilainya saat ini.

(Diperoleh dari BitmapSource)
GetHashCode()

Mendapatkan kode hash untuk ini DependencyObject.

(Diperoleh dari DependencyObject)
GetLocalValueEnumerator()

Membuat enumerator khusus untuk menentukan properti dependensi mana yang memiliki nilai yang ditetapkan secara lokal pada ini DependencyObject.

(Diperoleh dari DependencyObject)
GetType()

Mendapatkan dari instans Type saat ini.

(Diperoleh dari Object)
GetValue(DependencyProperty)

Mengembalikan nilai efektif properti dependensi saat ini pada instans ini dari DependencyObject.

(Diperoleh dari DependencyObject)
InvalidateProperty(DependencyProperty)

Mengevaluasi kembali nilai efektif untuk properti dependensi yang ditentukan.

(Diperoleh dari DependencyObject)
MemberwiseClone()

Membuat salinan dangkal dari saat ini Object.

(Diperoleh dari Object)
OnChanged()

Dipanggil ketika objek saat ini Freezable dimodifikasi.

(Diperoleh dari Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)

Memastikan bahwa penunjuk konteks yang sesuai ditetapkan untuk DependencyObjectType anggota data yang baru saja ditetapkan.

(Diperoleh dari Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)

Anggota ini mendukung infrastruktur Windows Presentation Foundation (WPF) dan tidak dimaksudkan untuk digunakan langsung dari kode Anda.

(Diperoleh dari Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Mengambil alih DependencyObject implementasi OnPropertyChanged(DependencyPropertyChangedEventArgs) untuk juga memanggil penangan apa pun Changed sebagai respons terhadap properti dependensi yang berubah dari jenis Freezable.

(Diperoleh dari Freezable)
ReadLocalValue(DependencyProperty)

Mengembalikan nilai lokal properti dependensi, jika ada.

(Diperoleh dari DependencyObject)
ReadPreamble()

Memastikan bahwa Freezable sedang diakses dari utas yang valid. Pewaris Freezable harus memanggil metode ini di awal API apa pun yang membaca anggota data yang bukan properti dependensi.

(Diperoleh dari Freezable)
SetCurrentValue(DependencyProperty, Object)

Mengatur nilai properti dependensi tanpa mengubah sumber nilainya.

(Diperoleh dari DependencyObject)
SetValue(DependencyProperty, Object)

Mengatur nilai lokal properti dependensi, yang ditentukan oleh pengidentifikasi properti dependensinya.

(Diperoleh dari DependencyObject)
SetValue(DependencyPropertyKey, Object)

Mengatur nilai lokal properti dependensi baca-saja, yang ditentukan oleh DependencyPropertyKey pengidentifikasi properti dependensi.

(Diperoleh dari DependencyObject)
ShouldSerializeProperty(DependencyProperty)

Mengembalikan nilai yang menunjukkan apakah proses serialisasi harus menserialisasikan nilai untuk properti dependensi yang disediakan.

(Diperoleh dari DependencyObject)
ToString()

Membuat representasi string objek ini berdasarkan budaya saat ini.

(Diperoleh dari ImageSource)
ToString(IFormatProvider)

Membuat representasi string objek ini berdasarkan yang IFormatProvider diteruskan. Jika penyedia adalah null, CurrentCulture digunakan.

(Diperoleh dari ImageSource)
VerifyAccess()

Memberlakukan bahwa utas panggilan memiliki akses ke ini DispatcherObject.

(Diperoleh dari DispatcherObject)
WritePostscript()

Menaikkan Changed peristiwa untuk Freezable dan memanggil metodenya OnChanged() . Kelas yang berasal dari Freezable harus memanggil metode ini di akhir API apa pun yang memodifikasi anggota kelas yang tidak disimpan sebagai properti dependensi.

(Diperoleh dari Freezable)
WritePreamble()

Memverifikasi bahwa Freezable tidak dibekukan dan sedang diakses dari konteks utas yang valid. Freezable pewaris harus memanggil metode ini di awal API apa pun yang menulis ke anggota data yang bukan properti dependensi.

(Diperoleh dari Freezable)

Acara

Changed

Terjadi ketika Freezable atau objek yang dikandungnya dimodifikasi.

(Diperoleh dari Freezable)
DecodeFailed

Terjadi ketika gambar gagal dimuat, karena header gambar yang rusak.

(Diperoleh dari BitmapSource)
DownloadCompleted

Terjadi ketika konten bitmap telah diunduh sepenuhnya.

(Diperoleh dari BitmapSource)
DownloadFailed

Terjadi ketika konten bitmap gagal diunduh.

(Diperoleh dari BitmapSource)
DownloadProgress

Terjadi ketika kemajuan pengunduhan konten bitmap telah berubah.

(Diperoleh dari BitmapSource)

Implementasi Antarmuka Eksplisit

IFormattable.ToString(String, IFormatProvider)

Memformat nilai instans saat ini menggunakan format yang ditentukan.

(Diperoleh dari ImageSource)

Berlaku untuk

Lihat juga