Rectangle Struktura

Definicja

Przechowuje zestaw czterech liczb całkowitych, które reprezentują lokalizację i rozmiar prostokąta.Stores a set of four integers that represent the location and size of a rectangle.

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
Dziedziczenie
Rectangle
Atrybuty
Implementuje

Przykłady

Poniższy przykład rysuje prostokąt w lewym górnym rogu w (10, 10).The following example draws a rectangle with its upper-left corner at (10, 10). Prostokąt ma szerokość 100 i wysokość 50.The rectangle has a width of 100 and a height of 50. Drugi argument przeszedł do Pen konstruktora wskazuje, że szerokość pióra to 5 pikseli.The second argument passed to the Pen constructor indicates that the pen width is 5 pixels.

Po narysowaniu prostokąta pióro jest wyśrodkowane na granicy prostokąta.When the rectangle is drawn, the pen is centered on the rectangle's boundary. Ze względu na to, że szerokość pióra wynosi 5, boki prostokąta są rysowane 5 pikseli szerokości, tak że 1 piksel jest rysowany na samym granicy, 2 piksele są rysowane w obrębie wewnątrz, a 2 piksele są rysowane na zewnątrz.Because the pen width is 5, the sides of the rectangle are drawn 5 pixels wide, such that 1 pixel is drawn on the boundary itself, 2 pixels are drawn on the inside, and 2 pixels are drawn on the outside. Aby uzyskać więcej informacji na temat wyrównania pióra, zobacz How to: set i Width pióra.For more details on pen alignment, see How to: Set Pen Width and Alignment.

Na poniższej ilustracji przedstawiono prostokątny wskaźnik.The following illustration shows the resulting rectangle. Linie kropkowane pokazują, gdzie prostokąt ma być rysowany, jeśli szerokość pióra zakończyła się jednym pikselem.The dotted lines show where the rectangle would have been drawn if the pen width had been one pixel. Powiększony widok lewego górnego rogu prostokąta pokazuje, że grube czarne linie są wyśrodkowane w tych liniach kropkowanych.The enlarged view of the upper-left corner of the rectangle shows that the thick black lines are centered on those dotted lines.

PióraPens

Przykład jest przeznaczony do użytku z Windows Forms i wymaga PaintEventArgs e , który jest parametrem Paint programu obsługi zdarzeń.The example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler.

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)

Uwagi

Prostokąt jest definiowany przez jego Width , Height i lewy górny róg reprezentowane przez Location Właściwość.A rectangle is defined by its Width, Height, and upper-left corner represented by the Location property.

Aby rysować prostokąty, potrzebujesz Graphics obiektu i Pen obiektu.To draw rectangles, you need a Graphics object and a Pen object. GraphicsObiekt udostępnia DrawRectangle metodę, a Pen obiekt przechowuje funkcje wiersza, takie jak kolor i szerokość.The Graphics object provides the DrawRectangle method, and the Pen object stores features of the line, such as color and width. Jednostki, w których jest rysowany prostokąt, są określane przez PageUnit i PageScale właściwości obiektu Graphics używanego do rysowania.The units the rectangle is drawn in is determined by the PageUnit and PageScale properties of the graphics object used for drawing. Jednostka domyślna to piksele.The default unit is pixels.

Aby narysować Rectangle wypełniony kolor, potrzebujesz Graphics obiektu i obiektu pochodnego od Brush takich jak SolidBrush lub LinearGradientBrush .To draw a Rectangle filled with color, you need a Graphics object and an object derived from Brush such as SolidBrush or LinearGradientBrush. GraphicsObiekt udostępnia FillRectangle metodę, a Brush obiekt zawiera informacje o kolorze i wypełnieniu.The Graphics object provides the FillRectangle method and the Brush object provides the color and fill information.

Aby uzyskać bardziej zaawansowane kształty, użyj Region obiektu.For more advanced shapes, use a Region object.

Konstruktory

Rectangle(Int32, Int32, Int32, Int32)

Inicjuje nowe wystąpienie Rectangle klasy z określoną lokalizacją i rozmiarem.Initializes a new instance of the Rectangle class with the specified location and size.

Rectangle(Point, Size)

Inicjuje nowe wystąpienie Rectangle klasy z określoną lokalizacją i rozmiarem.Initializes a new instance of the Rectangle class with the specified location and size.

Pola

Empty

Reprezentuje Rectangle strukturę z właściwościami, które nie zostały zainicjowane.Represents a Rectangle structure with its properties left uninitialized.

Właściwości

Bottom

Pobiera współrzędną y, która jest sumą Y Height wartości właściwości i tej Rectangle struktury.Gets the y-coordinate that is the sum of the Y and Height property values of this Rectangle structure.

Height

Pobiera lub ustawia wysokość tej Rectangle struktury.Gets or sets the height of this Rectangle structure.

IsEmpty

Testuje, czy wszystkie właściwości liczbowe o Rectangle wartości zero.Tests whether all numeric properties of this Rectangle have values of zero.

Left

Pobiera współrzędną x lewej krawędzi tej Rectangle struktury.Gets the x-coordinate of the left edge of this Rectangle structure.

Location

Pobiera lub ustawia współrzędne górnego lewego rogu tej Rectangle struktury.Gets or sets the coordinates of the upper-left corner of this Rectangle structure.

Right

Pobiera współrzędną x, która jest sumą X i Width wartości właściwości tej Rectangle struktury.Gets the x-coordinate that is the sum of X and Width property values of this Rectangle structure.

