Rect Struct

Riferimento

Definizione

Spazio dei nomi:: Windows.Foundation

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Modifica

Contiene valori numerici che rappresentano la posizione e le dimensioni di un rettangolo.

public value class Rect

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.FoundationContract, 65536)]
struct Rect

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.FoundationContract), 65536)]
public struct Rect

var rect = {
x : /* Your value */,
y : /* Your value */,
width : /* Your value */,
height : /* Your value */
}

Public Structure Rect

<object property="x,y,width,height"/>
-or-
<object property="x y width height"/>

Ereditarietà: ValueType
Rect

Attributi: ContractVersionAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0)
API contract	Windows.Foundation.FoundationContract (è stato introdotto in v1.0)

Commenti

Se applicato alle proprietà che rappresentano le informazioni dell'interfaccia utente, i valori di larghezza e altezza di un valore Rect rappresentano pixel indipendenti dal dispositivo. I valori x e y hanno un frame di riferimento indeterminato (dipende dalla modalità di applicazione di questo valore), ma spesso rappresentano un punto nello spazio delle coordinate della finestra principale dell'app.

Javascript: In JavaScript, rect è un oggetto con quattro membri dati: x, y, width, height. Oltre ai membri dati (campi), l'API elencata negli elenchi Membri Rect non si applica alla programmazione JavaScript.

Note sulla sintassi XAML

L'utilizzo degli attributi degli oggetti è tecnicamente consentito dalle regole di analisi XAML Windows Runtime. Tuttavia, tale utilizzo non viene visualizzato perché non viene usato comunemente.

È possibile usare uno spazio anziché una virgola come delimitatore tra i valori. Sono consentiti anche utilizzi delimitatori misti.

È necessario specificare tutti e quattro i valori. "0,0" non è un valore predefinito implicito per "x,y" e non esistono altre convenzioni che possono analizzare meno di 4 componenti nella stringa.

Un elemento Rect non può essere dichiarato come risorsa in un ResourceDictionary XAML perché Rect non è un tipo condivisibile (per altre info vedi Riferimenti alle risorse ResourceDictionary e XAML).

Rettificare i valori e come vengono interpretati dalle proprietà

Size è una struttura simile che usa la stessa metafora di altezza e larghezza. Tuttavia, un rect specifica un punto di origine, mentre un valore Size non lo fa. In genere, Rect viene usato per l'API della libreria grafica e le dimensioni vengono usate per la presentazione e il layout nell'interfaccia utente dell'app, in particolare per il layout adattivo (in cui il posizionamento è spesso automatico).

Il comportamento tipico di un valore Rect quando applicato alle proprietà segue questi principi:

La larghezza e l'altezza non possono essere negativi.
X e Y possono essere negativi, con il risultato che la definizione Rect è esterna al frame di coordinate del riferimento, a meno che non sia presente una traduzione aggiuntiva.
X e Y possono essere 0. Il valore 0 è valido anche per Width o Height. Tuttavia, se un oggetto Rect con valore 0 per Width o Height viene applicato a un Oggetto RectangleGeometry, il rendering di RectangleGeometry risultante non viene eseguito.
X, Y, Width e Height possono essere valori non interi in termini di valori consentiti. Tuttavia, in genere si usano valori integer. L'interfaccia utente XAML si comporta al meglio quando le posizioni dei punti e le misure di unità non usano valori sub-pixel.

Proiezione del linguaggio e membri di Rect

Se si usa un linguaggio Microsoft .NET (C# o Microsoft Visual Basic) o estensioni del componente Visual C++ (C++/CX), Rect include membri non dati disponibili e i relativi membri dati vengono esposti come proprietà di lettura/scrittura, non campi. Vedere Rect nel browser api .NET.

Se si esegue la programmazione con C++/WinRT o la libreria modelli C++ (WRL) di Windows Runtime, esistono solo i campi membro dati come membri di Rect e non è possibile usare i metodi di utilità o le proprietà della proiezione .NET. Il codice C++ può accedere a metodi di utilità simili disponibili dalla classe statica RectHelper .

Questa tabella mostra i metodi equivalenti disponibili in .NET e C++.

.NET (Rect)	C++ (RectHelper)
Rect(Point, Point)	FromPoints(Point, Point)
Rect(Point, Size)	FromLocationAndSize(Point, Size)
Rect(Double, Double, Double, Double)	FromCoordinatesAndDimensions(Single, Single, Single, Single)
Ultimo	GetBottom(Rect)
Vuoto	Vuoto
IsEmpty	GetIsEmpty(Rect)
Sinistra	GetLeft(Rect)
Va bene	GetRight(Rect)
Top	GetTop(Rect)
Contains(Point)	Contains(Rect, Point)
È uguale a	Equals(Rect, Rect)
Intersect(Rect)	Intersect(Rect, Rect)
Union(Point)	Union(Rect, Point)
Union(Rect)	Union(Rect, Rect)

Campi

Height	Altezza del rettangolo, in pixel.
Width	Larghezza del rettangolo, in pixel.
X	Coordinata x dell'angolo superiore sinistro del rettangolo.
Y	Coordinata y dell'angolo superiore sinistro del rettangolo.

Si applica a