Rectangle Struktura

Definice

Ukládá sadu čtyř celých čísel, která reprezentují umístění a velikost obdélníku.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
public struct Rectangle : IEquatable<System.Drawing.Rectangle>
public struct Rectangle
[System.ComponentModel.TypeConverter(typeof(System.Drawing.RectangleConverter))]
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public struct Rectangle
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
Dědičnost
Rectangle
Atributy
Implementuje

Příklady

Následující příklad Kreslí obdélník s jeho levým horním rohem na (10, 10).The following example draws a rectangle with its upper-left corner at (10, 10). Obdélník má šířku 100 a výšku 50.The rectangle has a width of 100 and a height of 50. Druhý argument předaný Pen konstruktoru označuje, že šířka pera je 5 pixelů.The second argument passed to the Pen constructor indicates that the pen width is 5 pixels.

Když je obdélník vykreslený, pero se zacentruje na hranici obdélníku.When the rectangle is drawn, the pen is centered on the rectangle's boundary. Vzhledem k tomu, že šířka pera je 5, jsou strany obdélníku vykresleny o 5 pixelů široké, takže 1 pixel se vykreslí na hranici samotného, 2 pixely se vykreslí na vnitřku a 2 pixely se vykreslí na vnějších.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. Další podrobnosti o zarovnání perem naleznete v tématu How to: set Width a Alignment pera.For more details on pen alignment, see How to: Set Pen Width and Alignment.

Na následujícím obrázku je vidět výsledný obdélník.The following illustration shows the resulting rectangle. Tečkované čáry ukazují, kde obdélník byl vykreslen, pokud byla Šířka pera v jednom pixelu.The dotted lines show where the rectangle would have been drawn if the pen width had been one pixel. Zvětšený pohled levého horního rohu obdélníku ukazuje, že tlusté černé čáry jsou zarovnány na střed na těchto tečkovaných řádcích.The enlarged view of the upper-left corner of the rectangle shows that the thick black lines are centered on those dotted lines.

PeraPens

Příklad je navržen pro použití s model Windows Forms a vyžaduje PaintEventArgs e , což je parametr Paint obslužné rutiny události.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)

Poznámky

Obdélník je definován pomocí Width , a v Height levém horním rohu reprezentovaném Location vlastností.A rectangle is defined by its Width, Height, and upper-left corner represented by the Location property.

Pro kreslení obdélníků potřebujete Graphics objekt a Pen objekt.To draw rectangles, you need a Graphics object and a Pen object. GraphicsObjekt poskytuje DrawRectangle metodu a Pen objekt ukládá funkce řádku, jako je například barva a šířka.The Graphics object provides the DrawRectangle method, and the Pen object stores features of the line, such as color and width. Jednotky, ve kterých je obdélník vykreslen, jsou určeny PageUnit vlastnostmi a PageScale objektu Graphics použitým pro kreslení.The units the rectangle is drawn in is determined by the PageUnit and PageScale properties of the graphics object used for drawing. Výchozí jednotka je pixely.The default unit is pixels.

Chcete-li nakreslit Rectangle vyplněnou barvou, potřebujete Graphics objekt a objekt odvozený z, Brush například SolidBrush nebo LinearGradientBrush .To draw a Rectangle filled with color, you need a Graphics object and an object derived from Brush such as SolidBrush or LinearGradientBrush. GraphicsObjekt poskytuje FillRectangle metodu a Brush objekt poskytuje informace o barvě a výplní.The Graphics object provides the FillRectangle method and the Brush object provides the color and fill information.

Pro pokročilejší tvary použijte Region objekt.For more advanced shapes, use a Region object.

Konstruktory

Rectangle(Int32, Int32, Int32, Int32)

Inicializuje novou instanci Rectangle třídy se zadaným umístěním a velikostí.Initializes a new instance of the Rectangle class with the specified location and size.

Rectangle(Point, Size)

Inicializuje novou instanci Rectangle třídy se zadaným umístěním a velikostí.Initializes a new instance of the Rectangle class with the specified location and size.

Pole

Empty

Představuje Rectangle strukturu s jejími vlastnostmi, které zůstaly neinicializované.Represents a Rectangle structure with its properties left uninitialized.

Vlastnosti

Bottom

Získá souřadnici y, která je součtem Y Height hodnot vlastností a této Rectangle struktury.Gets the y-coordinate that is the sum of the Y and Height property values of this Rectangle structure.

Height

Získá nebo nastaví výšku této Rectangle struktury.Gets or sets the height of this Rectangle structure.

IsEmpty

Testuje, zda všechny číselné vlastnosti Rectangle mají hodnoty nula.Tests whether all numeric properties of this Rectangle have values of zero.

Left

Získá souřadnici x levého okraje této Rectangle struktury.Gets the x-coordinate of the left edge of this Rectangle structure.

Location

Získá nebo nastaví souřadnice levého horního rohu této Rectangle struktury.Gets or sets the coordinates of the upper-left corner of this Rectangle structure.

Right

Získá souřadnici x, která je součtem X hodnot a Width vlastností této Rectangle struktury.Gets the x-coordinate that is the sum of X and Width property values of this Rectangle structure.

