Rectangle Struktur

Definition

Namespace:

System.Drawing

Assemblys:

netstandard.dll, System.Drawing.Primitives.dll

Quelle:

Rectangle.cs

Speichert einen Satz von vier ganzzahligen Zahlen, die die Position und Größe eines Rechtecks darstellen.

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)

Vererbung

Object

ValueType

Rectangle

Attribute

TypeConverterAttribute

Implementiert

IEquatable<Rectangle>

Beispiele

Das folgende Beispiel zeichnet ein Rechteck mit seiner oberen linken Ecke (10, 10). Das Rechteck hat eine Breite von 100 und eine Höhe von 50. Das zweite Argument, das an den Pen Konstruktor übergeben wird, gibt an, dass die Stiftbreite 5 Pixel beträgt.

Wenn das Rechteck gezeichnet wird, wird der Stift auf der Begrenzung des Rechtecks zentriert. Da die Stiftbreite 5 beträgt, werden die Seiten des Rechtecks 5 Pixel breit gezeichnet, sodass 1 Pixel auf der Begrenzung selbst gezeichnet werden, 2 Pixel auf der Innenseite gezeichnet werden und 2 Pixel auf der Außenseite gezeichnet werden. Weitere Informationen zur Stiftausrichtung finden Sie unter How to: Set Pen Width and Alignment.

Die folgende Abbildung zeigt das resultierende Rechteck. Die gepunkteten Linien zeigen, wo das Rechteck gezeichnet worden wäre, wenn die Stiftbreite ein Pixel gewesen wäre. Die vergrößerte Ansicht der oberen linken Ecke des Rechtecks zeigt, dass die dicken schwarzen Linien auf diesen gepunkteten Linien zentriert sind.

Das Beispiel wurde für die Verwendung mit Windows Forms entwickelt und erfordert PaintEventArgseeinen Parameter des Paint Ereignishandlers.

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)

Hinweise

Ein Rechteck wird durch seine Width, Heightund obere linke Ecke definiert, die durch die Location Eigenschaft dargestellt wird.

Zum Zeichnen von Rechtecke benötigen Sie ein Graphics Objekt und ein Pen Objekt. Das Graphics Objekt stellt die DrawRectangle Methode bereit, und das Pen Objekt speichert Features der Linie, z. B. Farbe und Breite. Die Einheiten, in die das Rechteck gezeichnet wird, wird durch die PageUnit Eigenschaften PageScale des grafikobjekts bestimmt, das für die Zeichnung verwendet wird. Die Standardeinheit ist Pixel.

Um eine Rectangle gefüllte Farbe zu zeichnen, benötigen Sie ein Graphics Objekt und ein Objekt, das von Brush solchen SolidBrush abgeleitet ist.LinearGradientBrush Das Graphics Objekt stellt die FillRectangle Methode bereit, und das Brush Objekt stellt die Farb- und Füllinformationen bereit.

Verwenden Sie für erweiterte Shapes ein Region Objekt.

Konstruktoren

Name	Beschreibung
Rectangle(Int32, Int32, Int32, Int32)	Initialisiert eine neue Instanz der Rectangle Klasse mit der angegebenen Position und Größe.
Rectangle(Point, Size)	Initialisiert eine neue Instanz der Rectangle Klasse mit der angegebenen Position und Größe.

Felder

Name	Beschreibung
Empty	Stellt eine Rectangle Struktur dar, deren Eigenschaften nicht initialisiert bleiben.

Eigenschaften

