System.Drawing Ruang nama

Referensi

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+. Namespace System.Drawing.Drawing2D, System.Drawing.Imaging, dan System.Drawing.Text menyediakan fungsionalitas yang lebih canggih. Untuk batasan, lihat bagian Keterangan.

Kelas

Bitmap	Merangkum bitmap GDI+, yang terdiri dari data piksel untuk gambar grafis dan atributnya. Bitmap adalah objek yang digunakan untuk bekerja dengan gambar yang ditentukan oleh data piksel.
BitmapSuffixInSameAssemblyAttribute	Menentukan bahwa, saat menginterpretasikan ToolboxBitmapAttribute deklarasi, assembly harus mencari sumber daya yang ditunjukkan dalam rakitan yang sama, tetapi dengan BitmapSuffix nilai konfigurasi ditambahkan ke nama file yang dideklarasikan.
BitmapSuffixInSatelliteAssemblyAttribute	Menentukan bahwa, saat menginterpretasikan ToolboxBitmapAttribute deklarasi, perakitan harus mencari sumber daya yang ditunjukkan dalam rakitan satelit, tetapi dengan BitmapSuffix nilai konfigurasi 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	Kuas 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 utama yang di-buffer 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 atribut wajah, ukuran, dan gaya font. Kelas ini tidak dapat diwariskan.
FontConverter	Font Mengonversi objek dari satu tipe data ke tipe data lainnya.
FontConverter.FontNameConverter	FontConverter.FontNameConverter adalah pengonversi jenis 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 serupa dan variasi gaya tertentu. 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 .
Image	Kelas dasar abstrak yang menyediakan fungsionalitas untuk Bitmap kelas dan Metafile turun.
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 tipe 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 tipe ke tipe lainnya.
SolidBrush	Mendefinisikan kuas dengan satu warna. 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 kelas SystemBrushes adalah SolidBrush warna elemen tampilan Windows.
SystemColors	Setiap properti kelas SystemColors adalah Color struktur yang merupakan warna elemen tampilan Windows.
SystemFonts	Menentukan font yang digunakan untuk menampilkan teks dalam elemen tampilan Windows.
SystemIcons	Setiap properti SystemIcons kelas adalah Icon objek untuk ikon seluruh sistem Windows. Kelas ini tidak dapat diwariskan.
SystemPens	Setiap properti kelas SystemPens adalah Pen warna elemen tampilan Windows dan yang memiliki lebar 1 piksel.
TextureBrush	Setiap properti TextureBrush kelas 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

CharacterRange	Menentukan rentang posisi karakter dalam string.
Color	Mewakili warna ARGB (alfa, merah, hijau, biru).
Point	Mewakili sepasang koordinat bilangan bulat x- dan 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

IDeviceContext

Menentukan metode untuk mendapatkan dan melepaskan handel yang ada ke konteks perangkat Windows.

Enum

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 pada 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 membalik 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 satuan pengukuran untuk string teks.

Delegasikan

Graphics.DrawImageAbort	Menyediakan metode panggilan balik untuk memutuskan kapan DrawImage metode harus membatalkan eksekusi secara prematur dan berhenti menggambar gambar.
Graphics.EnumerateMetafileProc	Menyediakan metode panggilan balik untuk metode ini EnumerateMetafile .
Image.GetThumbnailImageAbort	Menyediakan metode panggilan balik untuk menentukan kapan GetThumbnailImage(Int32, Int32, Image+GetThumbnailImageAbort, IntPtr) metode harus membatalkan eksekusi secara prematur.

Keterangan

Perhatian

Namespace System.Drawing memiliki beberapa batasan untuk sistem operasi dan jenis aplikasi tertentu.

Pada Windows, System.Drawing tergantung 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 durasi.
Beberapa jenis di System.Drawing namespace mengandalkan 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, seperti System.Drawing.Color, , System.Drawing.Size System.Drawing.Point, dan System.Drawing.Rectangle, dapat digunakan dalam aplikasi apa pun.
Di .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+ di 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 Menginstal .NET di Linux atau Menginstal .NET di macOS.
Di .NET 6 dan versi 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 aplikasi, alternatif yang direkomendasikan termasuk ImageSharp, SkiaSharp, Komponen Pencitraan Windows, 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, sementara kelas yang berasal dari kelas Brush abstrak digunakan untuk mengisi interior bentuk.