Syntaxe XAML pour les tracés

Les chemins d’accès sont abordés dans Les formes et le dessin de base dans WPF Overview et geometry Overview. Toutefois, cette rubrique décrit en détail le mini-langage puissant et complexe que vous pouvez utiliser pour spécifier des géométries de chemin plus compactes à l’aide du langage XAML (Extensible Application Markup Language).

Prérequis

Pour comprendre cette rubrique, vous devez être familiarisé avec les fonctionnalités de base des Geometry objets. Pour plus d’informations, consultez Vue d’ensemble de Geometry.

Mini langages StreamGeometry et PathFigureCollection

WPF fournit deux classes qui fournissent des mini-langages pour décrire des chemins géométriques : StreamGeometry et PathFigureCollection.

• Vous utilisez le mini-langage lors de la StreamGeometry définition d’une propriété de type Geometry, telle que la Clip propriété d’un UIElement élément ou la Data propriété d’un Path élément. L’exemple suivant utilise la syntaxe d’attribut pour créer un StreamGeometry.

  <Path Stroke="Black" Fill="Gray"
        Data="M 10,100 C 10,300 300,-200 300,100" />
  

• Vous utilisez la mini-langue lors de la PathFigureCollection définition de la Figures propriété d’un PathGeometry. L’exemple suivant utilise une syntaxe d’attribut pour créer un PathFigureCollection pour un PathGeometry.

  <Path Stroke="Black" Fill="Gray">
    <Path.Data>
      <PathGeometry Figures="M 10,100 C 10,300 300,-200 300,100" />
    </Path.Data>
  </Path>
  

Comme vous pouvez le constater dans les exemples précédents, les deux mini langages sont très similaires. Il est toujours possible d’utiliser une PathGeometry situation dans laquelle vous pourriez utiliser un StreamGeometry; de sorte qu’il faut l’utiliser ? Utilisez une StreamGeometry fois que vous n’avez pas besoin de modifier le chemin après la création de celui-ci ; utilisez un PathGeometry si vous avez besoin de modifier le chemin d’accès.

Pour plus d’informations sur les différences entre les objets et StreamGeometry les PathGeometry objets, consultez la vue d’ensemble de la géométrie.

Remarque à propos des espaces blancs

Par souci de concision, un seul espace est indiqué dans les sections de syntaxe qui suivent, mais plusieurs espaces sont également acceptables partout où un seul espace est affiché.

Deux nombres n’ont pas besoin d’être séparés par une virgule ou un espace blanc, mais cela ne peut être fait que lorsque la chaîne résultante n’est pas ambiguë. Par exemple, 2..3 il s’agit en fait de deux nombres : « 2 ». Et . 3 ». De même, 2-3 est « 2 » et « -3 ». Les espaces ne sont pas requis avant ou après les commandes.

Syntaxe

La syntaxe d’utilisation de l’attribut XAML (Extensible Application Markup Language) pour une StreamGeometry est composée d’une valeur facultative FillRule et d’une ou plusieurs descriptions de figure.

La syntaxe d’utilisation de l’attribut XAML (Extensible Application Markup Language) pour une PathFigureCollection figure est composée d’une ou plusieurs descriptions de figure.

Commande move

Spécifie le point de départ d’une nouvelle figure.

Un majuscule M indique qu’il startPoint s’agit d’une valeur absolue ; une minuscule m indique qu’il startPoint s’agit d’un décalage vers le point précédent, ou (0,0) si aucun n’existe. Si vous énumérez plusieurs points après la commande move, une ligne est tracée entre ces points, même si vous avez spécifié la commande line.

Commandes draw

Une commande draw peut se composer de plusieurs commandes shape. Les commandes shape suivantes sont disponibles : line, horizontal line, vertical line, cubic Bezier curve, quadratic Bezier curve, smooth cubic Bezier curve, smooth quadratic Bezier curve et elliptical arc.