Size

Pobiera lub ustawia rozmiar tego elementu Rectangle .Gets or sets the size of this Rectangle.

Top

Pobiera współrzędną y górnej krawędzi tej Rectangle struktury.Gets the y-coordinate of the top edge of this Rectangle structure.

Width

Pobiera lub ustawia szerokość tej Rectangle struktury.Gets or sets the width of this Rectangle structure.

X

Pobiera lub ustawia współrzędną x lewego górnego rogu tej Rectangle struktury.Gets or sets the x-coordinate of the upper-left corner of this Rectangle structure.

Y

Pobiera lub ustawia współrzędną y lewego górnego rogu tej Rectangle struktury.Gets or sets the y-coordinate of the upper-left corner of this Rectangle structure.

Metody

Ceiling(RectangleF)

Konwertuje określoną RectangleF strukturę na Rectangle strukturę przez zaokrąglenie RectangleF wartości do następnej wyższej wartości liczb całkowitych.Converts the specified RectangleF structure to a Rectangle structure by rounding the RectangleF values to the next higher integer values.

Contains(Int32, Int32)

Określa, czy określony punkt jest zawarty w tej Rectangle strukturze.Determines if the specified point is contained within this Rectangle structure.

Contains(Point)

Określa, czy określony punkt jest zawarty w tej Rectangle strukturze.Determines if the specified point is contained within this Rectangle structure.

Contains(Rectangle)

Określa, czy prostokątny region reprezentowany przez program rect jest całkowicie zawarty w tej Rectangle strukturze.Determines if the rectangular region represented by rect is entirely contained within this Rectangle structure.

Equals(Object)

Testuje, czy obj jest to Rectangle Struktura o tej samej lokalizacji i rozmiarze tej Rectangle struktury.Tests whether obj is a Rectangle structure with the same location and size of this Rectangle structure.

Equals(Rectangle)

Wskazuje, czy bieżący obiekt jest równy innemu obiektowi tego samego typu.Indicates whether the current object is equal to another object of the same type.

FromLTRB(Int32, Int32, Int32, Int32)

Tworzy Rectangle strukturę z określonymi lokalizacjami krawędzi.Creates a Rectangle structure with the specified edge locations.

GetHashCode()

Zwraca kod skrótu dla tej Rectangle struktury.Returns the hash code for this Rectangle structure. Informacje o używaniu kodów skrótów można znaleźć w temacie GetHashCode() .For information about the use of hash codes, see GetHashCode() .

Inflate(Int32, Int32)

Powiększa ten Rectangle krok o określoną liczbę.Enlarges this Rectangle by the specified amount.

Inflate(Rectangle, Int32, Int32)

Tworzy i zwraca powiększoną kopię określonej Rectangle struktury.Creates and returns an enlarged copy of the specified Rectangle structure. Kopia zostanie powiększona o określoną liczbę.The copy is enlarged by the specified amount. Oryginalna Rectangle Struktura nie jest modyfikowana.The original Rectangle structure remains unmodified.

Inflate(Size)

Powiększa ten Rectangle krok o określoną liczbę.Enlarges this Rectangle by the specified amount.

Intersect(Rectangle)

Zamienia ten parametr Rectangle na część wspólną siebie i określone Rectangle .Replaces this Rectangle with the intersection of itself and the specified Rectangle.

Intersect(Rectangle, Rectangle)

Zwraca trzecią Rectangle strukturę, która reprezentuje część wspólną dwóch innych Rectangle struktur.Returns a third Rectangle structure that represents the intersection of two other Rectangle structures. Jeśli nie ma żadnych przecięć, Rectangle zwracana jest pusta.If there is no intersection, an empty Rectangle is returned.

IntersectsWith(Rectangle)

Określa, czy ten prostokąt przecina się z rect .Determines if this rectangle intersects with rect.

Offset(Int32, Int32)

Dostosowuje lokalizację tego prostokąta o określoną liczbę.Adjusts the location of this rectangle by the specified amount.

Offset(Point)

Dostosowuje lokalizację tego prostokąta o określoną liczbę.Adjusts the location of this rectangle by the specified amount.

Round(RectangleF)

Konwertuje określoną wartość na RectangleF a Rectangle przez zaokrąglenie RectangleF wartości do najbliższej wartości całkowitej.Converts the specified RectangleF to a Rectangle by rounding the RectangleF values to the nearest integer values.

ToString()

Konwertuje atrybuty tego elementu Rectangle na ciąg czytelny dla człowieka.Converts the attributes of this Rectangle to a human-readable string.

Truncate(RectangleF)

Konwertuje określoną wartość na RectangleF a Rectangle przez obcinanie RectangleF wartości.Converts the specified RectangleF to a Rectangle by truncating the RectangleF values.

Union(Rectangle, Rectangle)

Pobiera Rectangle strukturę zawierającą Unię dwóch Rectangle struktur.Gets a Rectangle structure that contains the union of two Rectangle structures.

Operatory

Equality(Rectangle, Rectangle)

Testuje, czy dwie Rectangle struktury mają równą lokalizację i rozmiar.Tests whether two Rectangle structures have equal location and size.

Inequality(Rectangle, Rectangle)

Testuje, czy dwie Rectangle struktury różnią się w zależności od lokalizacji lub rozmiaru.Tests whether two Rectangle structures differ in location or size.

Dotyczy