Rectangle Struktur
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Speichert einen Satz von vier ganzzahligen Zahlen, die die Position und Größe eines Rechtecks darstellen.
public value class Rectangle : IEquatable<System::Drawing::Rectangle>public value class 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>public struct Rectanglepublic struct Rectangle : IEquatable<System.Drawing.Rectangle>[System.ComponentModel.TypeConverter(typeof(System.Drawing.RectangleConverter))]
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public struct Rectangle[<System.ComponentModel.TypeConverter("System.Drawing.RectangleConverter, System.Drawing, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
type Rectangle = structtype Rectangle = struct[<System.ComponentModel.TypeConverter(typeof(System.Drawing.RectangleConverter))>]
[<System.Runtime.InteropServices.ComVisible(true)>]
[<System.Serializable>]
type Rectangle = structPublic Structure Rectangle
Implements IEquatable(Of Rectangle)Public Structure Rectangle- Vererbung
- Attribute
- Implementiert
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 PaintEventArgse, bei dem es sich um einen Parameter des Paint-Ereignishandlers handelt.
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 eigenschaft Location 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, werden durch die PageUnit und PageScale Eigenschaften des grafikobjekts bestimmt, das für die Zeichnung verwendet wird. Die Standardeinheit ist Pixel.
Um eine Rectangle mit Farbe gefüllt zu zeichnen, benötigen Sie ein Graphics-Objekt und ein von Brush abgeleitetes Objekt, z. B. SolidBrush oder 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
| 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
| Empty |
Stellt eine Rectangle Struktur dar, deren Eigenschaften nicht initialisiert bleiben. |
Eigenschaften
| Bottom |
Ruft die y-Koordinate ab, die die Summe der Y und Height Eigenschaftswerte 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 Werte von Null aufweisen. |
| Left |
Ruft die x-Koordinate des linken Rands dieser Rectangle Struktur ab. |
| Location |
Dient zum Abrufen oder Festlegen der Koordinaten der oberen linken Ecke dieser Rectangle Struktur. |
| Right |
Ruft die x-Koordinate ab, die die Summe der X und Width Eigenschaftswerte dieser Rectangle Struktur darstellt. |
| Size |
Dient zum Abrufen oder Festlegen der Größe dieses Rectangle. |
| Top |
Ruft die y-Koordinate des oberen Rands dieser Rectangle Struktur ab. |
| Width |
Dient zum Abrufen oder Festlegen der Breite dieser Rectangle Struktur. |
| X |
Dient zum Abrufen oder Festlegen der x-Koordinate der oberen linken Ecke dieser Rectangle Struktur. |
| Y |
Dient zum Abrufen oder Festlegen der y-Koordinate der oberen linken Ecke dieser Rectangle Struktur. |
Methoden
| Ceiling(RectangleF) |
Wandelt die angegebene RectangleF Struktur in eine Rectangle Struktur um, 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 rechteckige Bereich, der durch |
| Equals(Object) |
Überprüft, ob |
| 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 diese 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 diese Rectangle um den angegebenen Betrag. |
| Intersect(Rectangle) |
Ersetzt diese Rectangle durch die Schnittmenge von sich selbst und die angegebene Rectangle. |
| Intersect(Rectangle, Rectangle) |
Gibt eine dritte Rectangle Struktur zurück, die die Schnittmenge zweier anderer Rectangle Strukturen darstellt. Wenn keine Schnittmenge vorhanden ist, wird eine leere Rectangle zurückgegeben. |
| IntersectsWith(Rectangle) |
Bestimmt, ob sich dieses Rechteck mit |
| 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) |
Wandelt die angegebene RectangleF in eine Rectangle um, indem die RectangleF Werte auf die nächsten ganzzahligen Werte gerundet werden. |
| ToString() |
Wandelt die Attribute dieses Rectangle in eine lesbare Zeichenfolge um. |
| Truncate(RectangleF) |
Wandelt die angegebene RectangleF in eine Rectangle um, indem die RectangleF Werte abgeschnitten werden. |
| Union(Rectangle, Rectangle) |
Ruft eine Rectangle Struktur ab, die die Vereinigung von zwei Rectangle Strukturen enthält. |
Operatoren
| Equality(Rectangle, Rectangle) |
Testet, ob zwei Rectangle Strukturen die gleiche Position und Größe aufweisen. |
| Inequality(Rectangle, Rectangle) |
Testet, ob sich zwei Rectangle Strukturen an Position oder Größe unterscheiden. |
