System.Drawing 名前空間
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
GDI+ の基本的なグラフィックス機能を使用できるようにします。 、System.Drawing.Imaging、および System.Drawing.Text 名前空間はSystem.Drawing.Drawing2D、より高度な機能を提供します。 制限事項については、「解説」セクションを参照してください。
クラス
Bitmap |
GDI+ ビットマップをカプセル化します。このビットマップは、グラフィックス イメージのピクセル データとその属性で構成されます。 Bitmap は、ピクセル データで定義したイメージを処理する場合に使用するオブジェクトです。 |
BitmapSuffixInSameAssemblyAttribute |
ToolboxBitmapAttribute 宣言を解釈する場合、アセンブリは同じアセンブリ内の指定されたリソース、ただし、宣言されたファイル名に追加されている BitmapSuffix 構成値を持つリソースを検索する必要があることを指定します。 |
BitmapSuffixInSatelliteAssemblyAttribute |
ToolboxBitmapAttribute 宣言を解釈する場合、アセンブリはサテライト アセンブリ内の指定されたリソース、ただし、宣言されたファイル名に追加されている BitmapSuffix 構成値を持つリソースを検索する必要があることを指定します。 |
Brush |
四角形、楕円、扇形、多角形、パスなどのグラフィカル形状の内部を塗りつぶすために使用するオブジェクトを定義します。 |
Brushes |
すべての標準色のブラシ。 このクラスは継承できません。 |
BufferedGraphics |
ダブル バッファリングのためのグラフィックス バッファーを提供します。 |
BufferedGraphicsContext |
ダブル バッファリングに使用できるグラフィックス バッファーを作成するためのメソッドを提供します。 |
BufferedGraphicsManager |
メインのバッファー内グラフィックス コンテキスト オブジェクトへのアクセスをアプリケーション ドメインに提供します。 |
ColorConverter |
あるデータ型の色を別の色に変換します。 このクラスには TypeDescriptor を使用してアクセスします。 |
ColorTranslator |
色の GDI+ Color 構造体への変換と、その逆の変換を行います。 このクラスは継承できません。 |
Font |
フォント フェイス、サイズ、スタイルの各属性など、テキストの特定の書式を定義します。 このクラスは継承できません。 |
FontConverter |
あるデータ型の Font オブジェクトを別の型に変換します。 |
FontConverter.FontNameConverter |
FontConverter.FontNameConverter は、フォント名と他の表現とを相互に変換するために使用する型コンバーターです。 |
FontConverter.FontUnitConverter |
フォント単位の種類を変換します。 |
FontFamily |
基本デザインが同様でスタイルが異なるタイプフェイスのグループを定義します。 このクラスは継承できません。 |
Graphics |
GDI+ 描画サーフェイスをカプセル化します。 このクラスは継承できません。 |
Icon |
Windows アイコンを表します。これはオブジェクトを表すために使用される小さなビットマップ イメージです。 アイコンは透明なビットマップと考えることもできますが、そのサイズはシステムによって決定されます。 |
IconConverter |
Icon オブジェクトのデータ型を別のデータ型に変換します。 TypeDescriptor オブジェクトを通じてこのクラスにアクセスします。 |
Image | |
ImageAnimator |
タイムベース フレームが含まれているイメージをアニメーション化します。 |
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 クラスの各プロパティは、Windows の表示要素の色を表す SolidBrush です。 |
SystemColors |
SystemColors クラスの各プロパティは、Windows の表示要素の色を表す Color 構造体です。 |
SystemFonts |
Windows 表示要素内でテキストの表示に使用するフォントを指定します。 |
SystemIcons |
SystemIcons クラスの各プロパティは、Windows のシステム全体のアイコンの Icon オブジェクトです。 このクラスは継承できません。 |
SystemPens |
SystemPens クラスの各プロパティは、Windows の表示要素の色を表す、幅が 1 ピクセルの Pen です。 |
TextureBrush |
TextureBrush クラスの各プロパティは、イメージを使用して形状の内部を塗りつぶす Brush オブジェクトです。 このクラスは継承できません。 |
ToolboxBitmapAttribute |
Microsoft Visual Studio フォーム デザイナーなど、コンテナー内のコントロールを表すアイコンを指定できるようにします。 |
構造体
CharacterRange |
文字列内の文字位置の範囲を指定します。 |
Color |
ARGB (アルファ、赤、緑、青) 色を表します。 |
Point |
2 次元面の 1 点を定義する、順序付けされた整数の X 座標と Y 座標のペアを表します。 |
PointF |
2 次元平面に点を定義する浮動小数点座標ペア (x 座標と y 座標) を表します。 |
Rectangle |
四角形の位置とサイズを表す 4 つの整数を格納します。 |
RectangleF |
四角形の位置とサイズを表す 4 つの浮動小数点数を格納します。 より高度な領域関数を使用する場合は Region オブジェクトを使用します。 |
Size | |
SizeF |
順序を付与した浮動小数点数の対 (通常、四角形の幅と高さ) を格納します。 |
インターフェイス
IDeviceContext |
Windows デバイス コンテキストを識別する既存のハンドルを取得および解放するためのメソッドを定義します。 |
列挙型
ContentAlignment |
描画面でのコンテンツの配置方法を指定します。 |
CopyPixelOperation |
ピクセル コピー操作のコピー元の色を、コピー先の色と組み合わせて最終的な色を得る方法を決定します。 |
FontStyle |
テキストに適用するスタイル情報を指定します。 |
GraphicsUnit |
指定のデータの長さの単位を指定します。 |
KnownColor |
既知のシステム カラーを指定します。 |
RotateFlipType |
イメージの回転量と、イメージ反転に使用される軸を指定します。 |
StockIconId |
で GetStockIcon(StockIconId, StockIconOptions)使用するアイコン識別子を提供します。 |
StockIconOptions |
で使用するオプションを GetStockIcon(StockIconId, StockIconOptions)提供します。 |
StringAlignment |
レイアウト四角形を基準とした文字列の配置を指定します。 |
StringDigitSubstitute |
StringDigitSubstitute 列挙体は、文字列内の数字を置き換える方法をユーザーのロケールまたは言語に従って指定します。 |
StringFormatFlags |
文字列の表示情報およびレイアウト情報を指定します。 |
StringTrimming |
レイアウト形状に完全には収まらない文字列から文字をトリムする場合の方法を指定します。 |
StringUnit |
テキスト文字列の長さの単位を指定します。 |
代理人
Graphics.DrawImageAbort |
DrawImage メソッドが、実行を早期キャンセルし、イメージの描画を停止するタイミングを決定するコールバック メソッドを提供します。 |
Graphics.EnumerateMetafileProc |
EnumerateMetafile メソッドのコールバック メソッドを提供します。 |
Image.GetThumbnailImageAbort |
GetThumbnailImage(Int32, Int32, Image+GetThumbnailImageAbort, IntPtr) メソッドが、実行を早期キャンセルするタイミングを決定するコールバック メソッドを提供します。 |
注釈
注意事項
System.Drawing
名前空間には、特定のオペレーティング システムとアプリケーションの種類に関するいくつかの制限があります。
Windows では、
System.Drawing
は、OS の一部として出荷される GDI+ ネイティブ ライブラリに依存します。 Windows Server Core や Windows Nano などの一部の Windows SKU には、OS の一部としてこのネイティブ ライブラリが含まれていません。 この名前空間を使用し、ライブラリを読み込めなかった場合、実行時に例外がスローされます。名前空間の一部の
System.Drawing
型は GDI+ に依存しています。これは Windows サービスおよび ASP.NET Coreおよび ASP.NET アプリではサポートされていません。 これらの型は System.Drawing.Common NuGet パッケージにあり、 と System.Drawing.Fontが含まれますSystem.Drawing.Bitmap。 ただし、、、、、 などのSystem.Drawing.ColorSystem.Drawing.SizeSystem.Drawing.PointSystem.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 以降のバージョンでは、 System.Drawing.Common NuGet パッケージは Windows オペレーティング システムでのみサポートされています。 詳細については、「 Windows でのみサポートされる System.Drawing.Common」を参照してください。
アプリケーションでを使用 System.Drawing
できない場合は、 ImageSharp、 SkiaSharp、 Windows イメージング コンポーネント、 Microsoft.Maui.Graphics などの代替手段をお勧めします。
クラスは Graphics 、ディスプレイ デバイスに描画するためのメソッドを提供します。 GDI+ プリミティブなどの Rectangle クラスと Point カプセル化します。 クラスは Pen 線と曲線を描画するために使用され、抽象クラスから派生したクラス Brush は図形の内部を塗りつぶすために使用されます。
.NET