Rectangle Estructura

Definición

Espacio de nombres:

System.Drawing

Ensamblado:

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 constructor Pen 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, consulte Cómo: Establecer el ancho del lápiz y la alineación.

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 controlador 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)

Comentarios

Un rectángulo se define mediante su Width, Heighty la esquina superior izquierda representada por la propiedad Location.

Para dibujar rectángulos, necesita un objeto Graphics y un objeto Pen. El objeto Graphics proporciona el método DrawRectangle y el objeto Pen almacena 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 propiedades PageUnit y PageScale del objeto gráfico utilizado para dibujar. La unidad predeterminada es píxeles.

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

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

Constructores

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

Campos

Empty

Representa una estructura Rectangle con sus propiedades sin inicializar.

Propiedades

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

Métodos

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

Operadores

Equality(Rectangle, Rectangle)	Comprueba si dos estructuras Rectangle tienen la misma ubicación y tamaño.
Inequality(Rectangle, Rectangle)	Comprueba si dos estructuras Rectangle difieren en la ubicación o el tamaño.