Freigeben über


Rect Struktur

Definition

Enthält Zahlenwerte, die die Position und Größe eines Rechtecks darstellen.

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"/>

Vererbung
Rect
Attribute

Windows-Anforderungen

Gerätefamilie
Windows 10 (eingeführt in 10.0.10240.0)
API contract
Windows.Foundation.FoundationContract (eingeführt in v1.0)

Hinweise

Wenn sie auf Eigenschaften angewendet werden, die Ui-Informationen darstellen, stellen die Werte für Breite und Höhe eines Rect-Werts geräteunabhängige Pixel dar. Die x- und y-Werte verfügen über einen unbestimmten Bezugsrahmen (hängt davon ab, wie dieser Wert angewendet wird), aber sie stellen häufig einen Punkt im Koordinatenbereich des Standard App-Fensters dar.

Javascript: In JavaScript ist ein Rect ein Objekt mit vier Datenmembern: x, y, width, height. Abgesehen von den Datenmembern (Feldern) gilt die in den Rect-Memberlisten aufgeführte API nicht für die JavaScript-Programmierung.

Hinweise zur XAML-Syntax

Die Verwendung von Objektattributen ist technisch durch die Windows-Runtime XAML-Analyseregeln zulässig. Diese Verwendung wird jedoch nicht angezeigt, da sie nicht häufig verwendet wird.

Sie können ein Leerzeichen anstelle eines Kommas als Trennzeichen zwischen Werten verwenden. Gemischte Trennzeichenverwendungen sind ebenfalls zulässig.

Sie müssen alle vier Werte angeben. "0,0" ist kein impliziter Standardwert für "x,y", und es gibt keine anderen Konventionen, die weniger als vier Komponenten in der Zeichenfolge analysieren können.

Ein Rect-Element kann nicht als Ressource in einem XAML ResourceDictionary deklariert werden, da Rect kein freigegebener Typ ist (weitere Informationen finden Sie unter ResourceDictionary- und XAML-Ressourcenverweise).

Rect-Werte und wie sie von Eigenschaften interpretiert werden

Größe ist eine ähnliche Struktur, die die gleiche Metapher von Höhe und Breite verwendet. Ein Rect gibt jedoch einen Ursprungspunkt an, eine Größe hingegen nicht. In der Regel wird Rect für die Grafikbibliotheks-API verwendet, und Größe wird für die Präsentation und das Layout in der App-Benutzeroberfläche verwendet, insbesondere für adaptives Layout (bei dem die Positionierung häufig automatisch erfolgt).

Das typische Verhalten eines Rect-Werts, wenn er auf Eigenschaften angewendet wird, folgt den folgenden Prinzipien:

  • Breite und Höhe dürfen nicht negativ sein.
  • X und Y können negativ sein, sodass die Rect-Definition außerhalb des Koordinatenbezugsrahmens liegt, es sei denn, es gibt eine zusätzliche Übersetzung.
  • X und Y können 0 sein. Der Wert 0 ist auch für Breite oder Höhe gültig. (Wenn jedoch ein Rect mit dem Wert 0 für Width oder Height auf eine RectangleGeometry angewendet wird, wird die resultierende RectangleGeometry nicht gerendert.)
  • X, Y, Width und Height können nicht ganzzahlige Werte in Bezug auf zulässige Werte sein. In der Regel verwenden Sie jedoch ganzzahlige Werte. Die XAML-Benutzeroberfläche verhält sich am besten, wenn die Punktpositionen und Einheitenmeasures keine Subpixelwerte verwenden.

Sprachprojektion und Elemente von Rect

Wenn Sie eine Microsoft .NET-Sprache (C# oder Microsoft Visual Basic) oder Visual C++-Komponentenerweiterungen (C++/CX) verwenden, stehen Nicht-Datenmember für Rect zur Verfügung, und die Datenmember werden als Eigenschaften mit Lese-/Schreibzugriff und nicht als Felder verfügbar gemacht. Weitere Informationen finden Sie unter Rect im .NET-API-Browser.

Wenn Sie mit C++/WinRT oder der Windows-Runtime C++-Vorlagenbibliothek (WRL) programmieren, sind nur die Datenmemberfelder als Member von Rect vorhanden, und Sie können die Hilfsprogrammmethoden oder -eigenschaften der .NET-Projektion nicht verwenden. C++-Code kann auf ähnliche Hilfsprogrammmethoden zugreifen, die über die statische RectHelper-Klasse verfügbar sind.

In dieser Tabelle sind die entsprechenden Methoden aufgeführt, die in .NET und C++ verfügbar sind.

.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)
bottom GetBottom(Rect)
Leer Leer
IsEmpty GetIsEmpty(Rect)
Left GetLeft(Rect)
Right GetRight(Rect)
Top GetTop(Rect)
Contains(Punkt) Contains(Rect, Point)
Ist gleich Equals(Rect, Rect)
Intersect(Rect) Intersect(Rect, Rect)
Union(Punkt) Union(Rect, Point)
Union(Rect) Union(Rect, Rect)

Felder

Height

Die Höhe des Rechtecks in Pixel.

Width

Die Breite des Rechtecks in Pixel.

X

Die x-Koordinate der linken oberen Ecke des Rechtecks.

Y

Die y-Koordinate der linken oberen Ecke des Rechtecks.

Gilt für:

Weitere Informationen