Rectangle Structure

Définition

Stocke un ensemble de quatre entiers représentant l’emplacement et la taille d’un rectangle.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)
Héritage
Rectangle
Attributs
Implémente

Exemples

L’exemple suivant dessine un rectangle avec son angle supérieur gauche à (10, 10).The following example draws a rectangle with its upper-left corner at (10, 10). Le rectangle a une largeur de 100 et une hauteur de 50.The rectangle has a width of 100 and a height of 50. Le deuxième argument passé au constructeur Pen indique que la largeur du stylet est de 5 pixels.The second argument passed to the Pen constructor indicates that the pen width is 5 pixels.

Lorsque le rectangle est dessiné, le stylet est centré sur la limite du rectangle.When the rectangle is drawn, the pen is centered on the rectangle's boundary. Étant donné que la largeur du stylet est de 5, les côtés du rectangle sont dessinés à 5 pixels de large, ce qui fait que 1 pixel est dessiné sur la limite elle-même, 2 pixels sont dessinés à l’intérieur et 2 pixels à l’extérieur.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. Pour plus d’informations sur l’alignement du stylet, consultez How à : Définissez la largeur et l’alignement du stylet sur0.For more details on pen alignment, see How to: Set Pen Width and Alignment.

L’illustration suivante montre le rectangle résultant.The following illustration shows the resulting rectangle. Les lignes en pointillés indiquent où le rectangle aurait été dessiné si la largeur du stylet avait été d’un pixel.The dotted lines show where the rectangle would have been drawn if the pen width had been one pixel. La vue agrandie de l’angle supérieur gauche du rectangle montre que les lignes noires épaisses sont centrées sur ces lignes en pointillés.The enlarged view of the upper-left corner of the rectangle shows that the thick black lines are centered on those dotted lines.

InjectionPens

L’exemple est conçu pour être utilisé avec Windows Forms et requiert PaintEventArgs e, qui est un paramètre du gestionnaire d’événements Paint.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)

Remarques

Un rectangle est défini par son Width, Height et l’angle supérieur gauche représenté par la propriété Location.A rectangle is defined by its Width, Height, and upper-left corner represented by the Location property.

Pour dessiner des rectangles, vous avez besoin d’un objet Graphics et d’un objet Pen.To draw rectangles, you need a Graphics object and a Pen object. L’objet Graphics fournit la méthode DrawRectangle, et l’objet Pen stocke les fonctionnalités de la ligne, telles que la couleur et la largeur.The Graphics object provides the DrawRectangle method, and the Pen object stores features of the line, such as color and width. Les unités dans lesquelles le rectangle est dessiné sont déterminées par les propriétés PageUnit et PageScale de l’objet Graphics utilisé pour le dessin.The units the rectangle is drawn in is determined by the PageUnit and PageScale properties of the graphics object used for drawing. L’unité par défaut est pixels.The default unit is pixels.

Pour dessiner un Rectangle rempli avec la couleur, vous avez besoin d’un objet Graphics et d’un objet dérivé de Brush, comme SolidBrush ou LinearGradientBrush.To draw a Rectangle filled with color, you need a Graphics object and an object derived from Brush such as SolidBrush or LinearGradientBrush. L’objet Graphics fournit la méthode FillRectangle et l’objet Brush fournit les informations de couleur et de remplissage.The Graphics object provides the FillRectangle method and the Brush object provides the color and fill information.

Pour les formes plus avancées, utilisez un objet Region.For more advanced shapes, use a Region object.

Constructeurs

Rectangle(Int32, Int32, Int32, Int32)

Initialise une nouvelle instance de la classe Rectangle avec l'emplacement et la taille spécifiés.Initializes a new instance of the Rectangle class with the specified location and size.

Rectangle(Point, Size)

Initialise une nouvelle instance de la classe Rectangle avec l'emplacement et la taille spécifiés.Initializes a new instance of the Rectangle class with the specified location and size.

Champs

Empty

Représente une structure Rectangle dont les propriétés sont laissées non initialisées.Represents a Rectangle structure with its properties left uninitialized.

Propriétés

Bottom

Obtient la coordonnée y qui est la somme des valeurs de propriété Y et Height de cette structure Rectangle.Gets the y-coordinate that is the sum of the Y and Height property values of this Rectangle structure.

Height

Obtient ou définit la hauteur de cette structure Rectangle.Gets or sets the height of this Rectangle structure.

IsEmpty

Teste si toutes les propriétés numériques de ce Rectangle ont des valeurs nulles.Tests whether all numeric properties of this Rectangle have values of zero.

Left

Obtient la coordonnée x du bord gauche de cette structure Rectangle.Gets the x-coordinate of the left edge of this Rectangle structure.

Location

Obtient ou définit les coordonnées de l'angle supérieur gauche de cette structure Rectangle.Gets or sets the coordinates of the upper-left corner of this Rectangle structure.

Right

Obtient la coordonnée x qui est la somme des valeurs de propriété X et Width de cette structure Rectangle.Gets the x-coordinate that is the sum of X and Width property values of this Rectangle structure.

