System.Drawing 命名空間
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
提供 GDI+ 基本圖形功能的存取。 System.Drawing.Drawing2D、 System.Drawing.Imaging 和 System.Drawing.Text 命名空間提供更進階的功能。 如需限制，請參閱一節。
類別
| Bitmap |
封裝 GDI+ 點陣圖，這個點陣圖是由圖形影像的像素資料及其屬性所組成。 Bitmap 是用來處理像素資料所定義影像的物件。 |
| BitmapSuffixInSameAssemblyAttribute |
指定，當解譯 ToolboxBitmapAttribute 宣告時，組件應該尋找相同組件中的指定資源，但是這個組件的宣告檔案名稱有附加 BitmapSuffix 組態值。 |
| BitmapSuffixInSatelliteAssemblyAttribute |
指定，當解譯 ToolboxBitmapAttribute 宣告時，組件應該尋找附屬組件中的指定資源，但是這個組件的宣告檔案名稱有附加 BitmapSuffix 組態值。 |
| Brush |
定義用於填滿圖形形狀內部的物件，例如矩形、橢圓形、派形、多邊形和路徑。 |
| Brushes |
所有標準色彩的筆刷。 此類別無法獲得繼承。 |
| BufferedGraphics |
提供雙重緩衝的圖形緩衝區。 |
| BufferedGraphicsContext |
提供建立圖形緩衝區的方法，該緩衝區可用於雙重緩衝 (Double Buffering)。 |
| BufferedGraphicsManager |
提供對應用程式定義域之主要緩衝圖形內容物件的存取。 |
| ColorConverter |
將色彩從某資料型別轉換為其他資料型別。 這個類別可透過 TypeDescriptor 來存取。 |
| ColorTranslator |
在色彩和 GDI+ Color 結構之間來回轉換。 此類別無法獲得繼承。 |
| Font |
定義文字的特定格式，包括字體、大小和樣式屬性 (Attribute)。 此類別無法獲得繼承。 |
| FontConverter |
將 Font 物件從一個資料型別轉換為另一個資料型別。 |
| FontConverter.FontNameConverter |
FontConverter.FontNameConverter 是型別轉換子 (Type Converter)，用於在字型名稱和各種其他表示之間來回轉換。 |
| FontConverter.FontUnitConverter |
將字型單位與其他單位類型來回轉換。 |
| FontFamily |
定義具有相似基本設計和特定樣式變化的字樣群組。 此類別無法獲得繼承。 |
| Graphics |
封裝 GDI+ 繪圖介面。 此類別無法獲得繼承。 |
| Icon |
代表 Windows 圖示，這個圖示為用來代表物件的小型點陣圖影像。 雖然圖示的大小是由系統決定，但是圖示仍然可以視為透明的點陣圖。 |
| IconConverter |
將 Icon 物件從某一個資料型別轉換為另一個資料型別。 這個類別可透過 TypeDescriptor 物件來存取。 |
| Image | |
| ImageAnimator |
顯示具有以時間為基礎的框架 (Frame) 的影像動畫。 |
| ImageConverter |
ImageConverter 為類別，可用來將 Image 物件從一種資料型別轉換成另一種資料型別。 這個類別可透過 TypeDescriptor 物件來存取。 |
| ImageFormatConverter |
ImageFormatConverter 為類別，可用來將 ImageFormat 物件從一種資料型別轉換成另一種資料型別。 這個類別可透過 TypeDescriptor 物件來存取。 |
| Pen |
定義用來繪製直線與曲線的物件。 此類別無法獲得繼承。 |
| Pens |
所有標準色彩的畫筆。 此類別無法獲得繼承。 |
| PointConverter |
將 Point 物件從某一個資料型別轉換為另一個資料型別。 |
| RectangleConverter |
將矩形從某一資料型別轉換為另一資料型別。 這個類別可透過 TypeDescriptor 來存取。 |
| Region |
描述由矩形和路徑構成的圖形形狀內部。 此類別無法獲得繼承。 |
| SizeConverter |
SizeConverter 類別是用來將某一種資料型別轉換成另一種資料型別。 這個類別可透過 TypeDescriptor 物件來存取。 |
| SizeFConverter |
將 SizeF 物件從一個型別轉換為另一個型別。 |
| SolidBrush |
定義單一色彩的筆刷。 筆刷是用來填滿圖形形狀，例如矩形、橢圓形、派形、多邊形和路徑。 此類別無法獲得繼承。 |
| StringFormat |
封裝文字配置資訊 (例如對齊、方向和定位停駐點)、顯示管理 (例如省略符號插入和國家數字取代) 和 OpenType 功能。 此類別無法獲得繼承。 |
| SystemBrushes |
SystemBrushes 類別的每個屬性是 SolidBrush，其為 Windows 顯示項目的色彩。 |
| SystemColors |
SystemColors 類別的每個屬性是 Color 結構，這個結構為 Windows 顯示項目的色彩。 |
| SystemFonts |
指定用於顯示 Windows 顯示項目中文字的字型。 |
| SystemIcons |
SystemIcons 類別的每一個屬性皆為整個 Windows 系統圖示的 Icon 物件。 此類別無法獲得繼承。 |
| SystemPens |
SystemPens 類別的每個屬性都是 Pen，其為 Windows 顯示項目的色彩，並且寬度為 1 像素。 |
| TextureBrush |
TextureBrush 類別的每一個屬性都是 Brush 物件，這個物件會使用影像來填滿形狀的內部。 此類別無法獲得繼承。 |
| ToolboxBitmapAttribute |
可讓您指定圖示以表示容器中的控制項，例如 Microsoft Visual Studio 表單設計工具。 |
結構
| CharacterRange |
指定字串中的字元位置範圍。 |
| Color |
表示 ARGB (Alpha、紅、綠、藍) 色彩。 |
| Point |
表示整數 X 和 Y 座標之已排序的配對，此配對會定義二維平面中的點。 |
| PointF |
表示浮點 X 和 Y 座標的排序配對，該配對會定義二維平面中的點。 |
| Rectangle |
儲存四個為一組的整數，代表矩形的位置和大小。 |
| RectangleF |
儲存四個為一組的浮點數值 (Floating-Point Number)，表示矩形的位置和大小。 如需更多進階的區域函式，請使用 Region 物件。 |
| Size | |
| SizeF |
儲存已排序的浮點數值 (Floating-Point Number) 配對，通常是矩形的寬度和高度。 |
介面
| IDeviceContext |
定義取得和釋放 Windows 裝置内容的現有控制代碼的方法。 |
列舉
| ContentAlignment |
指定在繪圖表面上的內容對齊。 |
| CopyPixelOperation |
判斷在像素複製作業中來源色彩如何與目的色彩結合以產生最後的色彩。 |
| FontStyle |
指定要套用至文字的樣式資訊。 |
| GraphicsUnit |
指定所指定資料的測量單位。 |
| KnownColor |
指定已知的系統色彩。 |
| RotateFlipType |
指定影像的旋轉量以及用來翻轉影像的座標軸。 |
| StockIconId |
提供用於 的 GetStockIcon(StockIconId, StockIconOptions) 圖示識別碼。 |
| StockIconOptions |
提供搭配 GetStockIcon(StockIconId, StockIconOptions) 使用的選項。 |
| StringAlignment |
指定相對於文字字串之配置矩形的文字字串對齊。 |
| StringDigitSubstitute |
StringDigitSubstitute 列舉型別會指定如何根據使用者的地區設定 (Locale) 或語言來取代字串中的數字。 |
| StringFormatFlags |
指定文字字串的顯示和配置資訊。 |
| StringTrimming |
指定如何從不符合配置形狀的字串修剪字元。 |
| StringUnit |
指定文字字串的測量單位。 |
委派
| Graphics.DrawImageAbort |
提供回呼 (Callback) 方法來決定 DrawImage 方法應該在何時提前取消執行並停止繪製影像。 |
| Graphics.EnumerateMetafileProc |
提供回呼 (Callback) 方法給 EnumerateMetafile 方法。 |
| Image.GetThumbnailImageAbort |
提供回呼 (Callback) 方法來判斷 GetThumbnailImage(Int32, Int32, Image+GetThumbnailImageAbort, IntPtr) 方法何時應該提前取消執行。 |
備註
注意
System.Drawing命名空間對於某些作業系統和應用程式類型有一些限制。
在 Windows 上，
System.Drawing取決於 GDI+ 原生程式庫，該程式庫隨附于 OS 中。 某些 Windows SKU，例如 Windows Server Core 或 Windows Nano，不包含此原生程式庫作為 OS 的一部分。 如果您使用此命名空間，且無法載入程式庫，則會在執行時間擲回例外狀況。命名空間中的
System.Drawing某些類型依賴GDI+，Windows 服務和 ASP.NET Core和 ASP.NET 應用程式不支援此類型。 這些類型位於 System.Drawing.Common NuGet 套件中，並包含 System.Drawing.Bitmap 和 System.Drawing.Font 。 不過，命名空間中的基本類型，例如 System.Drawing.Color 、 System.Drawing.Size 、 System.Drawing.Point 和 System.Drawing.Rectangle ，可以在任何應用程式中使用。在 .NET 5 和舊版中， System.Drawing.Common NuGet 套件可在 Windows、Linux 和 macOS 上運作。 不過，有一些平臺差異。 在 Linux 和 macOS 上，GDI+ 功能是由 libgdiplus) 程式庫實作。 此程式庫預設不會安裝在大部分 Linux 發行版本中，且不支援 Windows 和 macOS 上 GDI+ 的所有功能。 也有一個平臺完全無法使用 libgdiplus。 若要在 Linux 和 macOS 上使用 System.Drawing.Common 套件中的類型，您必須個別安裝 libgdiplus。 如需詳細資訊，請參閱 在 Linux 上安裝 .NET 或在 macOS 上安裝 .NET。
在 .NET 6 和更新版本中，只有 Windows 作業系統才支援 System.Drawing.Common NuGet 套件。 如需詳細資訊，請參閱 僅限 Windows 上支援的 System.Drawing.Common。
如果您無法搭配應用程式使用 System.Drawing ，建議的替代方案包括 ImageSharp、 SkiaSharp、 Windows Imaging Components和 Microsoft.Maui.Graphics。
類別 Graphics 提供繪製至顯示裝置的方法。 和 等 Rectangle 類別會 Point 封裝 GDI+ 基本類型。 類別 Pen 可用來繪製線條和曲線，而衍生自抽象類別的類別 Brush 則用來填滿圖形的內部。
