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) gezeichnet. 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 Stiftstärke 5 Pixel beträgt.

Wenn das Rechteck gezeichnet wird, wird der Stift auf dem Rand des Rechtecks zentriert. Da die Stiftstärke 5 beträgt, werden die Seiten des Rechtecks 5 Pixel breit gezeichnet, sodass 1 Pixel auf dem Rand selbst gezeichnet wird, 2 Pixel im Inneren gezeichnet werden, und 2 Pixel außerhalb gezeichnet werden. Weitere Informationen zur Stiftausrichtung finden Sie unter Gewusst wie: Festlegen der Stiftstärke und -ausrichtung.

Die folgende Abbildung zeigt das resultierende Rechteck. Die gepunkteten Linien zeigen, wo das Rechteck gezeichnet worden wäre, wenn die Stiftstärke ein Pixel betragen hätte. 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 ist für die Verwendung mit Windows Forms konzipiert und erfordert PaintEventArgse, was ein Parameter des Paint Ereignishandlers ist.

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 die WidthHeightdurch die Location -Eigenschaft dargestellte obere linke Ecke definiert.

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 Merkmale der Linie, z. B. Farbe und Stärke. Die Einheiten, in die das Rechteck gezeichnet wird, werden durch die PageUnit Eigenschaften und PageScale des zum Zeichnen verwendeten Grafikobjekts bestimmt. Die Standardeinheit ist Pixel.

Zum Zeichnen eines Rectangle mit Farbe gefüllten Objekts benötigen Sie ein Graphics -Objekt und ein von Brush abgeleitetes Objekt, z SolidBrush . B. oder LinearGradientBrush. Das Graphics -Objekt stellt die FillRectangle -Methode bereit, und das Brush -Objekt stellt die Farb- und Füllinformationen bereit.

Für erweiterte Formen verwenden Sie 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: