Rectangle Estrutura

Definição

Namespace:

System.Drawing

Assembly:

System.Drawing.Primitives.dll

Origem:

Rectangle.cs

Armazena um conjunto de quatro inteiros que representam o local 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 construtor Pen 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 modo que 1 pixel é desenhado no próprio limite, 2 pixels são desenhados por dentro e 2 pixels são desenhados por fora. Para obter mais detalhes sobre o alinhamento da caneta, consulte How to: Set Pen Width and Alignment.

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

Canetas

O exemplo foi projetado para uso com o Windows Forms e requer PaintEventArgse, que é um parâmetro do manipulador 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)

Comentários

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

Para desenhar retângulos, você precisa de um objeto Graphics e um objeto Pen. O objeto Graphics fornece o método DrawRectangle e o objeto Pen armazena recursos da linha, como cor e largura. As unidades em que o retângulo é desenhado são determinadas pelas propriedades PageUnit 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 objeto Graphics e um objeto derivado de Brush como SolidBrush ou LinearGradientBrush. O objeto Graphics fornece o método FillRectangle e o objeto Brush fornece as informações de cor e preenchimento.

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

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 não inicializadas.

Propriedades

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

Métodos

Ceiling(RectangleF)	Converte a estrutura de RectangleF especificada em uma estrutura de Rectangle arredondando os valores de RectangleF para os próximos valores inteiros mais altos.
Contains(Int32, Int32)	Determina se o ponto especificado está contido nessa estrutura de Rectangle.
Contains(Point)	Determina se o ponto especificado está contido nessa estrutura de Rectangle.
Contains(Rectangle)	Determina se a região retangular representada por rect está totalmente contida nessa estrutura Rectangle.
Equals(Object)	Testa se obj é uma estrutura Rectangle com o mesmo local e tamanho dessa estrutura Rectangle.
Equals(Rectangle)	Indica se o objeto atual é igual a outro objeto do mesmo tipo.
FromLTRB(Int32, Int32, Int32, Int32)	Cria uma estrutura de Rectangle com os locais de borda especificados.
GetHashCode()	Retorna o código hash para essa estrutura de Rectangle. Para obter informações sobre o uso de códigos de hash, consulte GetHashCode() .
Inflate(Int32, Int32)	Amplia esse Rectangle pelo valor especificado.
Inflate(Rectangle, Int32, Int32)	Cria e retorna uma cópia ampliada da estrutura de Rectangle especificada. A cópia é ampliada pela quantidade especificada. A estrutura de Rectangle original permanece não modificada.
Inflate(Size)	Amplia esse Rectangle pelo valor especificado.
Intersect(Rectangle, Rectangle)	Retorna uma terceira estrutura Rectangle que representa a interseção de duas outras estruturas Rectangle. Se não houver interseção, um Rectangle vazio será retornado.
Intersect(Rectangle)	Substitui essa Rectangle pela interseção de si mesma e pela Rectangleespecificada.
IntersectsWith(Rectangle)	Determina se esse retângulo se cruza com rect.
Offset(Int32, Int32)	Ajusta o local desse retângulo pela quantidade especificada.
Offset(Point)	Ajusta o local desse retângulo pela quantidade especificada.
Round(RectangleF)	Converte o RectangleF especificado em um Rectangle arredondando os valores de RectangleF para os valores inteiros mais próximos.
ToString()	Converte os atributos desse Rectangle em uma cadeia de caracteres legível por humanos.
Truncate(RectangleF)	Converte o RectangleF especificado em um Rectangle truncando os valores de 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 localização e tamanho iguais.
Inequality(Rectangle, Rectangle)	Testa se duas estruturas de Rectangle diferem em local ou tamanho.