FMX.Graphics.TPathData.Data

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

property Data: string read GetPathString write SetPathString stored False;

C++

__property System::UnicodeString Data = {read=GetPathString, write=SetPathString, stored=false};

Propriétés

Type Visibilité  Source Unité  Parent
property published
FMX.Graphics.pas
FMX.Graphics.hpp
FMX.Graphics TPathData


Description

Spécifie le TPathData en cours par une séquence de caractères.

Data est une chaîne formée de caractères indiquant le type et les coordonnées des points des formes primitives pour le TPathData en cours. Définissez Data pour définir et remplir TPathData avec des formes primitives.

Lors de sa définition, la valeur Data a la structure suivante :

 'caractère' 'points ou valeurs'[ 'forme suivante'].

'caractère' spécifie le type de la forme.

'points ou valeurs' indique les coordonnées des points ou les valeurs qui définissent la forme.

Une ligne ou un point déplacé est spécifié par un point, et une courbe est spécifiée par trois points. Si la ligne est verticale ou horizontale, il est nécessaire de spécifier respectivement seulement la coordonnée Y ou X de la fin de la ligne.

Les coordonnées d'un point sont séparées par ',' (virgule) ou ' '(espace). Deux formes consécutives sont séparées par ',' ou ' '. Si la forme est définie par plusieurs points et valeurs, ils sont séparés par ',' ou ' '.

'caractère' peut prendre les valeurs suivantes :

Valeur Signification

'z'

Définit un chemin d'accès fermé.

'Z'

Définit un chemin d'accès fermé.

'M'

Définit un point déplacé en appelant MoveTo. Si plusieurs points se trouvent après 'M', des lignes sont ajoutées pour relier les points dans l’ordre dans lequel ils apparaissent dans la chaîne.

'm'

Définit un point déplacé en appelant MoveToRel. Si plusieurs points se trouvent après 'm', des lignes sont ajoutées pour relier les points dans l’ordre dans lequel ils apparaissent dans la chaîne.

'L'

Définit une séquence d'une ou de plusieurs lignes, ajoutées en appelant LineTo. Les lignes ajoutées relient les points dans l’ordre dans lequel ils apparaissent dans la chaîne.

'l'

Définit une séquence d'une ou de plusieurs lignes, ajoutées en appelant LineToRel. Les lignes ajoutées relient les points dans l’ordre dans lequel ils apparaissent dans la chaîne.

'C'

Définit une séquence d'une ou de plusieurs courbes, ajoutées en appelant CurveTo. Les courbes ajoutées relient les points dans l’ordre dans lequel ils apparaissent dans la chaîne.

'c'

Définit une séquence d'une ou de plusieurs courbes, ajoutées en appelant CurveToRel. Les courbes ajoutées relient les points dans l’ordre dans lequel ils apparaissent dans la chaîne.

'S'

Définit une séquence d'une ou de plusieurs courbes lisses, ajoutées en appelant SmoothCurveTo. Les courbes ajoutées relient les points dans l’ordre dans lequel ils apparaissent dans la chaîne.

's'

Définit une séquence d'une ou de plusieurs courbes lisses, ajoutées en appelant SmoothCurveToRel. Les courbes ajoutées relient les points dans l’ordre dans lequel ils apparaissent dans la chaîne.

'H'

Définit une ligne, ajoutée en appelant HLineTo.

'h'

Définit une ligne, ajoutée en appelant HLineToRel.

'V'

Définit une ligne, ajoutée en appelant VLineTo.

'v'

Définit une ligne, ajoutée en appelant VLineToRel.

'A'

Définit un arc. Un arc est défini par le point central, les rayons de l'ellipse parent, l'angle de l'arc, deux indicateurs et le point de fin.

'a'

Définit un arc. Les coordonnées de l'arc sont calculées par rapport au dernier point de TPathData. Un arc est défini par le point central, les rayons de l'ellipse parent, l'angle de l'arc, deux indicateurs et le point de fin.

Exemple :

 //déplacer le point de départ à (20,20)
 // ajouter trois lignes, une courbe et un arc
 Mypath.Data:='m20,20 L40,10 50,30 140,100 C20,30 100,180 250,200 A15,15,90,90,90,150,150 z';

Lors de son obtention, la valeur Data a la structure suivante :

 'caractère' 'points'[ 'forme suivante'].

'caractère' spécifie le type de la forme ou du point.

'points' spécifie les points définissant la forme.

'caractère' peut prendre les valeurs suivantes :

Valeur Signification

'Z'

Définit un chemin d'accès fermé.

'M'

Définit un point déplacé.

'L'

Définit une ligne.

'C'

Définit une courbe.

Exemple :

 str:=Mypath.Data;
 //Le résultat est : str='M 20,20 L 40,10 L 50,30 L 140,100 C 20,30 100,180 250,200 Z ';

Voir aussi