System.Drawing Przestrzeń nazw

Odwołanie

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Zapewnia dostęp do podstawowych funkcji graficznych GDI+. Przestrzenie System.Drawing.Drawing2Dnazw , System.Drawing.Imagingi System.Drawing.Text zapewniają bardziej zaawansowaną funkcjonalność. Aby uzyskać informacje o ograniczeniach, zobacz sekcję Uwagi.

Klasy

Bitmap	Hermetyzuje mapę bitową GDI+ składającą się z danych pikseli dla obrazu graficznego i jego atrybutów. Obiekt Bitmap jest obiektem używanym do pracy z obrazami zdefiniowanymi przez dane pikseli.
BitmapSuffixInSameAssemblyAttribute	Określa, że podczas interpretacji ToolboxBitmapAttribute deklaracji zestaw powinien szukać wskazanych zasobów w tym samym zestawie, ale z wartością BitmapSuffix konfiguracji dołączona do zadeklarowanej nazwy pliku.
BitmapSuffixInSatelliteAssemblyAttribute	Określa, że podczas interpretacji ToolboxBitmapAttribute deklaracji zestaw powinien szukać wskazanych zasobów w zestawie satelitarnym, ale z wartością BitmapSuffix konfiguracji dołączona do zadeklarowanej nazwy pliku.
Brush	Definiuje obiekty używane do wypełniania wnętrz kształtów graficznych, takich jak prostokąty, wielokropek, ciasta, wielokąty i ścieżki.
Brushes	Pędzle dla wszystkich standardowych kolorów. Klasa ta nie może być dziedziczona.
BufferedGraphics	Zapewnia bufor graficzny do podwójnego buforowania.
BufferedGraphicsContext	Udostępnia metody tworzenia buforów graficznych, których można użyć do podwójnego buforowania.
BufferedGraphicsManager	Zapewnia dostęp do głównego buforowanego obiektu kontekstu graficznego dla domeny aplikacji.
ColorConverter	Konwertuje kolory z jednego typu danych na inny. Uzyskaj dostęp do tej klasy za pośrednictwem klasy TypeDescriptor.
ColorTranslator	Tłumaczy kolory na i z struktur GDI+ Color . Klasa ta nie może być dziedziczona.
Font	Definiuje określony format tekstu, w tym atrybuty twarzy czcionki, rozmiaru i stylu. Klasa ta nie może być dziedziczona.
FontConverter	Konwertuje Font obiekty z jednego typu danych na inny.
FontConverter.FontNameConverter	FontConverter.FontNameConverter to konwerter typów, który służy do konwertowania nazwy czcionki na i z różnych innych reprezentacji.
FontConverter.FontUnitConverter	Konwertuje jednostki czcionek na i z innych typów jednostek.
FontFamily	Definiuje grupę typów twarzy o podobnym podstawowym projekcie i pewnych odmianach stylów. Klasa ta nie może być dziedziczona.
Graphics	Hermetyzuje powierzchnię rysunkową GDI+ . Klasa ta nie może być dziedziczona.
Icon	Reprezentuje ikonę systemu Windows, która jest małym obrazem mapy bitowej używanym do reprezentowania obiektu. Ikony można traktować jako przezroczyste mapy bitowe, chociaż ich rozmiar jest określany przez system.
IconConverter	Konwertuje Icon obiekt z jednego typu danych na inny. Uzyskaj dostęp do tej klasy za pośrednictwem TypeDescriptor obiektu.
Image	Abstrakcyjna klasa bazowa, która udostępnia funkcje Bitmap klas i Metafile malejących.
ImageAnimator	Animuje obraz z ramkami czasowymi.
ImageConverter	ImageConverter to klasa, która może służyć do konwertowania Image obiektów z jednego typu danych na inny. Uzyskaj dostęp do tej klasy za pośrednictwem TypeDescriptor obiektu.
ImageFormatConverter	ImageFormatConverter to klasa, która może służyć do konwertowania ImageFormat obiektów z jednego typu danych na inny. Uzyskaj dostęp do tej klasy za pośrednictwem TypeDescriptor obiektu.
Pen	Definiuje obiekt używany do rysowania linii i krzywych. Klasa ta nie może być dziedziczona.
Pens	Pióra dla wszystkich standardowych kolorów. Klasa ta nie może być dziedziczona.
PointConverter	Konwertuje Point obiekt z jednego typu danych na inny.
RectangleConverter	Konwertuje prostokąty z jednego typu danych na inny. Uzyskaj dostęp do tej klasy za pośrednictwem klasy TypeDescriptor.
Region	Opisuje wnętrze kształtu grafiki składającego się z prostokątów i ścieżek. Klasa ta nie może być dziedziczona.
SizeConverter	Klasa służy do konwertowania SizeConverter z jednego typu danych na inny. Uzyskaj dostęp do tej klasy za pośrednictwem TypeDescriptor obiektu.
SizeFConverter	Konwertuje SizeF obiekty z jednego typu na inny.
SolidBrush	Definiuje szczotkę pojedynczego koloru. Pędzle służą do wypełniania kształtów graficznych, takich jak prostokąty, wielokropek, ciasta, wielokąty i ścieżki. Klasa ta nie może być dziedziczona.
StringFormat	Hermetyzuje informacje o układzie tekstu (takie jak wyrównanie, orientacja i zatrzymanie tabulatorów) wyświetla manipulacje (takie jak wstawianie wielokropka i podstawianie cyfr krajowych) i funkcje OpenType. Klasa ta nie może być dziedziczona.
SystemBrushes	Każda właściwość SystemBrushes klasy jest SolidBrush kolorem elementu wyświetlania systemu Windows.
SystemColors	Każda właściwość SystemColors klasy jest strukturą Color , która jest kolorem elementu wyświetlania systemu Windows.
SystemFonts	Określa czcionki używane do wyświetlania tekstu w elementach wyświetlania systemu Windows.
SystemIcons	Każda SystemIcons właściwość klasy jest obiektem Icon dla ikon systemu Windows. Klasa ta nie może być dziedziczona.
SystemPens	Każda właściwość SystemPens klasy jest kolorem Pen elementu wyświetlania systemu Windows i ma szerokość 1 pikseli.
TextureBrush	Każda właściwość TextureBrush klasy jest obiektem Brush , który używa obrazu do wypełnienia wnętrza kształtu. Klasa ta nie może być dziedziczona.
ToolboxBitmapAttribute	Umożliwia określenie ikony reprezentującej kontrolkę w kontenerze, na przykład formularz Programu Microsoft Visual Studio Projektant.