Name	Beschreibung
Bottom	Ruft die y-Koordinate ab, die die Summe der Y Werte und Height Eigenschaften dieser Rectangle Struktur darstellt.
Height	Ruft die Höhe dieser Rectangle Struktur ab oder legt sie fest.
IsEmpty	Überprüft, ob alle numerischen Eigenschaften dieser Rectangle Eigenschaft Nullwerte aufweisen.
Left	Ruft die x-Koordinate des linken Rands dieser Rectangle Struktur ab.
Location	Ruft die Koordinaten der oberen linken Ecke dieser Rectangle Struktur ab oder legt sie fest.
Right	Ruft die x-Koordinate ab, die die Summe und XWidth Eigenschaftswerte dieser Rectangle Struktur ist.
Size	Dient zum Abrufen oder Festlegen der Größe dieses Werts Rectangle.
Top	Ruft die y-Koordinate des oberen Rands dieser Rectangle Struktur ab.
Width	Ruft die Breite dieser Rectangle Struktur ab oder legt sie fest.
X	Ruft die x-Koordinate der oberen linken Ecke dieser Struktur ab oder legt sie Rectangle fest.
Y	Ruft die y-Koordinate der oberen linken Ecke dieser Rectangle Struktur ab oder legt sie fest.

Methoden

Name	Beschreibung
Ceiling(RectangleF)	Konvertiert die angegebene RectangleF Struktur in eine Rectangle Struktur, indem die RectangleF Werte auf die nächsten höheren ganzzahligen Werte gerundet werden.
Contains(Int32, Int32)	Bestimmt, ob der angegebene Punkt in dieser Rectangle Struktur enthalten ist.
Contains(Point)	Bestimmt, ob der angegebene Punkt in dieser Rectangle Struktur enthalten ist.
Contains(Rectangle)	Bestimmt, ob der durch diese Rectangle Struktur dargestellte rect rechteckige Bereich vollständig enthalten ist.
Equals(Object)	Überprüft, ob obj es sich um eine Rectangle Struktur mit derselben Position und Größe dieser Rectangle Struktur handelt.
Equals(Rectangle)	Gibt an, ob das aktuelle Objekt einem anderen Objekt desselben Typs entspricht.
FromLTRB(Int32, Int32, Int32, Int32)	Erstellt eine Rectangle Struktur mit den angegebenen Randpositionen.
GetHashCode()	Gibt den Hashcode für diese Rectangle Struktur zurück. Informationen zur Verwendung von Hashcodes finden Sie unter GetHashCode() .
Inflate(Int32, Int32)	Vergrößert dies Rectangle um den angegebenen Betrag.
Inflate(Rectangle, Int32, Int32)	Erstellt und gibt eine vergrößerte Kopie der angegebenen Rectangle Struktur zurück. Die Kopie wird um den angegebenen Betrag vergrößert. Die ursprüngliche Rectangle Struktur bleibt unverändert.
Inflate(Size)	Vergrößert dies Rectangle um den angegebenen Betrag.
Intersect(Rectangle, Rectangle)	Gibt eine dritte Rectangle Struktur zurück, die die Schnittmenge zweier anderer Rectangle Strukturen darstellt. Wenn keine Schnittmenge vorhanden ist, wird ein leerer Rectangle Wert zurückgegeben.
Intersect(Rectangle)	Ersetzt dies Rectangle durch die Schnittmenge von sich selbst und den angegebenen Rectangle.
IntersectsWith(Rectangle)	Bestimmt, ob sich dieses Rechteck mit rect.
Offset(Int32, Int32)	Passt die Position dieses Rechtecks um den angegebenen Betrag an.
Offset(Point)	Passt die Position dieses Rechtecks um den angegebenen Betrag an.
Round(RectangleF)	Konvertiert den angegebenen RectangleF Wert in ein Rectangle , indem die RectangleF Werte auf die nächsten ganzzahligen Werte gerundet werden.
ToString()	Wandelt die Attribute dieser Rectangle Zeichenfolge in eine lesbare Zeichenfolge um.
Truncate(RectangleF)	Wandelt den angegebenen RectangleF Wert in ein Rectangle , indem die RectangleF Werte abgeschnitten werden.
Union(Rectangle, Rectangle)	Ruft eine Rectangle Struktur ab, die die Vereinigung zweier Rectangle Strukturen enthält.

Operatoren

Name	Beschreibung
Equality(Rectangle, Rectangle)	Testet, ob zwei Rectangle Strukturen gleich Position und Größe aufweisen.
Inequality(Rectangle, Rectangle)	Testet, ob zwei Rectangle Strukturen an Position oder Größe unterschiedlich sind.