Rectangle Structure

Définition

Espace de noms:

System.Drawing

Assemblys:

netstandard.dll, 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 Pen constructeur 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 Guide pratique pour définir la largeur et l’alignement du stylet.

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 Paint gestionnaire d’événements.

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 Widthangle supérieur Heightgauche représenté par la Location propriété.

Pour dessiner des rectangles, vous avez besoin d’un Graphics objet et d’un Pen objet. L’objet Graphics fournit la DrawRectangle méthode 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és par les PageUnit propriétés de PageScale l’objet graphique utilisé pour le dessin. L’unité par défaut est pixels.

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

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

Constructeurs

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

Champs

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

Propriétés

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

Méthodes

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

Opérateurs

Nom	Description
Equality(Rectangle, Rectangle)	Teste si deux Rectangle structures ont un emplacement et une taille égales.
Inequality(Rectangle, Rectangle)	Teste si deux Rectangle structures diffèrent en emplacement ou en taille.