Rectangle Structure

Définition

Espace de noms:

System.Drawing

Assembly:

System.Drawing.Primitives.dll

Source:

Rectangle.cs

Stocke un ensemble de quatre entiers qui représentent l’emplacement et la taille d’un rectangle.

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)

Héritage

Object

ValueType

Rectangle

Attributs

TypeConverterAttribute

Implémente

IEquatable<Rectangle>

Exemples

L’exemple suivant dessine un rectangle avec son angle supérieur gauche à (10, 10). Le rectangle a une largeur de 100 et une hauteur de 50. Le deuxième argument passé au constructeur Pen indique que la largeur du stylet est de 5 pixels.

Lorsque le rectangle est dessiné, le stylet est centré sur la limite du rectangle. Étant donné que la largeur du stylet est de 5, les côtés du rectangle sont dessinés de 5 pixels de large, de sorte que 1 pixel est dessiné sur la limite elle-même, 2 pixels sont dessinés à l’intérieur et 2 pixels sont dessinés à l’extérieur. Pour plus d’informations sur l’alignement du stylet, consultez How to : Set Pen Width and Alignment.

L’illustration suivante montre le rectangle obtenu. Les lignes en pointillés indiquent où le rectangle aurait été dessiné si la largeur du stylet avait été d’un pixel. La vue agrandie du coin supérieur gauche du rectangle montre que les lignes noires épaisses sont centrées sur ces lignes en pointillés.

L’exemple est conçu pour une utilisation avec Windows Forms et nécessite PaintEventArgse, qui est un paramètre du gestionnaire d’événements 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)

Remarques

Un rectangle est défini par son Width, son Heightet le coin supérieur gauche représenté par la propriété Location.

Pour dessiner des rectangles, vous avez besoin d’un objet Graphics et d’un objet Pen. L’objet Graphics fournit la méthode DrawRectangle, et l’objet Pen stocke les caractéristiques de la ligne, telles que la couleur et la largeur. Les unités dans laquelle le rectangle est dessiné sont déterminées par les propriétés PageUnit et PageScale de l’objet graphique utilisé pour le dessin. L’unité par défaut est pixels.

Pour dessiner un Rectangle rempli de couleurs, vous avez besoin d’un objet Graphics et d’un objet dérivé de Brush tels que SolidBrush ou LinearGradientBrush. L’objet Graphics fournit la méthode FillRectangle et l’objet Brush fournit les informations de couleur et de remplissage.

Pour des formes plus avancées, utilisez un objet Region.

Constructeurs

Rectangle(Int32, Int32, Int32, Int32)	Initialise une nouvelle instance de la classe Rectangle avec l’emplacement et la taille spécifiés.
Rectangle(Point, Size)	Initialise une nouvelle instance de la classe Rectangle avec l’emplacement et la taille spécifiés.

Champs

Empty

Représente une structure Rectangle avec ses propriétés laissées non initialisées.

Propriétés

Bottom	Obtient la coordonnée y qui correspond à la somme des valeurs de propriété Y et Height de cette structure Rectangle.
Height	Obtient ou définit la hauteur de cette structure Rectangle.
IsEmpty	Teste si toutes les propriétés numériques de cette Rectangle ont des valeurs de zéro.
Left	Obtient la coordonnée x du bord gauche de cette structure Rectangle.
Location	Obtient ou définit les coordonnées du coin supérieur gauche de cette structure Rectangle.
Right	Obtient la coordonnée x qui correspond à la somme de X et Width valeurs de propriété de cette structure Rectangle.
Size	Obtient ou définit la taille de cette Rectangle.
Top	Obtient la coordonnée y du bord supérieur de cette structure Rectangle.
Width	Obtient ou définit la largeur de cette structure Rectangle.
X	Obtient ou définit la coordonnée x du coin supérieur gauche de cette structure Rectangle.
Y	Obtient ou définit la coordonnée y du coin supérieur gauche de cette structure Rectangle.

Méthodes

Ceiling(RectangleF)	Convertit la structure RectangleF spécifiée en structure Rectangle en arrondissant les valeurs RectangleF aux valeurs entières supérieures suivantes.
Contains(Int32, Int32)	Détermine si le point spécifié est contenu dans cette structure Rectangle.
Contains(Point)	Détermine si le point spécifié est contenu dans cette structure Rectangle.
Contains(Rectangle)	Détermine si la région rectangulaire représentée par rect est entièrement contenue dans cette structure Rectangle.
Equals(Object)	Teste si obj est une structure Rectangle avec le même emplacement et la même taille de cette structure Rectangle.
Equals(Rectangle)	Indique si l’objet actuel est égal à un autre objet du même type.
FromLTRB(Int32, Int32, Int32, Int32)	Crée une structure Rectangle avec les emplacements de périphérie spécifiés.
GetHashCode()	Retourne le code de hachage de cette structure Rectangle. Pour plus d’informations sur l’utilisation de codes de hachage, consultez GetHashCode() .
Inflate(Int32, Int32)	Agrandit cette Rectangle par le montant spécifié.
Inflate(Rectangle, Int32, Int32)	Crée et retourne une copie agrandie de la structure Rectangle spécifiée. La copie est agrandie par la quantité spécifiée. La structure Rectangle d’origine reste non modifiée.
Inflate(Size)	Agrandit cette Rectangle par le montant spécifié.
Intersect(Rectangle)	Remplace cette Rectangle par l’intersection de lui-même et de la Rectanglespécifiée.
Intersect(Rectangle, Rectangle)	Retourne une troisième structure Rectangle qui représente l’intersection de deux autres structures Rectangle. S’il n’y a pas d’intersection, une Rectangle vide est retournée.
IntersectsWith(Rectangle)	Détermine si ce rectangle se croise avec rect.
Offset(Int32, Int32)	Ajuste l’emplacement de ce rectangle par la quantité spécifiée.
Offset(Point)	Ajuste l’emplacement de ce rectangle par la quantité spécifiée.
Round(RectangleF)	Convertit le RectangleF spécifié en Rectangle en arrondissant les valeurs RectangleF aux valeurs entières les plus proches.
ToString()	Convertit les attributs de cette Rectangle en chaîne lisible par l’homme.
Truncate(RectangleF)	Convertit le RectangleF spécifié en Rectangle en tronquant les valeurs de RectangleF.
Union(Rectangle, Rectangle)	Obtient une structure Rectangle qui contient l’union de deux structures Rectangle.

Opérateurs

Equality(Rectangle, Rectangle)	Teste si deux structures Rectangle ont un emplacement et une taille égales.
Inequality(Rectangle, Rectangle)	Teste si deux structures Rectangle diffèrent selon l’emplacement ou la taille.