System.Drawing Ruang nama
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.
Menyediakan akses ke fungsionalitas grafis dasar GDI+. System.Drawing.Drawing2DNamespace layanan , System.Drawing.Imaging, dan System.Drawing.Text menyediakan fungsionalitas yang lebih canggih. Untuk batasan, lihat bagian Keterangan.
Kelas
| Nama | Deskripsi |
|---|---|
| Bitmap |
Merangkum bitmap GDI+, yang terdiri dari data piksel untuk gambar grafis dan atributnya. adalah Bitmap objek yang digunakan untuk bekerja dengan gambar yang ditentukan oleh data piksel. |
| BitmapSuffixInSameAssemblyAttribute |
Menentukan bahwa, saat menafsirkan deklarasi ToolboxBitmapAttribute, assembly harus mencari sumber daya yang ditunjukkan dalam rakitan yang sama, tetapi dengan nilai konfigurasi BitmapSuffix ditambahkan ke nama file yang dideklarasikan. |
| BitmapSuffixInSatelliteAssemblyAttribute |
Menentukan bahwa, saat menginterpretasikan deklarasi ToolboxBitmapAttribute, assembly harus mencari sumber daya yang ditunjukkan dalam rakitan satelit, tetapi dengan nilai konfigurasi BitmapSuffix ditambahkan ke nama file yang dideklarasikan. |
| Brush |
Mendefinisikan objek yang digunakan untuk mengisi interior bentuk grafis seperti persegi panjang, elipsis, pai, poligon, dan jalur. |
| Brushes |
Sikat untuk semua warna standar. Kelas ini tidak dapat diwariskan. |
| BufferedGraphics |
Menyediakan buffer grafis untuk buffering ganda. |
| BufferedGraphicsContext |
Menyediakan metode untuk membuat buffer grafis yang dapat digunakan untuk buffering ganda. |
| BufferedGraphicsManager |
Menyediakan akses ke objek konteks grafis buffer utama untuk domain aplikasi. |
| ColorConverter |
Mengonversi warna dari satu tipe data ke tipe data lainnya. Akses kelas ini melalui TypeDescriptor. |
| ColorTranslator |
Menerjemahkan warna ke dan dari struktur GDI+ Color . Kelas ini tidak dapat diwariskan. |
| Font |
Menentukan format tertentu untuk teks, termasuk wajah font, ukuran, dan atribut gaya. Kelas ini tidak dapat diwariskan. |
| FontConverter |
Font Mengonversi objek dari satu jenis data ke jenis data lainnya. |
| FontConverter.FontNameConverter |
FontConverter.FontNameConverter adalah pengonversi tipe yang digunakan untuk mengonversi nama font ke dan dari berbagai representasi lainnya. |
| FontConverter.FontUnitConverter |
Mengonversi unit font ke dan dari tipe unit lainnya. |
| FontFamily |
Mendefinisikan sekelompok jenis wajah yang memiliki desain dasar yang sama dan variasi tertentu dalam gaya. Kelas ini tidak dapat diwariskan. |
| Graphics |
Merangkum permukaan gambar GDI+. Kelas ini tidak dapat diwariskan. |
| Icon |
Mewakili ikon Windows, yang merupakan gambar bitmap kecil yang digunakan untuk mewakili objek. Ikon dapat dianggap sebagai bitmap transparan, meskipun ukurannya ditentukan oleh sistem. |
| IconConverter |
Icon Mengonversi objek dari satu tipe data ke tipe data lainnya. Akses kelas ini melalui TypeDescriptor objek . |
| IIconExtensions |
Menyediakan akses ke fungsionalitas grafis dasar GDI+. System.Drawing.Drawing2DNamespace layanan , System.Drawing.Imaging, dan System.Drawing.Text menyediakan fungsionalitas yang lebih canggih. Untuk batasan, lihat bagian Keterangan. |
| Image |
Kelas dasar abstrak yang menyediakan fungsionalitas untuk Bitmap kelas dan Metafile turunan. |
| ImageAnimator |
Menganimasikan gambar yang memiliki bingkai berbasis waktu. |
| ImageConverter |
ImageConverter adalah kelas yang dapat digunakan untuk mengonversi Image objek dari satu jenis data ke jenis data lainnya. Akses kelas ini melalui TypeDescriptor objek . |
| ImageFormatConverter |
ImageFormatConverter adalah kelas yang dapat digunakan untuk mengonversi ImageFormat objek dari satu jenis data ke jenis data lainnya. Akses kelas ini melalui TypeDescriptor objek . |
| Pen |
Menentukan objek yang digunakan untuk menggambar garis dan kurva. Kelas ini tidak dapat diwariskan. |
| Pens |
Pena untuk semua warna standar. Kelas ini tidak dapat diwariskan. |
| PointConverter |
Point Mengonversi objek dari satu tipe data ke jenis data lainnya. |
| RectangleConverter |
Mengonversi persegi panjang dari satu tipe data ke tipe data lainnya. Akses kelas ini melalui TypeDescriptor. |
| Region |
Menjelaskan interior bentuk grafis yang terdiri dari persegi panjang dan jalur. Kelas ini tidak dapat diwariskan. |
| SizeConverter |
Kelas SizeConverter digunakan untuk mengonversi dari satu jenis data ke jenis data lainnya. Akses kelas ini melalui TypeDescriptor objek . |
| SizeFConverter |
SizeF Mengonversi objek dari satu jenis ke jenis lainnya. |
| SolidBrush |
Mendefinisikan kuas warna tunggal. Kuas digunakan untuk mengisi bentuk grafis, seperti persegi panjang, elipsis, pai, poligon, dan jalur. Kelas ini tidak dapat diwariskan. |
| StringFormat |
Merangkum informasi tata letak teks (seperti perataan, orientasi, dan perhentian tab) menampilkan manipulasi (seperti penyisipan elipsis dan substitusi digit nasional) dan fitur OpenType. Kelas ini tidak dapat diwariskan. |
| SystemBrushes |
Setiap properti SystemBrushes kelas adalah SolidBrush warna elemen tampilan Windows. |
| SystemColors |
Setiap properti SystemColors kelas adalah Color struktur yang merupakan warna elemen tampilan Windows. |
| SystemFonts |
Menentukan font yang digunakan untuk menampilkan teks dalam elemen tampilan Windows. |
| SystemIcons |
Setiap properti kelas |
| SystemPens |
Setiap properti kelas SystemPens adalah Pen yang merupakan warna elemen tampilan Windows dan memiliki lebar 1 piksel. |
| TextureBrush |
Setiap properti kelas TextureBrush adalah Brush objek yang menggunakan gambar untuk mengisi interior bentuk. Kelas ini tidak dapat diwariskan. |
| ToolboxBitmapAttribute |
Memungkinkan Anda menentukan ikon untuk mewakili kontrol dalam kontainer, seperti Microsoft Visual Studio Form Designer. |
Struct
| Nama | Deskripsi |
|---|---|
| CharacterRange |
Menentukan rentang posisi karakter dalam string. |
| Color |
Mewakili warna ARGB (alfa, merah, hijau, biru). |
| Point |
Mewakili sepasang bilangan bulat x- dan koordinat y yang mendefinisikan titik dalam bidang dua dimensi. |
| PointF |
Mewakili sepasang koordinat floating-point x- dan y yang diurutkan yang mendefinisikan titik dalam bidang dua dimensi. |
| Rectangle |
Menyimpan satu set empat bilangan bulat yang mewakili lokasi dan ukuran persegi panjang. |
| RectangleF |
Menyimpan satu set empat angka floating-point yang mewakili lokasi dan ukuran persegi panjang. Untuk fungsi wilayah yang lebih canggih, gunakan Region objek. |
| Size |
Menyimpan sepasang bilangan bulat yang diurutkan, yang menentukan Height dan Width. |
| SizeF |
Menyimpan sepasang angka floating-point yang diurutkan, biasanya lebar dan tinggi persegi panjang. |
Antarmuka
| Nama | Deskripsi |
|---|---|
| IDeviceContext |
Menentukan metode untuk mendapatkan dan merilis handel yang ada ke konteks perangkat Windows. |
Enum
| Nama | Deskripsi |
|---|---|
| ContentAlignment |
Menentukan perataan konten pada permukaan gambar. |
| CopyPixelOperation |
Menentukan bagaimana warna sumber dalam operasi piksel salin dikombinasikan dengan warna tujuan untuk menghasilkan warna akhir. |
| FontStyle |
Menentukan informasi gaya yang diterapkan ke teks. |
| GraphicsUnit |
Menentukan unit pengukuran untuk data yang diberikan. |
| KnownColor |
Menentukan warna sistem yang diketahui. |
| RotateFlipType |
Menentukan berapa banyak gambar yang diputar dan sumbu yang digunakan untuk membalikkan gambar. |
| StockIconId |
Menyediakan pengidentifikasi ikon untuk digunakan dengan GetStockIcon(StockIconId, StockIconOptions). |
| StockIconOptions |
Menyediakan opsi untuk digunakan dengan GetStockIcon(StockIconId, StockIconOptions). |
| StringAlignment |
Menentukan perataan string teks relatif terhadap persegi tata letaknya. |
| StringDigitSubstitute |
Enumerasi StringDigitSubstitute menentukan cara mengganti digit dalam string sesuai dengan lokal atau bahasa pengguna. |
| StringFormatFlags |
Menentukan informasi tampilan dan tata letak untuk string teks. |
| StringTrimming |
Menentukan cara memangkas karakter dari string yang tidak sepenuhnya pas dengan bentuk tata letak. |
| StringUnit |
Menentukan unit pengukuran untuk string teks. |
Delegasikan
| Nama | Deskripsi |
|---|---|
| Graphics.DrawImageAbort |
Menyediakan metode panggilan balik untuk memutuskan kapan DrawImage metode harus membatalkan eksekusi sebelum waktunya dan berhenti menggambar gambar. |
| Graphics.EnumerateMetafileProc |
Menyediakan metode panggilan balik untuk metode .EnumerateMetafile |
| Image.GetThumbnailImageAbort |
Menyediakan metode panggilan balik untuk menentukan kapan GetThumbnailImage(Int32, Int32, Image+GetThumbnailImageAbort, IntPtr) metode harus membatalkan eksekusi sebelum waktunya. |
Keterangan
Caution
Namespace System.Drawing memiliki beberapa batasan untuk sistem operasi dan jenis aplikasi tertentu.
Pada Windows,
System.Drawingtergantung pada pustaka asli GDI+, yang dikirim sebagai bagian dari OS. Beberapa SKU Windows, seperti Windows Server Core atau Windows Nano, tidak menyertakan pustaka asli ini sebagai bagian dari OS. Jika Anda menggunakan namespace layanan ini dan pustaka tidak dapat dimuat, pengecualian akan dilemparkan pada waktu proses.Beberapa jenis di namespace
System.Drawingmengandalkan GDI+, yang tidak didukung di layanan Windows dan aplikasi ASP.NET Core dan ASP.NET. Jenis-jenis ini ada dalam paket System.Drawing.Common NuGet dan sertakan System.Drawing.Bitmap dan System.Drawing.Font. Namun, jenis primitif di namespace layanan, seperti System.Drawing.Color, , System.Drawing.SizeSystem.Drawing.Point, dan System.Drawing.Rectangle, dapat digunakan dalam aplikasi apa pun.Dalam .NET 5 dan versi sebelumnya, paket System.Drawing.Common NuGet berfungsi di Windows, Linux, dan macOS. Namun, ada beberapa perbedaan platform. Di Linux dan macOS, fungsionalitas GDI+ diimplementasikan oleh pustaka libgdiplus). Pustaka ini tidak diinstal secara default di sebagian besar distribusi Linux dan tidak mendukung semua fungsionalitas GDI+ pada Windows dan macOS. Ada juga platform di mana libgdiplus tidak tersedia sama sekali. Untuk menggunakan jenis dari paket System.Drawing.Common di Linux dan macOS, Anda harus menginstal libgdiplus secara terpisah. Untuk informasi selengkapnya, lihat Install .NET di Linux atau Install .NET di macOS.
Dalam versi .NET 6 dan yang lebih baru, paket System.Drawing.Common NuGet hanya didukung pada sistem operasi Windows. Untuk informasi selengkapnya, lihat System.Drawing.Common hanya didukung di Windows.
Jika Anda tidak dapat menggunakan System.Drawing dengan aplikasi Anda, Alternatif yang direkomendasikan termasuk ImageSharp, SkiaSharp, Windows Komponen Pencitraan, dan Microsoft. Maui.Graphics.
Kelas Graphics menyediakan metode untuk menggambar ke perangkat tampilan. Kelas seperti Rectangle dan Point merangkum primitif GDI+. Kelas Pen ini digunakan untuk menggambar garis dan kurva, sedangkan kelas yang berasal dari kelas Brush abstrak digunakan untuk mengisi interior bentuk.
