Teilen über


Rectangle Struktur

Definition

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 Rectangle
public 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 = struct
type Rectangle = struct
[<System.ComponentModel.TypeConverter(typeof(System.Drawing.RectangleConverter))>]
[<System.Runtime.InteropServices.ComVisible(true)>]
[<System.Serializable>]
type Rectangle = struct
Public Structure Rectangle
Implements IEquatable(Of Rectangle)
Public Structure Rectangle
Vererbung
Rectangle
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.

Stifte

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 rect dargestellt wird, vollständig in dieser Rectangle Struktur enthalten ist.

Equals(Object)

Überprüft, ob obj eine Rectangle Struktur mit der gleichen Position und Größe dieser Rectangle-Struktur ist.

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 rectüberschneidet.

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.

Gilt für: