Rectangle Rectangle Rectangle 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

public value class Rectangle : IEquatable<System::Drawing::Rectangle>
[System.ComponentModel.TypeConverter(typeof(System.Drawing.RectangleConverter))]
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public struct Rectangle : IEquatable<System.Drawing.Rectangle>
type Rectangle = struct
Public Structure Rectangle
Implements IEquatable(Of Rectangle)
Herencia
Atributos
Implementaciones

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 que se pasa Pen al constructor indica que el ancho del lápiz es de 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 se centra 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 se dibujan en 5 píxeles de ancho, de modo que 1 píxel se dibuja en el límite, se dibujan 2 píxeles en el interior y se dibujan 2 píxeles 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 información sobre la alineación del lápiz, consulte Cómo: Establecer el ancho y laalineación del lápiz.For more details on pen alignment, see How to: Set Pen Width and Alignment.

En la ilustración siguiente se muestra el rectángulo resultante.The following illustration shows the resulting rectangle. Las líneas de puntos muestran dónde se habría 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 esas 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.

BolígrafosPens

El ejemplo está diseñado para su uso con Windows Forms y requiere PaintEventArgs e, que Paint es un parámetro del 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 Heightesquina superior izquierda representada 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 objeto Pen almacena características de la línea, como el color y el ancho.The Graphics object provides the DrawRectangle method, and the Pen object stores features of the line, such as color and width. Las unidades en las que se dibuja el rectángulo se determinan mediante las PageUnit propiedades y PageScale del objeto Graphics que se usa 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 color relleno, necesita un Graphics objeto y un objeto derivado 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, use Region un objeto.For more advanced shapes, use a Region object.

Constructores

Rectangle(Point, Size) Rectangle(Point, Size) Rectangle(Point, Size) 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) Rectangle(Int32, Int32, Int32, Int32) Rectangle(Int32, Int32, Int32, Int32) 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 Empty Empty Empty

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

Propiedades

Bottom Bottom Bottom 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 Height Height Height

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

IsEmpty IsEmpty IsEmpty 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 Left Left 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 Location Location 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 Right Right 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 Size Size Size

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

Top Top Top 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 Width Width Width

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

X X X 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 Y Y 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) Ceiling(RectangleF) Ceiling(RectangleF) 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) Contains(Point) Contains(Point) 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) Contains(Rectangle) Contains(Rectangle) 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) Contains(Int32, Int32) Contains(Int32, Int32) 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(Rectangle) Equals(Rectangle) Equals(Rectangle)
Equals(Object) Equals(Object) Equals(Object) 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) FromLTRB(Int32, Int32, Int32, Int32) FromLTRB(Int32, Int32, Int32, Int32) 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() GetHashCode() GetHashCode() 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) Inflate(Size) Inflate(Size) Inflate(Size)

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

Inflate(Int32, Int32) Inflate(Int32, Int32) Inflate(Int32, Int32) Inflate(Int32, Int32)

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

Inflate(Rectangle, Int32, Int32) Inflate(Rectangle, Int32, Int32) Inflate(Rectangle, Int32, Int32) 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) Intersect(Rectangle, Rectangle) Intersect(Rectangle, Rectangle) 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) Intersect(Rectangle) Intersect(Rectangle) 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) IntersectsWith(Rectangle) IntersectsWith(Rectangle) IntersectsWith(Rectangle)

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

Offset(Point) Offset(Point) Offset(Point) 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) Offset(Int32, Int32) Offset(Int32, Int32) 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) Round(RectangleF) Round(RectangleF) 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() ToString() ToString() ToString()

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

Truncate(RectangleF) Truncate(RectangleF) Truncate(RectangleF) 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) Union(Rectangle, Rectangle) Union(Rectangle, Rectangle) 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) Equality(Rectangle, Rectangle) Equality(Rectangle, Rectangle) 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) Inequality(Rectangle, Rectangle) Inequality(Rectangle, Rectangle) 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