Struktury

CharacterRange	Określa zakres pozycji znaków w ciągu.
Color	Reprezentuje kolor ARGB (alfa, czerwony, zielony, niebieski).
Point	Reprezentuje uporządkowaną parę współrzędnych x-i y, która definiuje punkt na dwuwymiarowej płaszczyźnie.
PointF	Reprezentuje uporządkowaną parę współrzędnych zmiennoprzecinkowych x i y, która definiuje punkt w dwuwymiarowej płaszczyźnie.
Rectangle	Przechowuje zestaw czterech liczb całkowitych reprezentujących lokalizację i rozmiar prostokąta.
RectangleF	Przechowuje zestaw czterech liczb zmiennoprzecinkowych reprezentujących lokalizację i rozmiar prostokąta. Aby uzyskać bardziej zaawansowane funkcje regionów, użyj Region obiektu.
Size	Przechowuje uporządkowaną parę liczb całkowitych, które określają element Height i Width.
SizeF	Przechowuje uporządkowaną parę liczb zmiennoprzecinkowych, zazwyczaj szerokość i wysokość prostokąta.

Interfejsy

IDeviceContext

Definiuje metody uzyskiwania i wydawania istniejącego uchwytu do kontekstu urządzenia z systemem Windows.

Wyliczenia

ContentAlignment	Określa wyrównanie zawartości na powierzchni rysunku.
CopyPixelOperation	Określa, w jaki sposób kolor źródłowy operacji kopiowania pikseli jest połączony z kolorem docelowym, aby spowodować ostateczny kolor.
FontStyle	Określa informacje o stylu zastosowane do tekstu.
GraphicsUnit	Określa jednostkę miary dla danych.
KnownColor	Określa znane kolory systemowe.
RotateFlipType	Określa, ile obraz jest obracany, a oś używana do przerzucania obrazu.
StockIconId	Udostępnia identyfikatory ikon do użycia z programem GetStockIcon(StockIconId, StockIconOptions).
StockIconOptions	Udostępnia opcje użycia z programem GetStockIcon(StockIconId, StockIconOptions).
StringAlignment	Określa wyrównanie ciągu tekstowego względem prostokąta układu.
StringDigitSubstitute	Wyliczenie StringDigitSubstitute określa, jak zastąpić cyfry w ciągu zgodnie z ustawieniami regionalnymi lub językiem użytkownika.
StringFormatFlags	Określa informacje o wyświetlaniu i układzie ciągów tekstowych.
StringTrimming	Określa sposób przycinania znaków z ciągu, który nie pasuje całkowicie do kształtu układu.
StringUnit	Określa jednostki miary dla ciągu tekstowego.

