Rectangle Estructura

Definición

Espacio de nombres:

System.Drawing

Ensamblados:

netstandard.dll, System.Drawing.Primitives.dll

Source:

Rectangle.cs

Almacena un conjunto de cuatro enteros que representan la ubicación y el tamaño de un rectá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)

Herencia

Object

ValueType

Rectangle

Atributos

TypeConverterAttribute

Implementaciones

IEquatable<Rectangle>

Ejemplos

En el ejemplo siguiente se dibuja un rectángulo con su esquina superior izquierda en (10, 10). El rectángulo tiene un ancho de 100 y un alto de 50. El segundo argumento pasado al Pen constructor indica que el ancho del lápiz es de 5 píxeles.

Cuando se dibuja el rectángulo, el lápiz se centra en el límite del rectángulo. Dado que el ancho del lápiz es 5, los lados del rectángulo se dibujan 5 píxeles de ancho, de modo que se dibujan 1 píxeles en el propio límite, se dibujan 2 píxeles en el interior y 2 píxeles se dibujan en el exterior. Para obtener más información sobre la alineación del lápiz, vea How to: Set Pen Width and Alignment.

En la ilustración siguiente se muestra el rectángulo resultante. Las líneas de puntos muestran dónde se habría dibujado el rectángulo si el ancho del lápiz hubiera sido de un píxel. La vista ampliada de la esquina superior izquierda del rectángulo muestra que las líneas negras gruesas se centran en esas líneas de puntos.

El ejemplo está diseñado para su uso con Windows Forms y requiere PaintEventArgse, que es un parámetro del Paint controlador 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)

Comentarios

Un rectángulo se define mediante su Widthesquina superior izquierda representada por la Location propiedad . Height

Para dibujar rectángulos, necesita un Graphics objeto y un Pen objeto . El Graphics objeto proporciona el DrawRectangle método y el Pen objeto almacena las características de la línea, como el color y el ancho. Las unidades en las que se dibuja el rectángulo se determinan mediante las PageUnit propiedades y PageScale del objeto gráfico utilizado para dibujar. La unidad predeterminada es píxeles.

Para dibujar un Rectangle relleno de color, necesita un Graphics objeto y un objeto derivado de Brush como SolidBrush o LinearGradientBrush. El Graphics objeto proporciona el FillRectangle método y el Brush objeto proporciona la información de color y relleno.

Para formas más avanzadas, use un Region objeto .

Constructores

Nombre	Description
Rectangle(Int32, Int32, Int32, Int32)	Inicializa una nueva instancia de la Rectangle clase con la ubicación y el tamaño especificados.
Rectangle(Point, Size)	Inicializa una nueva instancia de la Rectangle clase con la ubicación y el tamaño especificados.

Campos

Nombre	Description
Empty	Representa una Rectangle estructura con sus propiedades sin inicializar.

Propiedades

Nombre	Description
Bottom	Obtiene la coordenada y que es la suma de los valores de propiedad Y y Height de esta Rectangle estructura.
Height	Obtiene o establece el alto de esta Rectangle estructura.
IsEmpty	Comprueba si todas las propiedades numéricas de este Rectangle valor tienen valores de cero.
Left	Obtiene la coordenada x del borde izquierdo de esta Rectangle estructura.
Location	Obtiene o establece las coordenadas de la esquina superior izquierda de esta Rectangle estructura.
Right	Obtiene la coordenada x que es la suma de los valores de X propiedad y Width de esta Rectangle estructura.
Size	Obtiene o establece el tamaño de este Rectangleobjeto .
Top	Obtiene la coordenada y del borde superior de esta Rectangle estructura.
Width	Obtiene o establece el ancho de esta Rectangle estructura.
X	Obtiene o establece la coordenada x de la esquina superior izquierda de esta Rectangle estructura.
Y	Obtiene o establece la coordenada y de la esquina superior izquierda de esta Rectangle estructura.

Métodos

Nombre	Description
Ceiling(RectangleF)	Convierte la estructura especificada RectangleF en una Rectangle estructura redondeando los RectangleF valores a los siguientes valores enteros superiores.
Contains(Int32, Int32)	Determina si el punto especificado está contenido en esta Rectangle estructura.
Contains(Point)	Determina si el punto especificado está contenido en esta Rectangle estructura.
Contains(Rectangle)	Determina si la región rectangular representada por rect está completamente contenida dentro de esta Rectangle estructura.
Equals(Object)	Comprueba si obj es una Rectangle estructura con la misma ubicación y tamaño de esta Rectangle estructura.
Equals(Rectangle)	Indica si el objeto actual es igual a otro objeto del mismo tipo.
FromLTRB(Int32, Int32, Int32, Int32)	Crea una Rectangle estructura con las ubicaciones perimetrales especificadas.
GetHashCode()	Devuelve el código hash de esta Rectangle estructura. Para obtener información sobre el uso de códigos hash, vea GetHashCode() .
Inflate(Int32, Int32)	Amplía esto Rectangle por la cantidad especificada.
Inflate(Rectangle, Int32, Int32)	Crea y devuelve una copia ampliada de la estructura especificada Rectangle . La copia se amplía por la cantidad especificada. La estructura original Rectangle permanece sin modificar.
Inflate(Size)	Amplía esto Rectangle por la cantidad especificada.
Intersect(Rectangle, Rectangle)	Devuelve una tercera Rectangle estructura que representa la intersección de otras dos Rectangle estructuras. Si no hay ninguna intersección, se devuelve un vacío Rectangle .
Intersect(Rectangle)	Reemplaza esto Rectangle por la intersección de sí misma y el especificado Rectangle.
IntersectsWith(Rectangle)	Determina si este rectángulo se interseca con rect.
Offset(Int32, Int32)	Ajusta la ubicación de este rectángulo por la cantidad especificada.
Offset(Point)	Ajusta la ubicación de este rectángulo por la cantidad especificada.
Round(RectangleF)	Convierte el objeto especificado RectangleF en un Rectangle redondeando los RectangleF valores a los valores enteros más cercanos.
ToString()	Convierte los atributos de esto Rectangle en una cadena legible.
Truncate(RectangleF)	Convierte el objeto especificado RectangleF en un Rectangle mediante el truncamiento de los RectangleF valores.
Union(Rectangle, Rectangle)	Obtiene una Rectangle estructura que contiene la unión de dos Rectangle estructuras.

Operadores

Nombre	Description
Equality(Rectangle, Rectangle)	Comprueba si dos Rectangle estructuras tienen una ubicación y un tamaño iguales.
Inequality(Rectangle, Rectangle)	Comprueba si dos Rectangle estructuras difieren en la ubicación o el tamaño.