Size

Získá nebo nastaví velikost tohoto Rectangle .Gets or sets the size of this Rectangle.

Top

Získá souřadnici y horní hrany této Rectangle struktury.Gets the y-coordinate of the top edge of this Rectangle structure.

Width

Získá nebo nastaví šířku této Rectangle struktury.Gets or sets the width of this Rectangle structure.

X

Získá nebo nastaví souřadnici x levého horního rohu této Rectangle struktury.Gets or sets the x-coordinate of the upper-left corner of this Rectangle structure.

Y

Získá nebo nastaví souřadnici y v levém horním rohu této Rectangle struktury.Gets or sets the y-coordinate of the upper-left corner of this Rectangle structure.

Metody

Ceiling(RectangleF)

Převede zadanou RectangleF strukturu na Rectangle strukturu zaokrouhlením RectangleF hodnot na další vyšší celočíselné hodnoty.Converts the specified RectangleF structure to a Rectangle structure by rounding the RectangleF values to the next higher integer values.

Contains(Int32, Int32)

Určuje, zda je zadaný bod obsažen v rámci této Rectangle struktury.Determines if the specified point is contained within this Rectangle structure.

Contains(Point)

Určuje, zda je zadaný bod obsažen v rámci této Rectangle struktury.Determines if the specified point is contained within this Rectangle structure.

Contains(Rectangle)

Určuje, zda je obdélníková oblast reprezentovaná v rect rámci této struktury zcela obsažena Rectangle .Determines if the rectangular region represented by rect is entirely contained within this Rectangle structure.

Equals(Object)

Testuje, zda obj je Rectangle Struktura se stejným umístěním a velikostí této Rectangle struktury.Tests whether obj is a Rectangle structure with the same location and size of this Rectangle structure.

Equals(Rectangle)

Označuje, zda je aktuální objekt roven jinému objektu stejného typu.Indicates whether the current object is equal to another object of the same type.

FromLTRB(Int32, Int32, Int32, Int32)

Vytvoří Rectangle strukturu se zadanými hraničními umístěními.Creates a Rectangle structure with the specified edge locations.

GetHashCode()

Vrátí kód hash této Rectangle struktury.Returns the hash code for this Rectangle structure. Informace o použití kódů hash naleznete v tématu GetHashCode() .For information about the use of hash codes, see GetHashCode() .

Inflate(Int32, Int32)

Zvětší toto Rectangle o zadanou velikost.Enlarges this Rectangle by the specified amount.

Inflate(Rectangle, Int32, Int32)

Vytvoří a vrátí zvětšenou kopii zadané Rectangle struktury.Creates and returns an enlarged copy of the specified Rectangle structure. Kopie je zvětšena o zadanou velikost.The copy is enlarged by the specified amount. Původní Rectangle struktura zůstane beze změny.The original Rectangle structure remains unmodified.

Inflate(Size)

Zvětší toto Rectangle o zadanou velikost.Enlarges this Rectangle by the specified amount.

Intersect(Rectangle)

Nahradí to Rectangle průsečíkem sebe sama a zadaným Rectangle .Replaces this Rectangle with the intersection of itself and the specified Rectangle.

Intersect(Rectangle, Rectangle)

Vrátí třetí Rectangle strukturu, která představuje průnik dvou dalších Rectangle struktur.Returns a third Rectangle structure that represents the intersection of two other Rectangle structures. Pokud neexistuje průnik, Rectangle bude vrácena prázdná.If there is no intersection, an empty Rectangle is returned.

IntersectsWith(Rectangle)

Určuje, zda se v tomto obdélníku protínají rect .Determines if this rectangle intersects with rect.

Offset(Int32, Int32)

Upraví umístění tohoto obdélníku o zadanou hodnotu.Adjusts the location of this rectangle by the specified amount.

Offset(Point)

Upraví umístění tohoto obdélníku o zadanou hodnotu.Adjusts the location of this rectangle by the specified amount.

Round(RectangleF)

Převede hodnotu určenou RectangleF na, Rectangle zaokrouhlením RectangleF hodnot na nejbližší celočíselné hodnoty.Converts the specified RectangleF to a Rectangle by rounding the RectangleF values to the nearest integer values.

ToString()

Převede atributy tohoto typu Rectangle na řetězec čitelný pomocí lidského.Converts the attributes of this Rectangle to a human-readable string.

Truncate(RectangleF)

Převede hodnotu určenou RectangleF na a Rectangle tak, že se zkrátí RectangleF hodnoty.Converts the specified RectangleF to a Rectangle by truncating the RectangleF values.

Union(Rectangle, Rectangle)

Načte Rectangle strukturu, která obsahuje sjednocení dvou Rectangle struktur.Gets a Rectangle structure that contains the union of two Rectangle structures.

Operátory

Equality(Rectangle, Rectangle)

Testuje, zda Rectangle mají dvě struktury stejné umístění a velikost.Tests whether two Rectangle structures have equal location and size.

Inequality(Rectangle, Rectangle)

Testuje, zda Rectangle se dvě struktury liší v umístění nebo velikosti.Tests whether two Rectangle structures differ in location or size.

Platí pro