Size

Obtient ou définit la taille de ce Rectangle.Gets or sets the size of this Rectangle.

Top

Obtient la coordonnée y du bord supérieur de cette structure Rectangle.Gets the y-coordinate of the top edge of this Rectangle structure.

Width

Obtient ou définit la largeur de cette structure Rectangle.Gets or sets the width of this Rectangle structure.

X

Obtient ou définit la coordonnée x de l'angle supérieur gauche de cette structure Rectangle.Gets or sets the x-coordinate of the upper-left corner of this Rectangle structure.

Y

Obtient ou définit la coordonnée y de l'angle supérieur gauche de cette structure Rectangle.Gets or sets the y-coordinate of the upper-left corner of this Rectangle structure.

Méthodes

Ceiling(RectangleF)

Convertit la structure RectangleF spécifiée en structure Rectangle en arrondissant les valeurs de l'objet RectangleF aux valeurs entières supérieures.Converts the specified RectangleF structure to a Rectangle structure by rounding the RectangleF values to the next higher integer values.

Contains(Int32, Int32)

Détermine si le point spécifié est contenu dans cette structure Rectangle.Determines if the specified point is contained within this Rectangle structure.

Contains(Point)

Détermine si le point spécifié est contenu dans cette structure Rectangle.Determines if the specified point is contained within this Rectangle structure.

Contains(Rectangle)

Détermine si la zone rectangulaire représentée par rect est entièrement contenue dans cette structure Rectangle.Determines if the rectangular region represented by rect is entirely contained within this Rectangle structure.

Equals(Object)

Teste si obj est une structure Rectangle avec le même emplacement et la même taille que cette structure Rectangle.Tests whether obj is a Rectangle structure with the same location and size of this Rectangle structure.

Equals(Rectangle)
FromLTRB(Int32, Int32, Int32, Int32)

Crée une structure Rectangle avec les emplacements de bords spécifiés.Creates a Rectangle structure with the specified edge locations.

GetHashCode()

Retourne le code de hachage pour cette structure Rectangle.Returns the hash code for this Rectangle structure. Pour plus d'informations sur l'utilisation des codes de hachage, consultez GetHashCode().For information about the use of hash codes, see GetHashCode() .

Inflate(Int32, Int32)

Agrandit ce Rectangle de la valeur spécifiée.Enlarges this Rectangle by the specified amount.

Inflate(Rectangle, Int32, Int32)

Crée et retourne une copie agrandie de la structure Rectangle spécifiée.Creates and returns an enlarged copy of the specified Rectangle structure. La copie est agrandie de la valeur spécifiée.The copy is enlarged by the specified amount. La structure Rectangle d'origine reste inchangée.The original Rectangle structure remains unmodified.

Inflate(Size)

Agrandit ce Rectangle de la valeur spécifiée.Enlarges this Rectangle by the specified amount.

Intersect(Rectangle)

Remplace ce Rectangle par l'intersection entre celui-ci et le Rectangle spécifié.Replaces this Rectangle with the intersection of itself and the specified Rectangle.

Intersect(Rectangle, Rectangle)

Retourne une troisième structure Rectangle qui représente l'intersection de deux autres structures Rectangle.Returns a third Rectangle structure that represents the intersection of two other Rectangle structures. En l'absence d'intersection, un Rectangle vide est retourné.If there is no intersection, an empty Rectangle is returned.

IntersectsWith(Rectangle)

Détermine si ce rectangle croise rect.Determines if this rectangle intersects with rect.

Offset(Int32, Int32)

Ajuste l'emplacement de ce rectangle en fonction de la valeur spécifiée.Adjusts the location of this rectangle by the specified amount.

Offset(Point)

Ajuste l'emplacement de ce rectangle en fonction de la valeur spécifiée.Adjusts the location of this rectangle by the specified amount.

Round(RectangleF)

Convertit le RectangleF spécifié en Rectangle en arrondissant les valeurs de RectangleF aux valeurs entières les plus proches.Converts the specified RectangleF to a Rectangle by rounding the RectangleF values to the nearest integer values.

ToString()

Convertit les attributs de ce Rectangle en chaîne explicite.Converts the attributes of this Rectangle to a human-readable string.

Truncate(RectangleF)

Convertit le RectangleF spécifié en Rectangle en tronquant les valeurs RectangleF.Converts the specified RectangleF to a Rectangle by truncating the RectangleF values.

Union(Rectangle, Rectangle)

Obtient une structure Rectangle qui contient l'union de deux structures Rectangle.Gets a Rectangle structure that contains the union of two Rectangle structures.

Opérateurs

Equality(Rectangle, Rectangle)

Teste si deux structures Rectangle ont le même emplacement et la même taille.Tests whether two Rectangle structures have equal location and size.

Inequality(Rectangle, Rectangle)

Teste si deux structures Rectangle ont un emplacement et une taille différents.Tests whether two Rectangle structures differ in location or size.

S’applique à