Sdílet prostřednictvím


System.Drawing Obor názvů

Poskytuje přístup k základním grafickým funkcím GDI+. Obory System.Drawing.Drawing2Dnázvů , System.Drawing.Imaginga System.Drawing.Text poskytují pokročilejší funkce. Omezení najdete v části Poznámky.

Třídy

Bitmap

Zapouzdřuje rastrový obrázek GDI+, který se skládá z obrazových dat grafického obrázku a jeho atributů. A Bitmap je objekt, který slouží k práci s obrázky definovanými daty pixelů.

BitmapSuffixInSameAssemblyAttribute

Určuje, že při interpretaci deklarací ToolboxBitmapAttribute by sestavení mělo hledat uvedené prostředky ve stejném sestavení, ale s BitmapSuffix hodnotou konfigurace připojenou k deklarovanému názvu souboru.

BitmapSuffixInSatelliteAssemblyAttribute

Určuje, že při interpretaci ToolboxBitmapAttribute deklarací by sestavení mělo hledat prostředky uvedené v satelitním sestavení, ale s BitmapSuffix hodnotou konfigurace připojenou k deklarovanému názvu souboru.

Brush

Definuje objekty používané k vyplnění interiérů grafických obrazců, jako jsou obdélníky, tři tečky, výseče, mnohoúhelníky a cesty.

Brushes

Štětce pro všechny standardní barvy. Tato třída se nemůže dědit.

BufferedGraphics

Poskytuje grafickou vyrovnávací paměť pro dvojité ukládání do vyrovnávací paměti.

BufferedGraphicsContext

Poskytuje metody pro vytváření grafických vyrovnávacích pamětí, které lze použít pro dvojité ukládání do vyrovnávací paměti.

BufferedGraphicsManager

Poskytuje přístup k hlavnímu objektu grafické kontextové vyrovnávací paměti pro doménu aplikace.

ColorConverter

Převede barvy z jednoho datového typu na jiný. Přístup k této třídě prostřednictvím .TypeDescriptor

ColorTranslator

Překládá barvy do a ze struktur GDI+ Color . Tato třída se nemůže dědit.

Font

Definuje konkrétní formát textu, včetně řezu písma, velikosti a atributů stylu. Tato třída se nemůže dědit.

FontConverter

Font Převede objekty z jednoho datového typu na jiný.

FontConverter.FontNameConverter

FontConverter.FontNameConverter je převaděč typů, který se používá k převodu názvu písma na a z různých jiných reprezentací.

FontConverter.FontUnitConverter

Převede jednotky písma na jiné typy jednotek a z jiných typů jednotek.

FontFamily

Definuje skupinu typových ploch s podobným základním návrhem a určitými variacemi stylů. Tato třída se nemůže dědit.

Graphics

Zapouzdří plochu výkresu GDI+. Tato třída se nemůže dědit.

Icon

Představuje ikonu systému Windows, což je malý rastrový obrázek, který se používá k reprezentaci objektu. Ikony si lze představit jako průhledné rastrové obrázky, i když jejich velikost je určena systémem.

IconConverter

Převede objekt z jednoho datového Icon typu na jiný. Přístup k této třídě prostřednictvím objektu TypeDescriptor .

Image

Abstraktní základní třída, která poskytuje funkce pro Bitmap a Metafile sestupné třídy.

ImageAnimator

Animuje obrázek, který má časové rámce.

ImageConverter

ImageConverter je třída, kterou lze použít k převodu Image objektů z jednoho datového typu na jiný. Přístup k této třídě prostřednictvím objektu TypeDescriptor .

ImageFormatConverter

ImageFormatConverter je třída, kterou lze použít k převodu ImageFormat objektů z jednoho datového typu na jiný. Přístup k této třídě prostřednictvím objektu TypeDescriptor .

Pen

Definuje objekt používaný ke kreslení čar a křivek. Tato třída se nemůže dědit.

Pens

Pera pro všechny standardní barvy. Tato třída se nemůže dědit.

PointConverter

Převede objekt z jednoho datového Point typu na jiný.

RectangleConverter

Převede obdélníky z jednoho datového typu na jiný. Přístup k této třídě prostřednictvím .TypeDescriptor

Region

Popisuje interiér grafického obrazce složeného z obdélníků a cest. Tato třída se nemůže dědit.

SizeConverter

Třída SizeConverter se používá k převodu z jednoho datového typu na jiný. Přístup k této třídě prostřednictvím objektu TypeDescriptor .

SizeFConverter

SizeF Převede objekty z jednoho typu na jiný.

SolidBrush

Definuje štětec jedné barvy. Štětce slouží k vyplnění grafických obrazců, jako jsou obdélníky, elipsy, výseče, mnohoúhelníky a cesty. Tato třída se nemůže dědit.

StringFormat

Zapouzdřuje informace o rozložení textu (například zarovnání, orientaci a zarážky tabulátoru), manipulace se zobrazením (například vložení tří teček a nahrazení národních číslic) a funkce OpenType. Tato třída se nemůže dědit.

SystemBrushes

Každá vlastnost SystemBrushes třídy je SolidBrush barva prvku zobrazení systému Windows.

SystemColors

Každá vlastnost SystemColors třídy je Color struktura, která je barvou prvku zobrazení systému Windows.

SystemFonts

Určuje písma používaná k zobrazení textu v elementech zobrazení systému Windows.

SystemIcons

Každá vlastnost SystemIcons třídy je objektem Icon pro ikony systému Windows v celém systému. Tato třída se nemůže dědit.

SystemPens

Každá vlastnost SystemPens třídy představuje Pen barvu prvku zobrazení systému Windows, který má šířku 1 pixel.

TextureBrush

Každá vlastnost TextureBrush třídy je Brush objekt, který používá obrázek k vyplnění interiéru obrazce. Tato třída se nemůže dědit.

ToolboxBitmapAttribute

Umožňuje určit ikonu představující ovládací prvek v kontejneru, například formulář sady Microsoft Visual Studio Designer.

Struktury

CharacterRange

Určuje rozsah pozic znaků v řetězci.

Color

Představuje barvu ARGB (alfa, červená, zelená, modrá).

Point

Představuje seřazenou dvojici celočíselných souřadnic x a y, která definuje bod v dvojrozměrné rovině.

PointF

Představuje seřazenou dvojici souřadnic x a y s plovoucí desetinnou čárkou, která definuje bod v dvojrozměrné rovině.

Rectangle

Ukládá sadu čtyř celých čísel, která představují umístění a velikost obdélníku.

RectangleF

Ukládá sadu čtyř čísel s plovoucí desetinou čárkou, která představují umístění a velikost obdélníku. Pro pokročilejší funkce oblasti použijte Region objekt .

Size

Ukládá seřazenou dvojici celých čísel, která určují Height a Width.

SizeF

Ukládá seřazenou dvojici čísel s plovoucí desetinnou čárkou, obvykle šířku a výšku obdélníku.

Rozhraní

IDeviceContext

Definuje metody pro získání a uvolnění existujícího popisovače pro kontext zařízení s Windows.

Výčty

ContentAlignment

Určuje zarovnání obsahu na ploše výkresu.

CopyPixelOperation

Určuje, jak je zdrojová barva v operaci kopírování pixelů kombinována s cílovou barvou, aby výsledkem byla konečná barva.

FontStyle

Určuje informace o stylu použité na text.

GraphicsUnit

Určuje měrnou jednotku pro daná data.

KnownColor

Určuje známé systémové barvy.

RotateFlipType

Určuje, do jaké míry se obrázek otočí a osu použitou k překlopení obrázku.

StockIconId

Poskytuje identifikátory ikon pro použití s GetStockIcon(StockIconId, StockIconOptions)nástrojem .

StockIconOptions

Poskytuje možnosti pro použití s GetStockIcon(StockIconId, StockIconOptions).

StringAlignment

Určuje zarovnání textového řetězce vzhledem k jeho obdélníku rozložení.

StringDigitSubstitute

Výčet StringDigitSubstitute určuje, jak nahradit číslice v řetězci podle národního prostředí nebo jazyka uživatele.

StringFormatFlags

Určuje informace o zobrazení a rozložení pro textové řetězce.

StringTrimming

Určuje, jak oříznout znaky z řetězce, který se zcela nevejde do obrazce rozložení.

StringUnit

Určuje měrné jednotky pro textový řetězec.

Delegáti

Graphics.DrawImageAbort

Poskytuje metodu zpětného volání pro rozhodnutí, kdy DrawImage by metoda měla předčasně zrušit provádění a zastavit kreslení obrázku.

Graphics.EnumerateMetafileProc

Poskytuje metodu zpětného volání pro metodu EnumerateMetafile .

Image.GetThumbnailImageAbort

Poskytuje metodu zpětného volání pro určení, kdy GetThumbnailImage(Int32, Int32, Image+GetThumbnailImageAbort, IntPtr) by metoda měla předčasně zrušit provádění.

Poznámky

Upozornění

Obor System.Drawing názvů má určitá omezení pro určité operační systémy a typy aplikací.

  • Ve Windows System.Drawing závisí na nativní knihovně GDI+, která se dodává jako součást operačního systému. Některé skladové položky Windows, například Windows Server Core nebo Windows Nano, nezahrnují tuto nativní knihovnu jako součást operačního systému. Pokud použijete tento obor názvů a knihovnu nelze načíst, vyvolá se za běhu výjimky.

  • Některé typy v System.Drawing oboru názvů spoléhají na rozhraní GDI+, které není podporováno ve službách windows a ASP.NET Core a ASP.NET aplikacích. Tyto typy jsou v balíčku NuGet System.Drawing.Common a zahrnují System.Drawing.Bitmap a System.Drawing.Font. Primitivní typy v oboru názvů, jako System.Drawing.Colorjsou , System.Drawing.Size, System.Drawing.Pointa System.Drawing.Rectangle, však lze použít v libovolné aplikaci.

  • V .NET 5 a předchozích verzích funguje balíček NuGet System.Drawing.Common ve Windows, Linuxu a macOS. Existují však určité rozdíly mezi platformami. V Systémech Linux a macOS je funkce GDI+ implementována knihovnou libgdiplus ). Tato knihovna není ve výchozím nastavení nainstalovaná ve většině distribucí Linuxu a nepodporuje všechny funkce GDI+ ve Windows a macOS. Existují také platformy, kde libgdiplus není k dispozici vůbec. Pokud chcete používat typy z balíčku System.Drawing.Common v Linuxu a macOS, musíte knihovnu libgdiplus nainstalovat samostatně. Další informace najdete v tématech Instalace .NET v Linuxu nebo Instalace .NET v macOS.

  • V .NET 6 a novějších verzích je balíček NuGet System.Drawing.Common podporován pouze v operačních systémech Windows. Další informace najdete v tématu System.Drawing.Common podporované pouze ve Windows.

Pokud s aplikací nemůžete použít System.Drawing , mezi doporučené alternativy patří ImageSharp, SkiaSharp, Windows Imaging Components a Microsoft.Maui.Graphics.

Třída Graphics poskytuje metody pro kreslení do zobrazovacího zařízení. Třídy, jako Rectangle jsou a Point zapouzdřují primitiva GDI+. Třída Pen se používá k kreslení čar a křivek, zatímco třídy odvozené z abstraktní třídy Brush se používají k vyplnění interiérů obrazců.