Delegaci

Graphics.DrawImageAbort	Udostępnia metodę wywołania zwrotnego do podjęcia decyzji, kiedy DrawImage metoda powinna przedwcześnie anulować wykonywanie i zatrzymać rysowanie obrazu.
Graphics.EnumerateMetafileProc	Udostępnia metodę wywołania zwrotnego EnumerateMetafile dla metody .
Image.GetThumbnailImageAbort	Udostępnia metodę wywołania zwrotnego do określenia, kiedy GetThumbnailImage(Int32, Int32, Image+GetThumbnailImageAbort, IntPtr) metoda powinna przedwcześnie anulować wykonywanie.

Uwagi

Przestroga

System.Drawing Przestrzeń nazw ma pewne ograniczenia dotyczące niektórych systemów operacyjnych i typów aplikacji.

W systemie Windows System.Drawing zależy od biblioteki natywnej GDI+ dostarczanej w ramach systemu operacyjnego. Niektóre jednostki SKU systemu Windows, takie jak Windows Server Core lub Windows Nano, nie zawierają tej biblioteki natywnej w ramach systemu operacyjnego. Jeśli używasz tej przestrzeni nazw i nie można załadować biblioteki, wyjątki zostaną zgłoszone w czasie wykonywania.
Niektóre typy w przestrzeni nazw korzystają z interfejsu System.DrawingGDI+, który nie jest obsługiwany w usługach systemu Windows i aplikacjach ASP.NET Core i ASP.NET. Te typy znajdują się w pakiecie NuGet System.Drawing.Common i zawierają System.Drawing.Bitmap i System.Drawing.Font. Jednak typy pierwotne w przestrzeni nazw, takie jak System.Drawing.Color, System.Drawing.Size, System.Drawing.Pointi System.Drawing.Rectangle, mogą być używane w dowolnej aplikacji.
W programach .NET 5 i poprzednich wersjach pakiet NuGet System.Drawing.Common działa w systemach Windows, Linux i macOS. Istnieją jednak pewne różnice między platformami. W systemach Linux i macOS funkcja GDI+ jest implementowana przez bibliotekę libgdiplus . Ta biblioteka nie jest domyślnie zainstalowana w większości dystrybucji systemu Linux i nie obsługuje wszystkich funkcji GDI+ w systemach Windows i macOS. Istnieją również platformy, na których biblioteka libgdiplus nie jest w ogóle dostępna. Aby używać typów z pakietu System.Drawing.Common w systemach Linux i macOS, należy zainstalować bibliotekę libgdiplus oddzielnie. Aby uzyskać więcej informacji, zobacz Instalowanie platformy .NET w systemie Linux lub Instalowanie platformy .NET w systemie macOS.
W programach .NET 6 i nowszych pakiet NuGet System.Drawing.Common jest obsługiwany tylko w systemach operacyjnych Windows. Aby uzyskać więcej informacji, zobacz System.Drawing.Common only supported on Windows (Obsługiwane tylko w systemie Windows).

Jeśli nie możesz używać System.Drawing z aplikacją, zalecane alternatywy to ImageSharp, SkiaSharp, Windows Imaging Components i Microsoft.Maui.Graphics.

Klasa Graphics udostępnia metody rysowania na urządzeniu wyświetlania. Klasy takie jak Rectangle i Point hermetyzowane elementy pierwotne GDI+. Klasa Pen służy do rysowania linii i krzywych, podczas gdy klasy pochodzące z klasy Brush abstrakcyjnej są używane do wypełniania wnętrz kształtów.