Partage via


Rect Structure

Définition

Contient des valeurs numériques qui représentent l’emplacement et la taille d’un rectangle.

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

Héritage
Rect
Attributs

Configuration requise pour Windows

Famille d’appareils
Windows 10 (introduit dans 10.0.10240.0)
API contract
Windows.Foundation.FoundationContract (introduit dans v1.0)

Remarques

Lorsqu’elles sont appliquées aux propriétés qui représentent des informations d’interface utilisateur, les valeurs de largeur et de hauteur d’une valeur Rect représentent des pixels indépendants de l’appareil. Les valeurs x et y ont un cadre de référence indéterminé (cela dépend de la façon dont cette valeur est appliquée), mais elles représentent souvent un point dans l’espace de coordonnées de la fenêtre d’application main.

Javascript: En JavaScript, un Rect est un objet avec quatre membres de données : x, y, width, height. À part les membres de données (champs), l’API répertoriée dans les listes de membres Rect ne s’applique pas à la programmation JavaScript.

Remarques sur la syntaxe XAML

L’utilisation des attributs d’objet est techniquement autorisée par les règles d’analyse XAML Windows Runtime. Toutefois, cette utilisation n’est pas affichée, car elle n’est pas couramment utilisée.

Vous pouvez utiliser un espace plutôt qu’une virgule comme délimiteur entre les valeurs. Les utilisations mixtes de délimiteurs sont également autorisées.

Vous devez spécifier les quatre valeurs. « 0,0 » n’est pas une valeur par défaut implicite pour « x,y », et il n’existe aucune autre convention qui peut analyser moins de 4 composants dans la chaîne.

Un élément Rect ne peut pas être déclaré en tant que ressource dans un ResourceDictionary XAML, car Rect n’est pas un type partageable (pour plus d’informations, consultez ResourceDictionary et références de ressources XAML).

Valeurs rect et comment elles sont interprétées par les propriétés

La taille est une structure similaire qui utilise la même métaphore de la hauteur et de la largeur. Toutefois, un rect spécifie un point d’origine, contrairement à une taille . En règle générale, Rect est utilisé pour l’API de bibliothèque graphique, et la taille est utilisée pour la présentation et la disposition dans l’interface utilisateur de l’application, en particulier pour la disposition adaptative (où le positionnement est souvent automatique).

Le comportement typique d’une valeur Rect lorsqu’elle est appliquée aux propriétés suit les principes suivants :

  • La largeur et la hauteur ne peuvent pas être négatives.
  • X et Y peuvent être négatifs, de sorte que la définition Rect se trouve en dehors du cadre de coordonnées de référence, sauf s’il existe une traduction supplémentaire.
  • X et Y peuvent être 0. La valeur 0 est également valide pour Width ou Height. (Toutefois, si un Rect avec la valeur 0 pour Width ou Height est appliqué à un RectangleGeometry, le RectangleGeometry qui en résulte ne s’affiche pas.)
  • X, Y, Width et Height peuvent être des valeurs non entières en termes de valeurs autorisées. Toutefois, vous utilisez généralement des valeurs entières. L’interface utilisateur XAML se comporte mieux lorsque les emplacements de points et les mesures unitaires n’utilisent pas de valeurs de sous-pixels.

Projection linguistique et membres de Rect

Si vous utilisez un langage Microsoft .NET (C# ou Microsoft Visual Basic) ou des extensions de composant Visual C++ (C++/CX), Rect dispose de membres non-data disponibles, et ses membres de données sont exposés en tant que propriétés en lecture-écriture, et non en tant que champs. Consultez Rect dans l’explorateur d’API .NET.

Si vous programmez avec C++/WinRT ou la Windows Runtime bibliothèque de modèles C++ (WRL), seuls les champs membres de données existent en tant que membres de Rect et vous ne pouvez pas utiliser les méthodes ou propriétés utilitaires de la projection .NET. Le code C++ peut accéder à des méthodes d’utilitaire similaires disponibles à partir de la classe statique RectHelper .

Ce tableau montre les méthodes équivalentes disponibles dans .NET et 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)
Bas GetBottom(Rect)
Vide Vide
IsEmpty GetIsEmpty(Rect)
Left GetLeft(Rect)
Right GetRight(Rect)
Top GetTop(Rect)
Contains(Point) Contains(Rect, Point)
Égal à Equals(Rect, Rect)
Intersect(Rect) Intersect(Rect, Rect)
Union(Point) Union(Rect, Point)
Union(Rect) Union(Rect, Rect)

Champs

Height

Hauteur du rectangle, en pixels.

Width

Largeur du rectangle, en pixels.

X

Coordonnée x du coin supérieur gauche du rectangle.

Y

Coordonnée y du coin supérieur gauche du rectangle.

S’applique à

Voir aussi