Rectangle Estrutura

Definição

public value class Rectangle

public value class Rectangle : IEquatable<System::Drawing::Rectangle>

[System.ComponentModel.TypeConverter(typeof(System.Drawing.RectangleConverter))]
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public struct Rectangle

public struct Rectangle

public struct Rectangle : IEquatable<System.Drawing.Rectangle>

[<System.ComponentModel.TypeConverter(typeof(System.Drawing.RectangleConverter))>]
[<System.Runtime.InteropServices.ComVisible(true)>]
[<System.Serializable>]
type Rectangle = struct

type Rectangle = struct

Public Structure Rectangle

Public Structure Rectangle
Implements IEquatable(Of Rectangle)

Herança

Object

ValueType

Rectangle

Atributos

TypeConverterAttribute ComVisibleAttribute SerializableAttribute

Implementações

IEquatable<Rectangle>

Exemplos

O exemplo seguinte desenha um retângulo com o canto superior esquerdo em (10, 10). O retângulo tem uma largura de 100 e uma altura de 50. O segundo argumento passado ao Pen construtor indica que a largura da caneta é de 5 píxeis.

Quando o retângulo é desenhado, a caneta está centrada no limite do retângulo. Como a largura da caneta é 5, os lados do retângulo são desenhados com 5 pixels de largura, de modo que 1 píxel é desenhado na própria fronteira, 2 píxeis são desenhados no interior e 2 píxeis são desenhados no exterior. Para mais detalhes sobre o alinhamento da caneta, veja Como: Definir a Largura e o Alinhamento da Caneta.

A ilustração seguinte mostra o retângulo resultante. As linhas pontilhadas mostram onde o retângulo teria sido desenhado se a largura da caneta fosse de um pixel. A vista ampliada do canto superior esquerdo do retângulo mostra que as linhas pretas grossas estão centradas nessas linhas pontilhadas.

O exemplo foi concebido para uso com Windows Forms e requer PaintEventArgse, que é um parâmetro do handler de eventos Paint.

Pen blackPen = new Pen(Color.FromArgb(255, 0, 0, 0), 5);
e.Graphics.DrawRectangle(blackPen, 10, 10, 100, 50);

Dim blackPen As New Pen(Color.FromArgb(255, 0, 0, 0), 5)
e.Graphics.DrawRectangle(blackPen, 10, 10, 100, 50)

Observações

Um retângulo é definido pelo seu Width, Height, e o canto superior esquerdo representado pela Location propriedade.

Para desenhar retângulos, precisas de um Graphics objeto e um Pen objeto. O Graphics objeto fornece o DrawRectangle método, e o Pen objeto armazena características da linha, como cor e largura. As unidades em que o retângulo é desenhado são determinadas pelas PageUnit propriedades e PageScale do objeto gráfico usado para o desenho. A unidade padrão são os píxeis.

Para desenhar um Rectangle preenchido com cor, precisa de um Graphics objeto e um objeto derivado de Brush tal como SolidBrush ou LinearGradientBrush. O Graphics objeto fornece o FillRectangle método e o Brush objeto fornece a cor e a informação de preenchimento.

Para formas mais avançadas, use um Region objeto.