Point Structure

Représente une paire ordonnée de coordonnées x et y qui définissent un point dans un plan à deux dimensions.

Syntaxe


var point = {
    x : /* Votre valeur */,
    y : /* Votre valeur */
}


<object property="X,Y"/>
-or
<object property="X Y"/>

XAML Values

X

Composant de la coordonnée x de la valeur Point.

Y

Composant de la coordonnée y de la valeur Point.

Attributs

[Version(0x06020000)]

Membres

PointStructure possède ces types de membres :

Constructeurs

PointStructure possède ces constructeurs.

ConstructeurDescription
Point [C#, VB]Initializes a Point structure that contains the specified values.
Point [C++, JavaScript]Initializes a Point structure that contains the specified values.

 

Champs

PointStructure possède ces champs.

ChampType de donnéesDescription
X | x [C++, JavaScript]

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

Position horizontale du point.

Y | y [C++, JavaScript]

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

Position verticale du point.

 

Méthodes

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

MéthodeDescription
Equals(Object) [C#, VB]Determines whether the specified object is equal to a Point.
Equals(Point) [C#, VB]Compares two Point structures for equality.
GetHashCode [C#, VB]Gets a hash code for this object.
ToString [C#, VB]Converts a Point to a String representation.
ToString(IFormatProvider) [C#, VB]Creates a String representation of this Point.

 

Opérateurs

PointStructure possède ces opérateurs.

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

 

Propriétés

Le PointStructure a les propriétés suivantes.

PropriétéType d'accèsDescription

X

Lecture/écritureGets or sets the X-coordinate value of this Point.

Y

Lecture/écritureGets or sets the Y-coordinate value of this Point.

 

Remarques

Une valeur Point représente parfois un espace de coordonnées dans le plan de la fenêtre principale d'une application, mais il existe d'autres interprétations possibles des valeurs Point qui peuvent varier, selon la propriété qui utilise la valeur Point.

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

Remarques sur la syntaxe XAML

Les valeurs Point sont utilisées massivement pour les propriétés de graphiques et les propriétés d'interface utilisateur similaires dans tout le vocabulaire XAML pour les éléments d'interface utilisateur Windows.

Vous pouvez utiliser un espace ou une virgule comme délimiteur entre X et Y. La convention commune pour les points de coordonnées est d'utiliser une virgule comme séparateur.

Les structures Point ne peuvent pas être déclarées comme ressources dans un ResourceDictionary.

Certaines utilisations XAML utilisent le type Point pour représenter un point logique. Consultez la section « Points logiques » dans les Notes.

Projection et membres de Point

Si vous utilisez un langage Microsoft .NET (C# ou Microsoft Visual Basic) ou les extensions de composants Visual C++ (C++/CX), Point 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 Point, 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 PointHelper.

Valeurs de point et leur interprétation par les propriétés

Certaines utilisations (mais pas toutes) du type Point spécifient l'emplacement dans un espace de coordonnées. Selon le contexte, l'emplacement peut se trouver dans un frame de la zone de contenu de référence, ou peut être dans le frame de référence pour un élément de disposition spécifique.

X et Y pour Point peuvent être des valeurs non entières dans certains cas.

X et Y pour un Point peuvent être négatifs dans certains cas. En général, cela provoque un Point qui spécifie une coordonnée qui est délibérément en dehors du frame de référence, à moins qu'il n'existe une autre translation. Toutefois, certaines propriétés XAML rejettent Point avec X ou Y négatif comme valeur non valide. Les contraintes de valeur sont généralement indiquées dans les pages de référence des propriétés.

Points logiques

Certaines utilisations du type Point dans les applications Windows Store en C++, C# ou Visual Basic ne concernent pas directement les frames de coordonnées de référence. Il s'agit de points logiques, pour lesquels les valeurs de X et Y doivent en principe être comprises entre 0 et 1 (inclus). C'est un scénario majeur en raison duquel les valeurs X et Y peuvent être des valeurs à virgule flottante plutôt qu'être limitées aux valeurs entières. Les valeurs de point logique sont interprétées de telle façon que les coordonnées d'exécution pour la présentation ou le comportement peuvent être spécifiées ou modifiées par une propriété ou un paramètre différent. Ou les points expriment parfois des informations qui ne concernent pas du tout l'espace de coordonnées. Comme exemples du concept de point logique, citons les valeurs de Animation.KeySpline (contrôle la vitesse d'une animation), la propriété RenderTransformOrigin d'un UIElement et les valeurs GradientStop.Offset d'un LinearGradientBrush.

Une propriété de valeur Point qui est une utilisation de point logique peut refuser les valeurs inférieures à 0, ou supérieures à 1, mais ce comportement dépend de la propriété spécifique. Les contraintes de valeur sont généralement notées dans les pages de référence des propriétés individuelles plutôt que sur la valeur.

Valeurs de point et API de graphiques XAML

Les éléments graphiques permettant de définir une interface utilisateur XAML utilisent souvent les propriétés de valeur Point pour déclarer leurs caractéristiques. Par exemple, EllipseGeometry utilise une valeur Point pour définir sa propriété Center.

Les éléments graphiques utilisent un des deux modèles. Certains éléments graphiques sont dérivés de FrameworkElement. Ces éléments ont un comportement de rendu défini lorsqu'ils sont placés dans une interface utilisateur et lorsque les propriétés d'élément sont assignées. Des exemples de ce type d'élément sont Rectangle et tous les autres types de l'espace de noms d'Windows.UI.Xaml.Shapes. D'autres éléments graphiques ne dérivent pas de FrameworkElement et n'ont pas leur propre comportement de rendu. Au lieu de cela, ces éléments sont composés pour fournir la valeur d'une propriété sur un autre élément ayant un comportement de rendu. Par exemple, les éléments graphiques que vous utilisez pour composer Path.Data, tels que LineSegment, ont souvent une propriété de valeur Point.

Certains éléments graphiques utilisent plusieurs valeurs de points représentées dans une seule propriété. Ces propriétés utilisent le type PointCollection. Ces propriétés prennent également en charge une syntaxe XAML qui analyse la chaîne d'attribut pour obtenir des valeurs X et des valeurs Y pour plusieurs points. Un exemple de propriété d'élément graphique qui utilise PointCollection est Polygon.Points.

Valeurs de point des événements d'entrée XAML et pour le test d'atteinte

Une valeur Point est retournée par les données d'événement pour certains événements d'entrée. Par exemple, GetCurrentPoint fournit une valeur de coordonnée de l'emplacement où un événement Pointer s'est produit dans l'interface utilisateur de l'application. En général, ces valeurs Point font référence à un certain frame de référence des coordonnées et il est important de connaître ce frame de référence. Pour les événements d'entrée, le cadre de référence est la fenêtre principale de l'application, et non l'écran global. Cela active un frame de référence cohérent si l'application est en vue alignée. Certaines API telles que GetCurrentPoint et GetPosition permettent également de convertir en un frame de référence spécifique à un élément, qui est utile lorsque l'entrée est utilisée dans un contrôle individuel. Pour plus d'informations, consultez Démarrage rapide : pointeurs.

L'interface utilisateur XAML possède également un concept appelé test d'atteinte, dans lequel vous pouvez utiliser des méthodes d'utilitaire pour tester l'origine des événements d'entrée si l'utilisateur doit exécuter une action de pointeur dans un emplacement de coordonnées particulier de l'interface utilisateur. Par exemple, 2 signatures de FindElementsInHostCoordinates utilisent un paramètre d'entrée Point, comme FindSubElementsForTouchTargeting. Pour plus d'informations, consultez Réponse à l’entrée de la souris.

Valeurs de points d'animation

Windows Runtime permet également d'animer les valeurs d'une propriété qui utilise un Point comme valeur et qui est implémentée comme une propriété de dépendance. Point possède sa propre prise en charge d'animations car il est impossible d'animer individuellement les valeurs X et Y d'un Point, car les structures ne peuvent pas prendre en charge les propriétés de dépendance. Utilisez le type PointAnimation pour les animations de-à, ou utilisez les types dérivés PointAnimationUsingKeyFrames pour le comportement d'animation des images clés. Pour plus d'informations sur l'animation d'une valeur Point et sur le fonctionnement des animations, consultez Animations avec plan conceptuel.

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

Windows.winmd
Platform.winmd

Assembly

System.Runtime.WindowsRuntime.dll

Voir aussi

PointAnimation
PointCollection
Démarrage rapide : pointeurs
Démarrage rapide : dessiner des formes

 

 

Afficher:
© 2015 Microsoft