Rectangle Rectangle Rectangle Rectangle Struct

Definição

Armazena um conjunto de quatro inteiros que representam o local e o tamanho de um retânguloStores a set of four integers that represent the location and size of a 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 : IEquatable<System.Drawing.Rectangle>
type Rectangle = struct
Public Structure Rectangle
Implements IEquatable(Of Rectangle)
Herança
Atributos
Implementações

Exemplos

O exemplo a seguir desenha um retângulo com seu canto superior esquerdo em (10, 10).The following example draws a rectangle with its upper-left corner at (10, 10). O retângulo tem uma largura de 100 e uma altura de 50.The rectangle has a width of 100 and a height of 50. O segundo argumento passado para o Pen construtor indica que a largura da caneta é 5 pixels.The second argument passed to the Pen constructor indicates that the pen width is 5 pixels.

Quando o retângulo é desenhado, a caneta é centralizada no limite do retângulo.When the rectangle is drawn, the pen is centered on the rectangle's boundary. 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.Because the pen width is 5, the sides of the rectangle are drawn 5 pixels wide, such that 1 pixel is drawn on the boundary itself, 2 pixels are drawn on the inside, and 2 pixels are drawn on the outside. Para obter mais detalhes sobre o alinhamento de caneta, consulte Como definir a largura e alinhamento da caneta.For more details on pen alignment, see How to: Set Pen Width and Alignment.

A ilustração a seguir mostra o retângulo resultante.The following illustration shows the resulting rectangle. As linhas pontilhadas mostram onde o retângulo deveria ser desenhado se a largura da caneta tivesse um pixel.The dotted lines show where the rectangle would have been drawn if the pen width had been one pixel. A exibição ampliada do canto superior esquerdo do retângulo mostra que as linhas pretas espessas são centralizadas nessas linhas pontilhadas.The enlarged view of the upper-left corner of the rectangle shows that the thick black lines are centered on those dotted lines.

CanetasPens

O exemplo é projetado para uso com o Windows Forms e requer PaintEventArgs e, que é um parâmetro do Paint manipulador de eventos.The example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler.

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 o canto superior esquerdo representado pelo Location propriedade.A rectangle is defined by its Width, Height, and upper-left corner represented by the Location property.

Para desenhar retângulos, é necessário um Graphics objeto e um Pen objeto.To draw rectangles, you need a Graphics object and a Pen object. O Graphics objeto fornece os DrawRectangle método e o Pen objeto armazena recursos da linha, como cor e largura.The Graphics object provides the DrawRectangle method, and the Pen object stores features of the line, such as color and width. As unidades que o retângulo é desenhado na é determinado pelo PageUnit e PageScale propriedades dos elementos gráficos usados para o desenho do objeto.The units the rectangle is drawn in is determined by the PageUnit and PageScale properties of the graphics object used for drawing. A unidade padrão é pixels.The default unit is pixels.

Para desenhar um Rectangle preenchido com cor, é necessário um Graphics objeto e um objeto derivam de Brush como SolidBrush ou LinearGradientBrush.To draw a Rectangle filled with color, you need a Graphics object and an object derived from Brush such as SolidBrush or LinearGradientBrush. O Graphics objeto fornece os FillRectangle método e o Brush objeto fornece as informações de cores e preenchimento.The Graphics object provides the FillRectangle method and the Brush object provides the color and fill information.

Para formas mais avançadas, use um Region objeto.For more advanced shapes, use a Region object.

Construtores

Rectangle(Point, Size) Rectangle(Point, Size) Rectangle(Point, Size) Rectangle(Point, Size)

Inicializa uma nova instância da classe Rectangle com o local e o tamanho especificados.Initializes a new instance of the Rectangle class with the specified location and size.

Rectangle(Int32, Int32, Int32, Int32) Rectangle(Int32, Int32, Int32, Int32) Rectangle(Int32, Int32, Int32, Int32) Rectangle(Int32, Int32, Int32, Int32)

Inicializa uma nova instância da classe Rectangle com o local e o tamanho especificados.Initializes a new instance of the Rectangle class with the specified location and size.