Vous entrez chaque commande en utilisant une majuscule ou une minuscule : les majuscules indiquent des valeurs absolues et les minuscules indiquent des valeurs relatives : les points de contrôle pour ce segment sont relatifs au point de fin de l’exemple précédent.

Commande line

Crée une ligne droite entre le point actuel et le point de fin spécifié. l 20 30et L 20,30 sont des exemples de commandes de ligne valides.

Un majuscule L indique qu’il endPoint s’agit d’une valeur absolue ; une minuscule l indique qu’il endPoint s’agit d’un décalage vers le point précédent, ou (0,0) si aucun n’existe.

Commande Horizontal Line

Crée une ligne horizontale entre le point actuel et la coordonnée x spécifiée. H 90 est un exemple de commande horizontal line valide.

Un majuscule H indique qu’il x s’agit d’une valeur absolue ; une minuscule h indique qu’il x s’agit d’un décalage vers le point précédent, ou (0,0) si aucun n’existe.

Commande Vertical Line

Crée une ligne verticale entre le point actuel et la coordonnée y spécifiée. v 90 est un exemple de commande vertical line valide.

Un majuscule V indique qu’il y s’agit d’une valeur absolue ; une minuscule v indique qu’il y s’agit d’un décalage vers le point précédent, ou (0,0) si aucun n’existe.

Commande Cubic Bezier Curve

Crée une courbe de Bezier cubique entre le point actuel et le point de terminaison spécifié à l’aide des deux points de contrôle spécifiés (controlPoint1 et controlPoint2). C 100,200 200,400 300,200 est un exemple de commande curve valide.

Commande Quadratic Bezier Curve

Crée une courbe de Bezier quadratique entre le point actuel et le point de terminaison spécifié à l’aide du point de contrôle spécifié (controlPoint). q 100,200 300,200 est un exemple de commande quadratic Bezier curve valide.

Commande Smooth cubic Bezier curve

Crée une courbe de Bézier cubique lissée entre le point actuel et le point de fin spécifié. Le premier point de contrôle est supposé être la réflexion du deuxième point de contrôle de la commande précédente par rapport au point actuel. S’il n’existe pas de commande précédente, ou si la commande précédente n’était pas une commande cubic Bezier curve ni une commande smooth cubic Bezier curve, imaginez que le premier point de contrôle coïncide avec le point actuel. Le deuxième point de contrôle, le point de contrôle pour la fin de la courbe, est spécifié par controlPoint2. Par exemple, S 100,200 200,300 il s’agit d’une commande de courbe bezier lisse valide.

Commande Smooth quadratic Bezier curve

Crée une courbe de Bézier quadratique lissée entre le point actuel et le point de fin spécifié. Le point de contrôle est supposé être la réflexion du point de contrôle de la commande précédente par rapport au point actuel. S’il n’existe pas de commande précédente, ou si la commande précédente n’était pas une commande quadratic Bezier curve ni une commande smooth quadratic Bezier curve, le point de contrôle coïncide avec le point actuel.

Commande Elliptical Arc

Crée un arc elliptique entre le point actuel et le point de fin spécifié.

Commande close

Termine la figure actuelle et crée une ligne qui relie le point actuel au point de départ de la figure. Cette commande crée une jonction de ligne (angle) entre le dernier segment et le premier segment de la figure.

Syntaxe de point

Décrit les coordonnées x et y d’un point où (0,0) est le coin supérieur gauche.

Valeurs spéciales

Plutôt que d’utiliser une valeur numérique standard, vous pouvez opter pour les valeurs spéciales suivantes. Ces valeurs sont sensibles à la casse.

Infinité
Représente Double.PositiveInfinity.

-Infini
Représente Double.NegativeInfinity.

NaN
Représente Double.NaN.

Vous pouvez également utiliser la notation scientifique. Par exemple, +1.e17 est une valeur valide.

Voir aussi

• Path
• StreamGeometry
• PathGeometry
• PathFigureCollection
• Vue d’ensemble des formes et dessins de base dans WPF
• Vue d’ensemble de Geometry
• Guides pratiques