FMX.Graphics.TPathData.Data

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

property Data: string read GetPathString write SetPathString stored False;

C++

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

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
property published
FMX.Graphics.pas
FMX.Graphics.hpp
FMX.Graphics TPathData

Beschreibung

Gibt das aktuelle TPathData-Objekt durch eine Zeichenfolge an.

Data ist ein String, der aus Zeichen besteht, die den Typ und die Koordinaten der Punkte der Grundformen für das aktuelle TPathData-Objekt angeben. Setzen Sie Data, um das TPathData-Objekt zu definieren und es mit Grundformen zu füllen.

Beim Zuweisen hat der Wert der Eigenschaft Data die folgende Struktur:

 'character' 'points or values'[ 'next shape'].

'character' gibt den Typ der Form an.

'points or values' gibt die Koordinaten des Punktes oder die Werte an, die die Form festlegen.

Ein verschobener Punkt oder eine Linie wird durch einen Punkt, eine Kurve durch drei Punkte festgelegt. Bei einer vertikalen oder horizontalen Linie muss nur die Y- bzw. X-Koordinate des Linienendes angegeben werden.

Die Koordinaten eines Punktes werden durch ',' (Komma) oder ' ' (Leerzeichen) getrennt. Zwei aufeinander folgende Formen werden durch ',' oder ' ' getrennt. Wenn die Form durch mehr als einen Punkt und Wert definiert ist, werden diese durch ',' oder ' ' getrennt.

Für 'character' sind folgende Werte möglich:

Wert Bedeutung

'z'

Definiert einen geschlossenen Pfad.

'Z'

Definiert einen geschlossenen Pfad.

'M'

Definiert einen Punkt, der mit der Methode MoveTo verschoben wird. Wenn nach 'M' mehrere Punkte vorhanden sind, werden Linien zum Verbinden der Punkte in der Reihenfolge hinzugefügt, in der die Punkte im String aufgeführt sind.

'm'

Definiert einen Punkt, der mit der Methode MoveToRel verschoben wird. Wenn nach 'm' mehrere Punkte vorhanden sind, werden Linien zum Verbinden der Punkte in der Reihenfolge hinzugefügt, in der die Punkte im String aufgeführt sind.

'L'

Definiert eine Folge von einer oder mehreren Linien, die mit der Methode LineTo hinzugefügt werden. Die hinzugefügten Linien verbinden die Punkte in der Reihenfolge, in der die Punkte im String aufgeführt sind.

'l'

Definiert eine Folge von einer oder mehreren Linien, die mit der Methode LineToRel hinzugefügt werden. Die hinzugefügten Linien verbinden die Punkte in der Reihenfolge, in der die Punkte im String aufgeführt sind.

'C'

Definiert eine Folge von einer oder mehreren Kurven, die mit der Methode CurveTo hinzugefügt werden. Die hinzugefügten Kurven verbinden die Punkte in der Reihenfolge, in der die Punkte im String aufgeführt sind.

'c'

Definiert eine Folge von einer oder mehreren Kurven, die mit der Methode CurveToRel hinzugefügt werden. Die hinzugefügten Kurven verbinden die Punkte in der Reihenfolge, in der die Punkte im String aufgeführt sind.

'S'

Definiert eine Folge von einer oder mehreren geglätteten Kurven, die mit der Methode SmoothCurveTo hinzugefügt werden. Die hinzugefügten Kurven verbinden die Punkte in der Reiehenfolge, in der die Punkte im String aufgeführt sind.

's'

Definiert eine Folge von einer oder mehreren geglätteten Kurven, die mit der Methode SmoothCurveToRel hinzugefügt werden. Die hinzugefügten Kurven verbinden die Punkte in der Reihenfolge, in der die Punkte im String aufgeführt sind.

'H'

Definiert eine Linie, die mit der Methode HLineTo hinzugefügt wird.

'h'

Definiert eine Linie, die mit der Methode HLineToRel hinzugefügt wird.

'V'

Definiert eine Linie, die mit der Methode VLineTo hinzugefügt wird.

'v'

Definiert eine Linie, die mit der Methode VLineToRel hinzugefügt wird.

'A'

Definiert einen Bogen. Ein Bogen wird durch den Mittelpunkt, die Strahlen der übergeordneten Ellipse, den Winkel des Bogens, zwei Flags und den Endpunkt definiert.

'a'

Definiert einen Bogen. Die Koordinaten des Bogens werden bezogen auf den letzten Punkt von TPathData berechnet. Ein Bogen wird durch den Mittelpunkt, die Strahlen der übergeordneten Ellipse, den Winkel des Bogens, zwei Flags und den Endpunkt definiert.

Beispiel:

//der Startpunkt wurde auf (20,20) verschoben
//3 Linien, eine Kurve und ein Bogen wurden hinzugefügt
Mypath.Data:='m20,20 L40,10 50,30 140,100 C20,30 100,180 250,200 A15,15,90,90,90,150,150 z';

Beim Ermitteln hat der Wert der Eigenschaft Data die folgende Struktur:

 'character' 'points'[ 'next shape'].

'character' gibt den Typ der Form oder den Punkt an.

'points' gibt die Punkte an, die die Form definieren.

Für 'character' sind folgende Werte möglich:

Wert Bedeutung

'Z'

Definiert einen geschlossenen Pfad.

'M'

Definiert einen verschobenen Punkt.

'L'

Definiert eine Linie.

'C'

Definiert eine Kurve.

Beispiel:

str:=Mypath.Data;
//Das Ergebnis ist: str='M 20,20 L 40,10 L 50,30 L 140,100 C 20,30 100,180 250,200 Z ';

Siehe auch