Rectangle Struct

Definición

Almacena un conjunto de cuatro enteros que representan la posición y el tamaño de un rectángulo. Stores a set of four integers that represent the location and size of a rectangle

[System.ComponentModel.TypeConverter(typeof(System.Drawing.RectangleConverter))]
[System.Runtime.InteropServices.ComVisible(true)]
public struct Rectangle
Herencia
Rectangle
Atributos

Ejemplos

En el ejemplo siguiente se dibuja un rectángulo con la esquina superior izquierda en (10, 10).The following example draws a rectangle with its upper-left corner at (10, 10). El rectángulo tiene un ancho de 100 y un alto de 50.The rectangle has a width of 100 and a height of 50. El segundo argumento pasado a la Pen constructor indica que el ancho del lápiz es 5 píxeles.The second argument passed to the Pen constructor indicates that the pen width is 5 pixels.

Cuando se dibuja el rectángulo, el lápiz está centrado en el límite del rectángulo.When the rectangle is drawn, the pen is centered on the rectangle's boundary. Dado que el ancho del lápiz es 5, los lados del rectángulo son 5 píxeles amplia, de modo que 1 píxel se dibuja en el límite, se dibujan 2 píxeles dentro y 2 píxeles se dibujan en el exterior.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 obtener más detalles sobre la alineación del lápiz, consulte Cómo: establecer el ancho del lápiz y la alineación.For more details on pen alignment, see How to: Set Pen Width and Alignment.

La siguiente ilustración muestra el rectángulo resultante.The following illustration shows the resulting rectangle. Las líneas de puntos muestran donde hubiera dibujado el rectángulo si el ancho del lápiz hubiera sido un píxel.The dotted lines show where the rectangle would have been drawn if the pen width had been one pixel. La vista ampliada de la esquina superior izquierda del rectángulo muestra que las líneas negras gruesas se centran en las líneas de puntos.The enlarged view of the upper-left corner of the rectangle shows that the thick black lines are centered on those dotted lines.

LápicesPens

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

Comentarios

Un rectángulo se define por su Width, Heighty la esquina superior izquierda representado por la Location propiedad.A rectangle is defined by its Width, Height, and upper-left corner represented by the Location property.

Para dibujar rectángulos, necesita un Graphics objeto y un Pen objeto.To draw rectangles, you need a Graphics object and a Pen object. El Graphics objeto proporciona el DrawRectangle método y el Pen objeto almacena las características de la línea, como el color y ancho.The Graphics object provides the DrawRectangle method, and the Pen object stores features of the line, such as color and width. Las unidades se dibuja el rectángulo en viene determinada por la PageUnit y PageScale las propiedades de los gráficos de objeto utilizado para dibujar.The units the rectangle is drawn in is determined by the PageUnit and PageScale properties of the graphics object used for drawing. La unidad predeterminada es píxeles.The default unit is pixels.

Para dibujar un Rectangle relleno con color, necesita un Graphics objeto y un objeto derivan de Brush como SolidBrush o LinearGradientBrush.To draw a Rectangle filled with color, you need a Graphics object and an object derived from Brush such as SolidBrush or LinearGradientBrush. El Graphics objeto proporciona el FillRectangle método y el Brush objeto proporciona la información de color y relleno.The Graphics object provides the FillRectangle method and the Brush object provides the color and fill information.

Para las formas más avanzadas, utilice un Region objeto.For more advanced shapes, use a Region object.

Constructores

Rectangle(Point, Size)

Inicializa una nueva instancia de la clase Rectangle con la ubicación y el tamaño especificados. Initializes a new instance of the Rectangle class with the specified location and size.

Rectangle(Int32, Int32, Int32, Int32)

Inicializa una nueva instancia de la clase Rectangle con la ubicación y el tamaño especificados. Initializes a new instance of the Rectangle class with the specified location and size.

Campos

Empty

Representa una estructura Rectangle con las propiedades sin inicializar. Represents a Rectangle structure with its properties left uninitialized.

Propiedades

Bottom

Obtiene la coordenada Y que es la suma de los valores de las propiedades Y y Height de esta estructura Rectangle. Gets the y-coordinate that is the sum of the Y and Height property values of this Rectangle structure.

Height

Obtiene o establece el alto de esta estructura Rectangle. Gets or sets the height of this Rectangle structure.

IsEmpty

Comprueba si todas las propiedades numéricas de este Rectangle tienen valores cero. Tests whether all numeric properties of this Rectangle have values of zero.

Left

Obtiene la coordenada X del borde izquierdo de esta estructura Rectangle. Gets the x-coordinate of the left edge of this Rectangle structure.

Location

Obtiene o establece las coordenadas de la esquina superior izquierda de esta estructura Rectangle. Gets or sets the coordinates of the upper-left corner of this Rectangle structure.

Right

Obtiene la coordenada X que es la suma de los valores de las propiedades X y Width de esta estructura Rectangle. Gets the x-coordinate that is the sum of X and Width property values of this Rectangle structure.

