Rectangle Estrutura
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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>
public value class 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>
public struct Rectangle
public struct Rectangle : IEquatable<System.Drawing.Rectangle>
[System.ComponentModel.TypeConverter(typeof(System.Drawing.RectangleConverter))]
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public struct Rectangle
[<System.ComponentModel.TypeConverter("System.Drawing.RectangleConverter, System.Drawing, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
type Rectangle = struct
type Rectangle = struct
[<System.ComponentModel.TypeConverter(typeof(System.Drawing.RectangleConverter))>]
[<System.Runtime.InteropServices.ComVisible(true)>]
[<System.Serializable>]
type Rectangle = struct
Public Structure Rectangle
Implements IEquatable(Of Rectangle)
Public Structure Rectangle
- Herança
- Atributos
- Implementações
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 |
Equals(Object) |
Testa se |
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 |
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. |
Aplica-se a
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de