Campos

Empty Empty Empty Empty

Representa uma estrutura Rectangle com suas propriedades mantidas com a inicialização cancelada.Represents a Rectangle structure with its properties left uninitialized.

Propriedades

Bottom Bottom Bottom Bottom

Obtém a coordenada y que é a soma dos valores da propriedade Y e Height desta estrutura Rectangle.Gets the y-coordinate that is the sum of the Y and Height property values of this Rectangle structure.

Height Height Height Height

Obtém ou define a altura desta estrutura Rectangle.Gets or sets the height of this Rectangle structure.

IsEmpty IsEmpty IsEmpty IsEmpty

Testa se todas as propriedades numéricas deste Rectangle têm valores de zero.Tests whether all numeric properties of this Rectangle have values of zero.

Left Left Left Left

Obtém a coordenada X da borda superior esquerda desta estrutura Rectangle.Gets the x-coordinate of the left edge of this Rectangle structure.

Location Location Location Location

Obtém ou define as coordenadas do canto superior esquerdo desta estrutura Rectangle.Gets or sets the coordinates of the upper-left corner of this Rectangle structure.

Right Right Right Right

Obtém a coordenada X que é a soma dos valores da propriedade X e Width desta estrutura Rectangle.Gets the x-coordinate that is the sum of X and Width property values of this Rectangle structure.

Size Size Size Size

Obtém ou define o tamanho desse Rectangle.Gets or sets the size of this Rectangle.

Top Top Top Top

Obtém a coordenada y da borda superior dessa estrutura Rectangle.Gets the y-coordinate of the top edge of this Rectangle structure.

Width Width Width Width

Obtém ou define a largura desta estrutura Rectangle.Gets or sets the width of this Rectangle structure.

X X X X

Obtém ou define a coordenada X do canto superior esquerdo da estrutura de Rectangle.Gets or sets the x-coordinate of the upper-left corner of this Rectangle structure.

Y Y Y Y

Obtém ou define a coordenada Y do canto superior esquerdo desta estrutura Rectangle.Gets or sets the y-coordinate of the upper-left corner of this Rectangle structure.

Métodos

Ceiling(RectangleF) Ceiling(RectangleF) Ceiling(RectangleF) Ceiling(RectangleF)

Converte a estrutura RectangleF especificada em uma estrutura Rectangle arredondando os valores RectangleF para os próximos valores inteiros mais altos.Converts the specified RectangleF structure to a Rectangle structure by rounding the RectangleF values to the next higher integer values.

Contains(Point) Contains(Point) Contains(Point) Contains(Point)

Determina se o ponto especificado está contido nessa estrutura Rectangle.Determines if the specified point is contained within this Rectangle structure.

Contains(Rectangle) Contains(Rectangle) Contains(Rectangle) Contains(Rectangle)

Determina se a região retangular representada por rect está inteiramente contida dentro desta estrutura Rectangle.Determines if the rectangular region represented by rect is entirely contained within this Rectangle structure.

Contains(Int32, Int32) Contains(Int32, Int32) Contains(Int32, Int32) Contains(Int32, Int32)

Determina se o ponto especificado está contido nessa estrutura Rectangle.Determines if the specified point is contained within this Rectangle structure.

Equals(Rectangle) Equals(Rectangle) Equals(Rectangle) Equals(Rectangle)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Testa se obj é uma estrutura Rectangle com o mesmo local e tamanho desta estrutura Rectangle.Tests whether obj is a Rectangle structure with the same location and size of this Rectangle structure.

FromLTRB(Int32, Int32, Int32, Int32) FromLTRB(Int32, Int32, Int32, Int32) FromLTRB(Int32, Int32, Int32, Int32) FromLTRB(Int32, Int32, Int32, Int32)

Cria uma estrutura Rectangle com os locais de borda especificados.Creates a Rectangle structure with the specified edge locations.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Retorna o código hash para esta estrutura Rectangle.Returns the hash code for this Rectangle structure. Para obter informações sobre o uso de códigos hash, consulte GetHashCode().For information about the use of hash codes, see GetHashCode() .