Size

Obtiene o establece el tamaño de este Rectangle. Gets or sets the size of this Rectangle.

Top

Obtiene la coordenada Y del borde superior de esta estructura Rectangle. Gets the y-coordinate of the top edge of this Rectangle structure.

Width

Obtiene o establece el ancho de esta estructura Rectangle. Gets or sets the width of this Rectangle structure.

X

Obtiene o establece la coordenada X de la esquina superior izquierda de esta estructura Rectangle. Gets or sets the x-coordinate of the upper-left corner of this Rectangle structure.

Y

Obtiene o establece la coordenada Y de la esquina superior izquierda de esta estructura Rectangle. Gets or sets the y-coordinate of the upper-left corner of this Rectangle structure.

Métodos

Ceiling(RectangleF)

Convierte la estructura RectangleF especificada en una estructura Rectangle redondeando los valores de RectangleF a los valores enteros superiores siguientes. Converts the specified RectangleF structure to a Rectangle structure by rounding the RectangleF values to the next higher integer values.

Contains(Point)

Determina si el punto especificado está dentro de esta estructura de Rectangle. Determines if the specified point is contained within this Rectangle structure.

Contains(Rectangle)

Determina si la región rectangular que representa rect está totalmente dentro de esta estructura Rectangle. Determines if the rectangular region represented by rect is entirely contained within this Rectangle structure.

Contains(Int32, Int32)

Determina si el punto especificado está dentro de esta estructura de Rectangle. Determines if the specified point is contained within this Rectangle structure.

Equals(Rectangle)
Equals(Object)

Comprueba si obj es una estructura Rectangle con la misma ubicación y el mismo tamaño que esta estructura Rectangle. Tests whether obj is a Rectangle structure with the same location and size of this Rectangle structure.

FromLTRB(Int32, Int32, Int32, Int32)

Crea una estructura Rectangle con las ubicaciones de los bordes especificadas. Creates a Rectangle structure with the specified edge locations.

GetHashCode()

Devuelve el código hash de esta estructura Rectangle. Returns the hash code for this Rectangle structure. Para obtener información acerca del uso de códigos hash, vea GetHashCode(). For information about the use of hash codes, see GetHashCode() .

Inflate(Size)

Aumenta este Rectangle en la cantidad especificada. Enlarges this Rectangle by the specified amount.

Inflate(Int32, Int32)

Aumenta este Rectangle en la cantidad especificada. Enlarges this Rectangle by the specified amount.

Inflate(Rectangle, Int32, Int32)

Crea y devuelve una copia aumentada de la estructura Rectangle especificada. Creates and returns an enlarged copy of the specified Rectangle structure. La copia se aumenta en la cantidad especificada. The copy is enlarged by the specified amount. La estructura Rectangle original no cambia. The original Rectangle structure remains unmodified.

Intersect(Rectangle, Rectangle)

Devuelve una tercera estructura Rectangle que representa la intersección de otras dos estructuras Rectangle. Returns a third Rectangle structure that represents the intersection of two other Rectangle structures. Si no hay intersección, se devuelve un Rectangle vacío. If there is no intersection, an empty Rectangle is returned.

Intersect(Rectangle)

Reemplaza Rectangle con la intersección entre él mismo y el elemento Rectangle especificado. Replaces this Rectangle with the intersection of itself and the specified Rectangle.

IntersectsWith(Rectangle)

Determina si este rectángulo tiene una intersección con rect. Determines if this rectangle intersects with rect.

Offset(Point)

Ajusta la ubicación de este rectángulo en la cantidad especificada. Adjusts the location of this rectangle by the specified amount.

Offset(Int32, Int32)

Ajusta la ubicación de este rectángulo en la cantidad especificada. Adjusts the location of this rectangle by the specified amount.

Round(RectangleF)

Convierte el RectangleF especificado en un Rectangle redondeando los valores RectangleF a los valores enteros más cercanos. Converts the specified RectangleF to a Rectangle by rounding the RectangleF values to the nearest integer values.

ToString()

Convierte los atributos de este Rectangle en una cadena legible. Converts the attributes of this Rectangle to a human-readable string.

Truncate(RectangleF)

Convierte el RectangleF especificado en un Rectangle mediante el truncamiento de los valores RectangleF. Converts the specified RectangleF to a Rectangle by truncating the RectangleF values.

Union(Rectangle, Rectangle)

Obtiene una estructura Rectangle que contiene la intersección de dos estructuras Rectangle. Gets a Rectangle structure that contains the union of two Rectangle structures.

Operadores

Equality(Rectangle, Rectangle)

Comprueba si dos estructuras Rectangle tienen la misma ubicación y el mismo tamaño. Tests whether two Rectangle structures have equal location and size.

Inequality(Rectangle, Rectangle)

Comprueba si dos estructuras Rectangle tienen una ubicación o un tamaño diferentes. Tests whether two Rectangle structures differ in location or size.

Se aplica a