Rectangle Estructura

Definición

Almacena un conjunto de cuatro enteros que representan la posición y el tamaño de un rectá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
Herencia
Rectangle
Atributos
Implementaciones

Ejemplos

En el ejemplo siguiente se dibuja un rectángulo con la 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 con 5 píxeles de ancho, de modo que 1 píxel se dibuja en el propio límite, 2 píxeles se dibujan 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 Procedimiento para establecer el ancho y la alineación del lápiz.

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 están centradas en esas líneas de puntos.

Lápices

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 WidthHeightesquina superior izquierda , y representada por la Location propiedad .

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 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 por las PageUnit propiedades y PageScale del objeto gráfico utilizado para dibujar. La unidad predeterminada es píxeles.

Para dibujar un Rectangle objeto lleno 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

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 las propiedades sin inicializar.

Propiedades

Bottom

Obtiene la coordenada Y que es la suma de los valores de las propiedades Y y Height de esta estructura Rectangle.

Height

Obtiene o establece el alto de esta estructura Rectangle.

IsEmpty

Comprueba si todas las propiedades numéricas de este Rectangle tienen valores 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 los valores de las propiedades X y Width de esta estructura 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 Rectangle.

Y

Obtiene o establece la coordenada Y de la esquina superior izquierda de esta estructura Rectangle.

Métodos

Ceiling(RectangleF)

Convierte la estructura RectangleF especificada en una estructura Rectangle redondeando los valores de RectangleF a los valores enteros superiores siguientes.

Contains(Int32, Int32)

Determina si el punto especificado está dentro de esta estructura de Rectangle.

Contains(Point)

Determina si el punto especificado está dentro de esta estructura de Rectangle.

Contains(Rectangle)

Determina si la región rectangular que representa rect está totalmente dentro de esta estructura Rectangle.

Equals(Object)

Comprueba si obj es una estructura Rectangle con la misma ubicación y el mismo tamaño que esta estructura Rectangle.

Equals(Rectangle)

Indica si el objeto actual es igual que otro objeto del mismo tipo.

FromLTRB(Int32, Int32, Int32, Int32)

Crea una estructura Rectangle con las ubicaciones de los bordes especificadas.

GetHashCode()

Devuelve el código hash de esta estructura Rectangle. Para obtener información acerca del uso de códigos hash, vea GetHashCode().

Inflate(Int32, Int32)

Aumenta este Rectangle en la cantidad especificada.

Inflate(Rectangle, Int32, Int32)

Crea y devuelve una copia aumentada de la estructura Rectangle especificada. La copia se aumenta en la cantidad especificada. La estructura Rectangle original no cambia.

Inflate(Size)

Aumenta este Rectangle en la cantidad especificada.

Intersect(Rectangle)

Reemplaza Rectangle con la intersección entre él mismo y el elemento Rectangle especificado.

Intersect(Rectangle, Rectangle)

Devuelve una tercera estructura Rectangle que representa la intersección de otras dos estructuras Rectangle. Si no hay intersección, se devuelve un Rectangle vacío.

IntersectsWith(Rectangle)

Determina si este rectángulo tiene una intersección con rect.

Offset(Int32, Int32)

Ajusta la ubicación de este rectángulo en la cantidad especificada.

Offset(Point)

Ajusta la ubicación de este rectángulo en la cantidad especificada.

Round(RectangleF)

Convierte el RectangleF especificado en un Rectangle redondeando los valores 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 mediante el truncamiento de los valores RectangleF.

Union(Rectangle, Rectangle)

Obtiene una estructura Rectangle que contiene la intersección de dos estructuras Rectangle.

Operadores

Equality(Rectangle, Rectangle)

Comprueba si dos estructuras Rectangle tienen la misma ubicación y el mismo tamaño.

Inequality(Rectangle, Rectangle)

Comprueba si dos estructuras Rectangle tienen una ubicación o un tamaño diferentes.

Se aplica a