System.Drawing Przestrzeń nazw
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.Drawingzależ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.
