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 wurde für die Verwendung mit Windows Forms entwickelt und erfordert PaintEventArgs eeinen 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 WidthHeight, und die obere linke Ecke definiert, die durch die Location Eigenschaft dargestellt wird.

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, 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 SolidBrush Brush z. B. oder LinearGradientBrush. Das Graphics Objekt stellt die Methode bereit, und das Brush Objekt stellt die FillRectangle 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 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