Rectangle Estrutura

Definição

Namespace:

System.Drawing

Assembly:

System.Drawing.Primitives.dll

Origem:

Rectangle.cs

Armazena um conjunto de quatro inteiros que representam a localização e o tamanho de um retângulo.

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

[System.ComponentModel.TypeConverter("System.Drawing.RectangleConverter, System.Drawing, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public struct Rectangle : IEquatable<System.Drawing.Rectangle>

[<System.ComponentModel.TypeConverter("System.Drawing.RectangleConverter, System.Drawing, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
type Rectangle = struct

Public Structure Rectangle
Implements IEquatable(Of Rectangle)

Herança

Object

ValueType

Rectangle

Atributos

TypeConverterAttribute

Implementações

IEquatable<Rectangle>

Exemplos

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

Quando o retângulo é desenhado, a caneta é centralizada 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 forma que 1 pixel é desenhado no próprio limite, 2 pixels são desenhados no interior e 2 pixels são desenhados fora. Para obter mais detalhes sobre o alinhamento de caneta, consulte Como definir a largura e alinhamento da caneta.

A ilustração a seguir mostra o retângulo resultante. As linhas pontilhadas mostram onde o retângulo deveria ser desenhado se a largura da caneta tivesse um pixel. A exibição ampliada do canto superior esquerdo do retângulo mostra que as linhas pretas espessas são centralizadas nessas linhas pontilhadas.

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

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)

Comentários

Um retângulo é definido por seu Widthcanto superior esquerdo , Heighte representado pela Location propriedade .

Para desenhar retângulos, você precisa de um Graphics objeto e um Pen objeto . O Graphics objeto fornece o DrawRectangle método e o Pen objeto armazena recursos 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 desenho. A unidade padrão é pixels.

Para desenhar um Rectangle preenchido com cor, você precisa de um Graphics objeto e de um objeto derivado de Brush como SolidBrush ou LinearGradientBrush. O Graphics objeto fornece o FillRectangle método e o Brush objeto fornece as informações de cor e preenchimento.

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

Construtores

Rectangle(Int32, Int32, Int32, Int32)	Inicializa uma nova instância da classe Rectangle com o local e o tamanho especificados.
Rectangle(Point, Size)	Inicializa uma nova instância da classe Rectangle com o local e o tamanho especificados.

Campos

Empty

Representa uma estrutura Rectangle com suas propriedades mantidas com a inicialização cancelada.

Propriedades

Bottom	Obtém a coordenada y que é a soma dos valores da propriedade Y e Height desta estrutura Rectangle.
Height	Obtém ou define a altura desta estrutura Rectangle.
IsEmpty	Testa se todas as propriedades numéricas deste Rectangle têm valores de zero.
Left	Obtém a coordenada X da borda superior esquerda desta estrutura Rectangle.
Location	Obtém ou define as coordenadas do canto superior esquerdo desta estrutura Rectangle.
Right	Obtém a coordenada X que é a soma dos valores da propriedade X e Width desta estrutura Rectangle.
Size	Obtém ou define o tamanho desse Rectangle.
Top	Obtém a coordenada y da borda superior dessa estrutura Rectangle.
Width	Obtém ou define a largura desta estrutura Rectangle.
X	Obtém ou define a coordenada X do canto superior esquerdo da estrutura de Rectangle.
Y	Obtém ou define a coordenada Y do canto superior esquerdo desta estrutura Rectangle.

Métodos

Ceiling(RectangleF)	Converte a estrutura RectangleF especificada em uma estrutura Rectangle arredondando os valores RectangleF para os próximos valores inteiros mais altos.
Contains(Int32, Int32)	Determina se o ponto especificado está contido nessa estrutura Rectangle.
Contains(Point)	Determina se o ponto especificado está contido nessa estrutura Rectangle.
Contains(Rectangle)	Determina se a região retangular representada por rect está inteiramente contida dentro desta estrutura Rectangle.
Equals(Object)	Testa se obj é uma estrutura Rectangle com o mesmo local e tamanho desta estrutura Rectangle.
Equals(Rectangle)	Indica se o objeto atual é igual a outro objeto do mesmo tipo.
FromLTRB(Int32, Int32, Int32, Int32)	Cria uma estrutura Rectangle com os locais de borda especificados.
GetHashCode()	Retorna o código hash para esta estrutura Rectangle. Para obter informações sobre o uso de códigos hash, consulte GetHashCode().
Inflate(Int32, Int32)	Amplia esse Rectangle de acordo com o valor especificado.
Inflate(Rectangle, Int32, Int32)	Cria e retorna uma cópia ampliada da estrutura Rectangle especificada. A cópia é ampliada segundo o valor especificado. A estrutura Rectangle original permanece inalterada.
Inflate(Size)	Amplia esse Rectangle de acordo com o valor especificado.
Intersect(Rectangle)	Substitui este Rectangle com a interseção de si mesmo e o Rectangle especificado.
Intersect(Rectangle, Rectangle)	Retorna uma terceira estrutura Rectangle que representa a interseção de duas outras estruturas Rectangle. Se não houver nenhuma interseção, um Rectangle vazio será retornado.
IntersectsWith(Rectangle)	Determina se esse retângulo faz interseção com rect.
Offset(Int32, Int32)	Ajusta o local desse retângulo pelo valor especificado.
Offset(Point)	Ajusta o local desse retângulo pelo valor especificado.
Round(RectangleF)	Converte o RectangleF especificado em um Rectangle, arredondando os valores RectangleF para os valores de inteiro mais próximos.
ToString()	Converte os atributos deste Rectangle em uma cadeia de caracteres legível por humanos.
Truncate(RectangleF)	Converte o RectangleF especificado como um Rectangle truncando os valores RectangleF.
Union(Rectangle, Rectangle)	Obtém uma estrutura Rectangle que contém a união de duas estruturas Rectangle.

Operadores

Equality(Rectangle, Rectangle)	Testa se duas estruturas Rectangle têm local e tamanho iguais.
Inequality(Rectangle, Rectangle)	Testa se duas estruturas Rectangle diferem no local ou no tamanho.