Rectangle Struct

Definizione

Spazio dei nomi:

System.Drawing

Assembly:

System.Drawing.Primitives.dll

Origine:

Rectangle.cs

Archivia un set di quattro interi che rappresentano la posizione e le dimensioni di un rettangolo.

public value class Rectangle : IEquatable<System::Drawing::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>

[<System.ComponentModel.TypeConverter("System.Drawing.RectangleConverter, System.Drawing, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
type Rectangle = struct

Public Structure Rectangle
Implements IEquatable(Of Rectangle)

Ereditarietà

Object

ValueType

Rectangle

Attributi

TypeConverterAttribute

Implementazioni

IEquatable<Rectangle>

Esempio

Nell'esempio seguente viene disegnato un rettangolo con l'angolo superiore sinistro in corrispondenza di (10, 10). Il rettangolo ha una larghezza di 100 e un'altezza di 50. Il secondo argomento passato al costruttore Pen indica che la larghezza della penna è di 5 pixel.

Quando il rettangolo viene disegnato, la penna viene allineata al centro sul limite del rettangolo. Poiché la larghezza della penna è 5, i lati del rettangolo vengono disegnati 5 pixel di larghezza, in modo che 1 pixel venga disegnato sul limite stesso, 2 pixel vengono disegnati all'interno e 2 pixel vengono disegnati all'esterno. Per altre informazioni sull'allineamento della penna, vedere Procedura: Impostare la larghezza e l'allineamento della penna.

La figura seguente mostra il rettangolo risultante. Le linee tratteggiate mostrano dove sarebbe stato disegnato il rettangolo se la larghezza della penna fosse di un pixel. La visualizzazione ingrandita dell'angolo superiore sinistro del rettangolo mostra che le linee nere spesse sono centrate su quelle linee tratteggiate.

L'esempio è progettato per l'uso con Windows Form e richiede PaintEventArgse, che è un parametro del gestore eventi Paint.

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)

Commenti

Un rettangolo è definito dal relativo Width, Heighte dall'angolo superiore sinistro rappresentato dalla proprietà Location.

Per disegnare rettangoli, è necessario un oggetto Graphics e un oggetto Pen. L'oggetto Graphics fornisce il metodo DrawRectangle e l'oggetto Pen archivia le caratteristiche della linea, ad esempio colore e larghezza. Le unità in cui viene disegnato il rettangolo sono determinate dalla PageUnit e dalle proprietà PageScale dell'oggetto grafico utilizzato per il disegno. L'unità predefinita è pixel.

Per disegnare un Rectangle riempito di colore, è necessario un oggetto Graphics e un oggetto derivato da Brush, ad esempio SolidBrush o LinearGradientBrush. L'oggetto Graphics fornisce il metodo FillRectangle e l'oggetto Brush fornisce le informazioni sul colore e sul riempimento.

Per forme più avanzate, utilizzare un oggetto Region.

Costruttori

Rectangle(Int32, Int32, Int32, Int32)	Inizializza una nuova istanza della classe Rectangle con la posizione e le dimensioni specificate.
Rectangle(Point, Size)	Inizializza una nuova istanza della classe Rectangle con la posizione e le dimensioni specificate.

Campi

Empty

Rappresenta una struttura Rectangle con le relative proprietà non inizializzate.

Proprietà

Bottom	Ottiene la coordinata y che corrisponde alla somma dei valori della proprietà Y e Height di questa struttura Rectangle.
Height	Ottiene o imposta l'altezza di questa struttura Rectangle.
IsEmpty	Verifica se tutte le proprietà numeriche di questo Rectangle hanno valori pari a zero.
Left	Ottiene la coordinata x del bordo sinistro di questa struttura Rectangle.
Location	Ottiene o imposta le coordinate dell'angolo superiore sinistro della struttura Rectangle.
Right	Ottiene la coordinata x che corrisponde alla somma dei valori di proprietà X e Width di questa struttura Rectangle.
Size	Ottiene o imposta le dimensioni di questo Rectangle.
Top	Ottiene la coordinata y del bordo superiore di questa struttura Rectangle.
Width	Ottiene o imposta la larghezza di questa struttura Rectangle.
X	Ottiene o imposta la coordinata x dell'angolo superiore sinistro di questa struttura Rectangle.
Y	Ottiene o imposta la coordinata y dell'angolo superiore sinistro di questa struttura Rectangle.

Metodi

Ceiling(RectangleF)	Converte la struttura di RectangleF specificata in una struttura Rectangle arrotondando i valori RectangleF ai valori integer superiori successivi.
Contains(Int32, Int32)	Determina se il punto specificato è contenuto all'interno di questa struttura Rectangle.
Contains(Point)	Determina se il punto specificato è contenuto all'interno di questa struttura Rectangle.
Contains(Rectangle)	Determina se l'area rettangolare rappresentata da rect è interamente contenuta all'interno di questa struttura Rectangle.
Equals(Object)	Verifica se obj è una struttura Rectangle con la stessa posizione e la stessa dimensione di questa struttura Rectangle.
Equals(Rectangle)	Indica se l'oggetto corrente è uguale a un altro oggetto dello stesso tipo.
FromLTRB(Int32, Int32, Int32, Int32)	Crea una struttura Rectangle con le posizioni dei bordi specificate.
GetHashCode()	Restituisce il codice hash per questa struttura di Rectangle. Per informazioni sull'uso dei codici hash, vedere GetHashCode() .
Inflate(Int32, Int32)	Ingrandisce questo Rectangle in base all'importo specificato.
Inflate(Rectangle, Int32, Int32)	Crea e restituisce una copia ingrandita della struttura di Rectangle specificata. La copia viene ingrandita in base all'importo specificato. La struttura originale Rectangle rimane invariata.
Inflate(Size)	Ingrandisce questo Rectangle in base all'importo specificato.
Intersect(Rectangle)	Sostituisce questa Rectangle con l'intersezione di se stessa e la Rectanglespecificata.
Intersect(Rectangle, Rectangle)	Restituisce una terza struttura Rectangle che rappresenta l'intersezione di due altre strutture Rectangle. Se non è presente alcuna intersezione, viene restituito un Rectangle vuoto.
IntersectsWith(Rectangle)	Determina se questo rettangolo si interseca con rect.
Offset(Int32, Int32)	Regola la posizione del rettangolo in base alla quantità specificata.
Offset(Point)	Regola la posizione del rettangolo in base alla quantità specificata.
Round(RectangleF)	Converte il RectangleF specificato in un Rectangle arrotondando i valori RectangleF nei valori integer più vicini.
ToString()	Converte gli attributi di questa Rectangle in una stringa leggibile.
Truncate(RectangleF)	Converte il RectangleF specificato in un Rectangle troncando i valori di RectangleF.
Union(Rectangle, Rectangle)	Ottiene una struttura Rectangle che contiene l'unione di due strutture Rectangle.

Operatori

Equality(Rectangle, Rectangle)	Verifica se due strutture Rectangle hanno una posizione e dimensioni uguali.
Inequality(Rectangle, Rectangle)	Verifica se due strutture Rectangle differiscono in posizione o dimensioni.