Rect Structure

Contient un jeu de quatre nombres à virgule flottante qui représente l'emplacement et la taille d'un rectangle.

Syntaxe


var rect = {
    height : /* Votre valeur */,
    width : /* Votre valeur */,
    x : /* Votre valeur */,
    y : /* Votre valeur */
}


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


XAML Values

x

Emplacement de la coordonnée x du côté gauche du rectangle.

y

Emplacement de la coordonnée y du côté supérieur du rectangle.

width

Valeur qui représente la Width du rectangle.

height

Valeur qui représente la Height du rectangle.

Attributs

[Version(0x06020000)]

Membres

RectStructure possède ces types de membres :

Constructeurs

RectStructure possède ces constructeurs.

ConstructeurDescription
Rect(Double, Double, Double, Double) [C#, VB]Initializes a Rect structure that has the specified x-coordinate, y-coordinate, width, and height.
Rect(float, float, float, float) [C++, JavaScript]Initializes a Rect structure that has the specified x-coordinate, y-coordinate, width, and height.
Rect(Point, Point) Initializes a Rect structure that is exactly large enough to contain the two specified points.
Rect(Point, Size) Initializes a Rect structure based on an origin and size.

 

Champs

RectStructure possède ces champs.

ChampType de donnéesDescription
Height | height [C++, JavaScript]

Number [JavaScript] | System.Single [.NET] | float32 [C++]

Hauteur du rectangle.

Width | width [C++, JavaScript]

Number [JavaScript] | System.Single [.NET] | float32 [C++]

Largeur du rectangle.

X | x [C++, JavaScript]

Number [JavaScript] | System.Single [.NET] | float32 [C++]

Coordonnée x de l'angle supérieur gauche du rectangle.

Y | y [C++, JavaScript]

Number [JavaScript] | System.Single [.NET] | float32 [C++]

Coordonnée y de l'angle supérieur gauche du rectangle.

 

Méthodes

The Rect Structure a les méthodes suivantes. Avec C#, Visual Basic et C++, elle hérite également des méthodes de Object Classe.

MéthodeDescription
Contains Indicates whether the rectangle described by the Rect contains the specified point.
Equals(Object) [C#, VB]Determines whether the specified object is equal to a Rect.
Equals(Rect) [C#, VB]Compares two Rect structures for equality.
GetHashCode [C#, VB]Gets a hash code for this object.
Intersect Finds the intersection of the rectangle represented by the current Rect and the rectangle represented by the specified Rect, and stores the result as the current Rect.
IntersectsWith [C++, JavaScript]Indicates whether the specified rectangle intersects with the current rectangle.
ToString [C#, VB]Converts a Rect to a String representation.
ToString(IFormatProvider) [C#, VB]Creates a String representation of this Rect.
Union(Point) Expands the rectangle represented by the current Rect exactly enough to contain the specified point.
Union(Rect) Expands the rectangle represented by the current Rect exactly enough to contain the specified rectangle.

 

Opérateurs

RectStructure possède ces opérateurs.

OpérateurDescription
Equality Compares two Rect structures for equality.
Inequality Compares two Rect structures for inequality.

 

Propriétés

Le RectStructure a les propriétés suivantes.

PropriétéType d'accèsDescription

Bottom

En lecture seuleGets the y-axis value of the bottom of the rectangle.

Empty

En lecture seuleGets a special value that represents a rectangle with no position or area.

Height

Lecture/écritureGets or sets the height of the rectangle.

IsEmpty

En lecture seuleGets a value that indicates whether the rectangle is the Empty rectangle.

Left

En lecture seuleGets the x-axis value of the left side of the rectangle.

Right

En lecture seuleGets the x-axis value of the right side of the rectangle.

Top

En lecture seuleGets the y-axis position of the top of the rectangle.

Width

Lecture/écritureGets or sets the width of the rectangle.

X

Lecture/écritureGets or sets the x-axis value of the left side of the rectangle.

Y

Lecture/écritureGets or sets the y-axis value of the top side of the rectangle.

 

Remarques

Une fois appliquées aux propriétés qui représentent les informations d'interface utilisateur, les valeurs de largeur et de hauteur d'une valeur Rect représentent des pixels indépendants du périphérique. Les valeurs x et y représentent un point dans l'espace de coordonnées de la fenêtre d'application principale.

JavaScript:  Avec JavaScript, un Rect est un objet avec quatre propriétés des données : x, y, width et height. Outre les propriétés de données, les API répertoriées dans les listes de membres Rect ne s'appliquent pas à la programmation JavaScript.

Remarques sur la syntaxe XAML

L'utilisation d'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 standard.

Vous pouvez utiliser un espace plutôt qu'une virgule comme délimiteur de valeurs. Les utilisations de délimiteurs mixtes 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 aucune autre convention n'existe qui puisse analyser moins de quatre valeurs dans la chaîne que vous fournissez pour la syntaxe de l'attribut XAML.

Rect ne peut pas être déclaré comme une ressource dans ResourceDictionary, car son type ne peut pas être partagé.

Projection et membres de Rect

Si vous utilisez un langage Microsoft .NET (C# ou Microsoft Visual Basic) ou les extensions de composants Visual C++ (C++/CX), Rect possède des membres qui ne sont pas des données et ses membres de données sont exposés en tant que propriétés en lecture/écriture et non en tant que champs.

Si vous programmez en C++ à l'aide de la bibliothèque de modèles Windows Runtime (WRL), seuls les champs des données membres existent en tant que membres de Rect, et vous ne pouvez pas utiliser les méthodes ou propriétés utilitaires répertoriées dans le tableau des membres. Le code WRL peut accéder aux méthodes utilitaires similaires qui sont disponibles à partir de la classe statique RectHelper.

Valeurs Rect et leur interprétation par les propriétés

Size est une structure similaire qui utilise la même métaphore de spécification d'une hauteur et d'une largeur. Toutefois, Rect spécifie un point d'origine, contrairement à Size. En général Rect est utilisé pour les API de bibliothèque de graphiques, et Size est utilisé pour la présentation et la disposition dans l'interface utilisateur d'application.

Le comportement caractéristique d'une valeur Rect, tel qu'il est interprété par les propriétés, suit les principes suivants :

  • Les valeurs Width et Height ne peuvent pas être négatives.
  • X et Y peuvent être négatifs, la définition de Rect se trouvant alors hors du frame de référence des coordonnées, à moins qu'il n'y ait une translation supplémentaire.
  • X et Y peuvent avoir la valeur 0. Une valeur de 0 est également valide pour Width ou Height. Toutefois, si un Rect dont la valeur Width ou Height est égale à 0 est appliqué à un RectangleGeometry, le RectangleGeometry qui en résulte n'assure pas de restitution.
  • 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. Les définitions d'interface utilisateur XAML fonctionnent et s'affichent mieux lorsque les emplacements de points et les mesures d'unité n'utilisent pas de valeurs inférieures au pixel.

Conditions requises

Client minimal pris en charge

Windows 8

Serveur minimal pris en charge

Windows Server 2012

Téléphone minimal pris en charge

Windows Phone 8

Espace de noms

Windows.Foundation
Windows::Foundation [C++]

Métadonnées

Platform.winmd
Windows.winmd

Assembly

System.Runtime.WindowsRuntime.dll

Voir aussi

Size
RectHelper

 

 

Afficher:
© 2014 Microsoft