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 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
- 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.
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 |
Equals(Object) |
Überprüft, ob |
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 |
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:
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für