System.Drawing Espaço de Nomes
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Fornece acesso à funcionalidade gráfica básica do GDI+. Os System.Drawing.Drawing2Dnamespaces , System.Drawing.Imaging, e System.Drawing.Text oferecem funcionalidades mais avançadas. Para limitações, consulte a secção de Observações.
Classes
| Name | Description |
|---|---|
| Bitmap |
Encapsula um bitmap GDI+, que consiste nos dados de píxeis de uma imagem gráfica e os seus atributos. A Bitmap é um objeto usado para trabalhar com imagens definidas por dados de píxeis. |
| BitmapSuffixInSameAssemblyAttribute |
Especifica que, ao interpretar ToolboxBitmapAttribute declarações, o assembly deve procurar os recursos indicados na mesma assembly, mas com o BitmapSuffix valor de configuração adicionado ao nome do ficheiro declarado. |
| BitmapSuffixInSatelliteAssemblyAttribute |
Especifica que, ao interpretar ToolboxBitmapAttribute declarações, o assembly deve procurar os recursos indicados numa assembly de satélite, mas com o BitmapSuffix valor de configuração adicionado ao nome do ficheiro declarado. |
| Brush |
Define objetos usados para preencher o interior de formas gráficas como retângulos, elipses, tartas, polígonos e caminhos. |
| Brushes |
Pincéis para todas as cores padrão. Esta classe não pode ser herdada. |
| BufferedGraphics |
Fornece um buffer gráfico para duplo buffering. |
| BufferedGraphicsContext |
Fornece métodos para criar buffers gráficos que podem ser usados para duplo buffering. |
| BufferedGraphicsManager |
Fornece acesso ao principal objeto de contexto gráfico em buffer para o domínio da aplicação. |
| ColorConverter |
Converte cores de um tipo de dado para outro. Acede a esta classe através do TypeDescriptor. |
| ColorTranslator |
Traduz cores para e a partir das estruturas GDI+ Color . Esta classe não pode ser herdada. |
| Font |
Define um formato particular para o texto, incluindo fontes de letra, tamanho e atributos de estilo. Esta classe não pode ser herdada. |
| FontConverter |
Converte Font objetos de um tipo de dado para outro. |
| FontConverter.FontNameConverter |
FontConverter.FontNameConverter é um conversor de tipos que é usado para converter um nome de fonte para e a partir de várias outras representações. |
| FontConverter.FontUnitConverter |
Converte unidades de fonte para e a partir de outros tipos de unidades. |
| FontFamily |
Define um grupo de tipos tipográficos com um design básico semelhante e certas variações nos estilos. Esta classe não pode ser herdada. |
| Graphics |
Encapsula uma superfície de desenho GDI+. Esta classe não pode ser herdada. |
| Icon |
Representa um ícone do Windows, que é uma pequena imagem bitmap usada para representar um objeto. Os ícones podem ser considerados bitmaps transparentes, embora o seu tamanho seja determinado pelo sistema. |
| IconConverter |
Converte um Icon objeto de um tipo de dado para outro. Acede a esta classe através do TypeDescriptor objeto. |
| Image |
Uma classe base abstrata que fornece funcionalidade para as Bitmap classes e Metafile descendentes. |
| ImageAnimator |
Anima uma imagem que tem frames baseados no tempo. |
| ImageConverter |
ImageConverter é uma classe que pode ser usada para converter Image objetos de um tipo de dado para outro. Acede a esta classe através do TypeDescriptor objeto. |
| ImageFormatConverter |
ImageFormatConverter é uma classe que pode ser usada para converter ImageFormat objetos de um tipo de dado para outro. Acede a esta classe através do TypeDescriptor objeto. |
| Pen |
Define um objeto usado para desenhar linhas e curvas. Esta classe não pode ser herdada. |
| Pens |
Canetas para todas as cores padrão. Esta classe não pode ser herdada. |
| PointConverter |
Converte um Point objeto de um tipo de dado para outro. |
| RectangleConverter |
Converte retângulos de um tipo de dado para outro. Acede a esta classe através do TypeDescriptor. |
| Region |
Descreve o interior de uma forma gráfica composta por retângulos e caminhos. Esta classe não pode ser herdada. |
| SizeConverter |
A SizeConverter classe é usada para converter de um tipo de dado para outro. Acede a esta classe através do TypeDescriptor objeto. |
| SizeFConverter |
Converte SizeF objetos de um tipo para outro. |
| SolidBrush |
Define um pincel de uma única cor. Os pincéis são usados para preencher formas de gráficos, como retângulos, elipses, tartas, polígonos e caminhos. Esta classe não pode ser herdada. |
| StringFormat |
Encapsula informação de layout de texto (como alinhamento, orientação e paradas de tabulação), manipulações de ecrã (como inserção de reticências e substituição de dígitos nacionais) e funcionalidades OpenType. Esta classe não pode ser herdada. |
| SystemBrushes |
Cada propriedade da classe SystemBrushes é uma SolidBrush que é a cor de um elemento de exibição Windows. |
| SystemColors |
Cada propriedade da classe SystemColors é uma estrutura Color que é a cor de um elemento de exibição Windows. |
| SystemFonts |
Especifica as fontes usadas para mostrar texto nos elementos de exibição do Windows. |
| SystemIcons |
Cada propriedade da classe SystemIcons é um objeto Icon para ícones Windows de todo o sistema. Esta classe não pode ser herdada. |
| SystemPens |
Cada propriedade da classe SystemPens é uma Pen que é a cor de um elemento de exibição Windows e que tem uma largura de 1 píxel. |
| TextureBrush |
Cada propriedade da TextureBrush classe é um Brush objeto que utiliza uma imagem para preencher o interior de uma forma. Esta classe não pode ser herdada. |
| ToolboxBitmapAttribute |
Permite especificar um ícone para representar um controlo num contentor, como o Microsoft Visual Studio Form Designer. |
Estruturas
| Name | Description |
|---|---|
| CharacterRange |
Especifica um intervalo de posições de caracteres dentro de uma cadeia. |
| Color |
Representa uma cor ARGB (alfa, vermelho, verde, azul). |
| Point |
Representa um par ordenado de coordenadas inteiras x e y que define um ponto num plano bidimensional. |
| PointF |
Representa um par ordenado de coordenadas x e y de ponto flutuante que define um ponto num plano bidimensional. |
| Rectangle |
Armazena um conjunto de quatro inteiros que representam a localização e o tamanho de um retângulo. |
| RectangleF |
Armazena um conjunto de quatro números em ponto flutuante que representam a localização e o tamanho de um retângulo. Para funções de região mais avançadas, use um Region objeto. |
| Size |
Armazena um par ordenado de inteiros, que especificam um Height e Width. |
| SizeF |
Armazena um par ordenado de números em ponto flutuante, tipicamente da largura e altura de um retângulo. |
Interfaces
| Name | Description |
|---|---|
| IDeviceContext |
Define métodos para obter e libertar um handle existente para o contexto de um dispositivo Windows. |
Enumerações
| Name | Description |
|---|---|
| ContentAlignment |
Especifica o alinhamento do conteúdo na superfície de desenho. |
| CopyPixelOperation |
Determina como a cor de origem numa operação de copiar píxel é combinada com a cor de destino para resultar numa cor final. |
| FontStyle |
Especifica a informação de estilo aplicada ao texto. |
| GraphicsUnit |
Especifica a unidade de medida para os dados dados. |
| KnownColor |
Especifica as cores conhecidas do sistema. |
| RotateFlipType |
Especifica quanto uma imagem é rodada e o eixo usado para inverter a imagem. |
| StringAlignment |
Especifica o alinhamento de uma cadeia de texto relativamente ao seu retângulo de layout. |
| StringDigitSubstitute |
A StringDigitSubstitute enumeração especifica como substituir dígitos numa cadeia de caracteres de acordo com a localização ou língua do utilizador. |
| StringFormatFlags |
Especifica a informação de visualização e layout para cadeias de texto. |
| StringTrimming |
Especifica como cortar caracteres de uma cadeia que não encaixa completamente numa forma de layout. |
| StringUnit |
Especifica as unidades de medida para uma cadeia de texto. |
Delegados
| Name | Description |
|---|---|
| Graphics.DrawImageAbort |
Fornece um método de callback para decidir quando o DrawImage método deve cancelar prematuramente a execução e parar de desenhar uma imagem. |
| Graphics.EnumerateMetafileProc |
Fornece um método de callback para o EnumerateMetafile método. |
| Image.GetThumbnailImageAbort |
Fornece um método de callback para determinar quando o GetThumbnailImage(Int32, Int32, Image+GetThumbnailImageAbort, IntPtr) método deve cancelar prematuramente a execução. |
Observações
Atenção
O System.Drawing espaço de nomes apresenta algumas limitações para certos sistemas operativos e tipos de aplicação.
No Windows,
System.Drawingdepende da biblioteca nativa GDI+, que é incluída no sistema operativo. Alguns SKUs do Windows, como o Windows Server Core ou o Windows Nano, não incluem esta biblioteca nativa como parte do sistema operativo. Se usares este namespace e a biblioteca não puder ser carregada, as exceções serão lançadas em tempo de execução.Alguns tipos no espaço de nomes
System.Drawingdependem de GDI+, que não é suportado em serviços Windows nem em aplicações ASP.NET Core e ASP.NET. Estes tipos estão no pacote System.Drawing.Common NuGet e incluem System.Drawing.Bitmap e System.Drawing.Font. No entanto, tipos primitivos no namespace, como System.Drawing.Color, System.Drawing.Size, System.Drawing.Point, e System.Drawing.Rectangle, podem ser usados em qualquer aplicação.No .NET 5 e versões anteriores, o pacote NuGet System.Drawing.Common funciona em Windows, Linux e macOS. No entanto, existem algumas diferenças nas plataformas. No Linux e macOS, a funcionalidade GDI+ é implementada pela biblioteca libgdiplus . Esta biblioteca não está instalada por defeito na maioria das distribuições Linux e não suporta toda a funcionalidade do GDI+ no Windows e macOS. Existem também plataformas onde o libgdiplus não está disponível de todo. Para usar tipos do pacote System.Drawing.Common no Linux e macOS, deve instalar o libgdiplus separadamente. Para mais informações, consulte Instalar .NET em Linux ou Instalar .NET no macOS.
Em versões .NET 6 e posteriores, o pacote NuGet System.Drawing.Common é suportado apenas em sistemas operativos Windows. Para obter mais informações, consulte System.Drawing.Common suportado apenas no Windows.
Se não puder usar System.Drawing com a sua aplicação, as alternativas recomendadas incluem ImageSharp, SkiaSharp, Windows Componentes de Imagem e Microsoft. Maui.Graphics.
A Graphics classe fornece métodos para desenhar para o dispositivo de visualização. Classes como Rectangle e Point encapsulam primitivas GDI+. A Pen classe é usada para desenhar linhas e curvas, enquanto classes derivadas da classe Brush abstrata são usadas para preencher o interior das formas.