Rectangle Struktur

Definition

Speichert einen Satz von vier Integerwerten, die die Position und Größe eines Rechtecks angeben.

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

Im folgenden Beispiel wird ein Rechteck mit der oberen linken Ecke bei (10, 10) zeichnet. 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 ist, werden die Seiten des Rechtecks 5 Pixel breit gezeichnet, sodass 1 Pixel an der Grenze selbst gezeichnet wird, 2 Pixel auf der Innenseite und 2 Pixel auf der Außenseite gezeichnet werden. Weitere Informationen zur Stiftausrichtung finden Sie unter Vorgehensweise: Festlegen von Stiftbreite und Ausrichtung.

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

Stifte

Das Beispiel ist für die Verwendung mit Windows Forms konzipiert und erfordert . Dies PaintEventArgs e ist ein 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 , und die obere linke Ecke definiert, Width die durch die Height -Eigenschaft dargestellt Location werden.

Um Rechtecke zu zeichnen, benötigen Sie ein Graphics -Objekt und ein Pen -Objekt. Das Graphics -Objekt stellt die DrawRectangle -Methode bereit, und das Pen -Objekt speichert Funktionen der Linie, z. B. Farbe und Breite. Die Einheiten, in die das Rechteck gezeichnet wird, werden durch die Eigenschaften und des Grafikobjekts bestimmt, PageUnit das zum Zeichnen verwendet PageScale wird. Die Standardeinheit ist Pixel.

Um eine mit Farbe gefüllte zu Rectangle zeichnen, benötigen Sie ein Graphics -Objekt und ein -Objekt, das von Brush abgeleitet wird, z. SolidBrush B. 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 Formen 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 mit nicht initialisierten Eigenschaften dar.

Eigenschaften

Bottom

Ruft die y-Koordinate ab, die die Summe aus dem Y-Eigenschaftswert und dem Height-Eigenschaftswert dieser Rectangle-Struktur ist.

Height

Ruft die Höhe dieser Rectangle-Struktur ab oder legt diese fest.

IsEmpty

Überprüft, ob alle numerischen Eigenschaften dieses Rectangle den Wert 0 (null) haben.

Left

Ruft die x-Koordinate des linken Randes dieser Rectangle-Struktur ab.

Location

Ruft die Koordinaten der linken oberen Ecke dieser Rectangle-Struktur ab oder legt diese fest.

Right

Ruft die x-Koordinate ab, die die Summe aus dem X-Eigenschaftswert und dem Width-Eigenschaftswert dieser Rectangle-Struktur ist.

Size

Ruft die Größe dieses Rectangle ab oder legt sie fest.

Top

Ruft die y-Koordinate des oberen Randes dieser Rectangle-Struktur ab.

Width

Ruft die Breite dieser Rectangle-Struktur ab oder legt diese fest.

X

Ruft die x-Koordinate der linken oberen Ecke dieser Rectangle-Struktur ab oder legt diese fest.

Y

Ruft die y-Koordinate der linken oberen Ecke dieser Rectangle-Struktur ab oder legt diese fest.

Methoden

Ceiling(RectangleF)

Konvertiert die angegebene RectangleF-Struktur in eine Rectangle-Struktur, indem die RectangleF-Werte auf die nächste ganze Zahl aufgerundet 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 von rect dargestellte rechteckige Bereich vollständig in dieser Rectangle-Struktur enthalten ist.

Equals(Object)

Überprüft, ob obj eine Rectangle-Struktur mit derselben Position und Größe wie diese Rectangle-Struktur ist.

Equals(Rectangle)

Gibt an, ob das aktuelle Objekt gleich einem anderen Objekt des gleichen Typs ist.

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 über die Verwendung von Hashcodes finden Sie unter GetHashCode().

Inflate(Int32, Int32)

Vergrößert dieses Rectangle um den angegebenen Betrag.

Inflate(Rectangle, Int32, Int32)

Erstellt eine vergrößerte Kopie der angegebenen Rectangle-Struktur und gibt die Kopie zurück. Die Kopie wird um den angegebenen Betrag vergrößert. Die ursprüngliche Rectangle-Struktur wird nicht geändert.

Inflate(Size)

Vergrößert dieses Rectangle um den angegebenen Betrag.

Intersect(Rectangle)

Ersetzt dieses Rectangle durch die Schnittmenge dieses Rechtecks und des angegebenen Rectangle.

Intersect(Rectangle, Rectangle)

Gibt eine dritte Rectangle-Struktur zurück, die die Schnittmenge zweier anderer Rectangle-Strukturen darstellt. Wenn keine Schnittmenge vorliegt, wird ein leeres Rectangle zurückgegeben.

IntersectsWith(Rectangle)

Bestimmt, ob dieses Rechteck eine Schnittmenge mit rect bildet.

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 das angegebene RectangleF in ein Rectangle, indem die RectangleF-Werte auf die nächste ganze Zahl gerundet werden.

ToString()

Konvertiert die Attribute für dieses Rectangle in eine Klartextzeichenfolge.

Truncate(RectangleF)

Konvertiert das angegebene RectangleF in ein Rectangle, indem die RectangleF-Werte abgeschnitten werden.

Union(Rectangle, Rectangle)

Ruft eine Rectangle-Struktur ab, die die Gesamtmenge zweier Rectangle-Strukturen enthält.

Operatoren

Equality(Rectangle, Rectangle)

Überprüft, ob zwei Rectangle-Strukturen die gleiche Position und Größe haben.

Inequality(Rectangle, Rectangle)

Überprüft, ob sich zwei Rectangle-Strukturen in Position und Größe unterscheiden.

Gilt für