BitmapSource Kelas

Referensi

Definisi

Ruang nama:: System.Windows.Media.Imaging

Rakitan:: PresentationCore.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mewakili satu set piksel konstan pada ukuran dan resolusi tertentu.

public ref class BitmapSource abstract : System::Windows::Media::ImageSource

[System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)]
public abstract class BitmapSource : System.Windows.Media.ImageSource

[<System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)>]
type BitmapSource = class
    inherit ImageSource
    interface DUCE.IResource

[<System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)>]
type BitmapSource = class
    inherit ImageSource

Public MustInherit Class BitmapSource
Inherits ImageSource

Warisan: Object

DispatcherObject

DependencyObject

Freezable

Animatable

ImageSource
BitmapSource

Turunan: System.Windows.Interop.InteropBitmap

System.Windows.Media.Imaging.BitmapFrame

System.Windows.Media.Imaging.BitmapImage

System.Windows.Media.Imaging.CachedBitmap

System.Windows.Media.Imaging.ColorConvertedBitmap

Lainnya…

Atribut: LocalizabilityAttribute

Contoh

Contoh kode berikut menunjukkan cara membuat BitmapSource dan menggunakannya sebagai sumber Image kontrol.

// Define parameters used to create the BitmapSource.
PixelFormat pf = PixelFormats.Bgr32;
int width = 200;
int height = 200;
int rawStride = (width * pf.BitsPerPixel + 7) / 8;
byte[] rawImage = new byte[rawStride * height];

// Initialize the image with data.
Random value = new Random();
value.NextBytes(rawImage);

// Create a BitmapSource.
BitmapSource bitmap = BitmapSource.Create(width, height,
    96, 96, pf, null,
    rawImage, rawStride);

// Create an image element;
Image myImage = new Image();
myImage.Width = 200;
// Set image source.
myImage.Source = bitmap;

' Define parameters used to create the BitmapSource.
Dim pf As PixelFormat = PixelFormats.Bgr32
Dim width As Integer = 200
Dim height As Integer = 200
Dim rawStride As Integer = CType((width * pf.BitsPerPixel + 7) / 8, Integer)
Dim rawImage(rawStride * height) As Byte

' Initialize the image with data.
Dim value As New Random()
value.NextBytes(rawImage)

' Create a BitmapSource.
Dim bitmap As BitmapSource = BitmapSource.Create(width, height, 96, 96, pf, Nothing, rawImage, rawStride)

' Create an image element;
Dim myImage As New Image()
myImage.Width = 200
' Set image source.
myImage.Source = bitmap

Contoh kode berikut menggunakan BitmapSource kelas turunan, BitmapImage, untuk membuat bitmap dari file gambar dan menggunakannya sebagai sumber Image kontrol.

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

BitmapSource adalah blok penyusun dasar dari alur pencitraan Windows Presentation Foundation (WPF), secara konseptual mewakili satu set piksel konstan pada ukuran dan resolusi tertentu. BitmapSource bisa menjadi bingkai tunggal dalam file gambar yang disediakan dekoder, atau bisa menjadi hasil dari transformasi yang beroperasi BitmapSource sendiri. BitmapSource tidak digunakan untuk mewakili gambar multi-bingkai atau animasi.

Windows Presentation Foundation (WPF) secara asli mendukung pemadatan dan dekompresi bitmap (BMP), Graphics Interchange Format (GIF), Joint Photographics Experts Group (JPEG), Portable Network Graphics (PNG), dan gambar Tagged Image File Format (TIFF).

Untuk skenario pendekodean bitmap, BitmapSource menggunakan penemuan codec otomatis, berdasarkan codec yang diinstal pada sistem pengguna.

Tinggi dan lebar maksimum gambar adalah 2^16 piksel pada 32 bit per saluran * 4 saluran. Ukuran maksimum a BitmapSource adalah 2^32 byte (64 gigabyte) dan ukuran gambar maksimum adalah empat gigapiksel. Ukuran gambar minimum adalah 1x1.

Konstruktor

BitmapSource()

Menginisialisasi instans baru kelas BitmapSource.

Properti

CanFreeze	Mendapatkan nilai yang menunjukkan apakah objek dapat dibuat tidak dapat dimodifikasi. (Diperoleh dari Freezable)
DependencyObjectType	Mendapatkan yang membungkus jenis CLR instans DependencyObjectType ini. (Diperoleh dari DependencyObject)
Dispatcher	Dispatcher Mendapatkan ini DispatcherObject dikaitkan dengan. (Diperoleh dari DispatcherObject)
DpiX	Mendapatkan titik horizontal per inci (dpi) gambar.
DpiY	Mendapatkan titik vertikal per inci (dpi) gambar.
Format	Mendapatkan asli PixelFormat data bitmap.
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 dalam unit independen perangkat (1/96 inci per unit).
IsDownloading	Mendapatkan nilai yang menunjukkan apakah BitmapSource konten sedang diunduh.
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	Mendapatkan metadata yang terkait dengan gambar bitmap ini.
Palette	Mendapatkan palet warna bitmap, jika ditentukan.
PixelHeight	Mendapatkan tinggi bitmap dalam piksel.
PixelWidth	Mendapatkan lebar bitmap dalam piksel.
Width	Mendapatkan lebar bitmap dalam unit independen perangkat (1/96 inci per unit).

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, properti 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)
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.
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 BitmapSource, membuat salinan mendalam dari nilai objek ini. 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.
CloneCore(Freezable)	Jadikan instans ini sebagai 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.
CloneCurrentValue()	Membuat klon objek ini BitmapSource yang dapat dimodifikasi, 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.
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.
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.
CopyPixels(Int32Rect, IntPtr, Int32, Int32)	Menyalin data piksel bitmap dalam persegi panjang yang ditentukan.
Create(Int32, Int32, Double, Double, PixelFormat, BitmapPalette, Array, Int32)	Membuat baru BitmapSource dari array piksel.
Create(Int32, Int32, Double, Double, PixelFormat, BitmapPalette, IntPtr, Int32, Int32)	Membuat baru BitmapSource dari array piksel yang disimpan dalam memori yang tidak dikelola.
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)
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.
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 yang dibekukan disalin oleh referensi. (Diperoleh dari Freezable)
GetAsFrozenCore(Freezable)	Jadikan instans ini sebagai klon objek yang ditentukan BitmapSource .
GetCurrentValueAsFrozen()	Membuat salinan beku dari Freezable menggunakan nilai properti saat ini. Karena salinan dibekukan, sub-objek yang dibekukan disalin oleh referensi. (Diperoleh dari Freezable)
GetCurrentValueAsFrozenCore(Freezable)	Menjadikan instans ini kloning beku dari yang ditentukan BitmapSource. Referensi sumber daya, pengikatan data, dan animasi tidak disalin, tetapi nilainya saat ini.
GetHashCode()	Mendapatkan kode hash untuk ini DependencyObject. (Diperoleh dari DependencyObject)
GetLocalValueEnumerator()	Membuat enumerator khusus untuk menentukan properti dependensi mana yang telah mengatur nilai secara lokal pada ini DependencyObject. (Diperoleh dari DependencyObject)
GetType()	Mendapatkan 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 ulang nilai efektif untuk properti dependensi yang ditentukan. (Diperoleh dari DependencyObject)
MemberwiseClone()	Membuat salinan dangkal dari yang 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 handler 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 membuat serialisasi 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 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.
DownloadCompleted	Terjadi ketika konten bitmap telah diunduh sepenuhnya.
DownloadFailed	Terjadi ketika konten bitmap gagal diunduh.
DownloadProgress	Terjadi ketika kemajuan pengunduhan konten bitmap telah berubah.

Implementasi Antarmuka Eksplisit

IFormattable.ToString(String, IFormatProvider)

Memformat nilai instans saat ini menggunakan format yang ditentukan.

(Diperoleh dari ImageSource)

Berlaku untuk