Inflate(Size) Inflate(Size) Inflate(Size) Inflate(Size)

Amplia esse Rectangle de acordo com o valor especificado.Enlarges this Rectangle by the specified amount.

Inflate(Int32, Int32) Inflate(Int32, Int32) Inflate(Int32, Int32) Inflate(Int32, Int32)

Amplia esse Rectangle de acordo com o valor especificado.Enlarges this Rectangle by the specified amount.

Inflate(Rectangle, Int32, Int32) Inflate(Rectangle, Int32, Int32) Inflate(Rectangle, Int32, Int32) Inflate(Rectangle, Int32, Int32)

Cria e retorna uma cópia ampliada da estrutura Rectangle especificada.Creates and returns an enlarged copy of the specified Rectangle structure. A cópia é ampliada segundo o valor especificado.The copy is enlarged by the specified amount. A estrutura Rectangle original permanece inalterada.The original Rectangle structure remains unmodified.

Intersect(Rectangle, Rectangle) Intersect(Rectangle, Rectangle) Intersect(Rectangle, Rectangle) Intersect(Rectangle, Rectangle)

Retorna uma terceira estrutura Rectangle que representa a interseção de duas outras estruturas Rectangle.Returns a third Rectangle structure that represents the intersection of two other Rectangle structures. Se não houver nenhuma interseção, um Rectangle vazio será retornado.If there is no intersection, an empty Rectangle is returned.

Intersect(Rectangle) Intersect(Rectangle) Intersect(Rectangle) Intersect(Rectangle)

Substitui este Rectangle com a interseção de si mesmo e o Rectangle especificado.Replaces this Rectangle with the intersection of itself and the specified Rectangle.

IntersectsWith(Rectangle) IntersectsWith(Rectangle) IntersectsWith(Rectangle) IntersectsWith(Rectangle)

Determina se esse retângulo faz interseção com rect.Determines if this rectangle intersects with rect.

Offset(Point) Offset(Point) Offset(Point) Offset(Point)

Ajusta o local desse retângulo pelo valor especificado.Adjusts the location of this rectangle by the specified amount.

Offset(Int32, Int32) Offset(Int32, Int32) Offset(Int32, Int32) Offset(Int32, Int32)

Ajusta o local desse retângulo pelo valor especificado.Adjusts the location of this rectangle by the specified amount.

Round(RectangleF) Round(RectangleF) Round(RectangleF) Round(RectangleF)

Converte o RectangleF especificado em um Rectangle, arredondando os valores RectangleF para os valores de inteiro mais próximos.Converts the specified RectangleF to a Rectangle by rounding the RectangleF values to the nearest integer values.

ToString() ToString() ToString() ToString()

Converte os atributos deste Rectangle em uma cadeia de caracteres legível por humanos.Converts the attributes of this Rectangle to a human-readable string.

Truncate(RectangleF) Truncate(RectangleF) Truncate(RectangleF) Truncate(RectangleF)

Converte o RectangleF especificado como um Rectangle truncando os valores RectangleF.Converts the specified RectangleF to a Rectangle by truncating the RectangleF values.

Union(Rectangle, Rectangle) Union(Rectangle, Rectangle) Union(Rectangle, Rectangle) Union(Rectangle, Rectangle)

Obtém uma estrutura Rectangle que contém a união de duas estruturas Rectangle.Gets a Rectangle structure that contains the union of two Rectangle structures.

Operadores

Equality(Rectangle, Rectangle) Equality(Rectangle, Rectangle) Equality(Rectangle, Rectangle) Equality(Rectangle, Rectangle)

Testa se duas estruturas Rectangle têm local e tamanho iguais.Tests whether two Rectangle structures have equal location and size.

Inequality(Rectangle, Rectangle) Inequality(Rectangle, Rectangle) Inequality(Rectangle, Rectangle) Inequality(Rectangle, Rectangle)

Testa se duas estruturas Rectangle diferem no local ou no tamanho.Tests whether two Rectangle structures differ in location or size.

Aplica-se a