XYSetProps

XYSetProps setzt Eigenschaften eines x/y-Datensatzes.

bool = XYSetProps(hData, ssProps)

Returnwert

bool ist TRUE (1) wenn die Funktion erfolgreich war, und sonst FALSE (0).

Parameter

hData

hData ist die Zugriffsnummer (Handle) des Datensatzes der mit XYCreate oder TYCreate erzeugt wurde.

ssProps

ssProps ist ein String mit NAME='WERT'-Paaren mit den Eigenschaften.

Beispiel

XYSetProps(hData, "marker='1'  marker-style='circle'");

Kommentar

In der folgenden Tabelle sind alle Eigenschaften (Properties), die gesetzt werden können, aufgeführt. In der Spalte Typ wird der Wertebereich der Eigenschaften festgelegt. Folgende Typen existieren: bool, int, double, color, curve_style, marker_style.

bool kann die Werte ‚0‘ oder ‚1‘ annehmen. ‚0‘ bedeutet ausgeschaltet (off, false) und ‚1‘ eingeschaltet (on, true).

int ist eine ganze Zahl (‚1‘, ‚-1‘, ‚144‘).

double ist eine Gleitkommazahl wie ‚1.23‘, ‚5000‘, ‚1e3‘.

color ist ein Name wie ‚mediumblue‘ (siehe Farbtabelle unten), ein Zahlenwert wie ‚#0000CD‘ oder ein Ausdruck der Form ‚rgb(0,0,205)‘.

curve_style kann die folgenden Werte annehmen:

‚0‘ ‚solid‘
‚1‘ ‚dash‘
‚2‘ ‚dot‘
‚3‘ ‚dashdot‘
‚4‘ ‚dashdotdot‘

marker_style kann die folgenden Werte annehmen:

‚0‘ ‚plus‘
‚1‘ ‚cross‘
‚2‘ ‚simplestar‘
‚3‘ ‚circle‘
‚4‘ ‚rectangle‘
‚5‘ ‚diamond‘
‚6‘ ‚triangle‘
‚7‘ ‚triangle1‘
‚8‘ ‚triangle2‘
‚9‘ ‚triangle3‘
‚10‘ ‚hourglass‘
‚11‘ ‚hourglass‘
‚12‘ ‚star‘
‚13‘ ‚circledot‘
‚14‘ ‚circleplus‘
‚15‘ ‚circlecross‘
‚16‘ ‚rectdot‘
‚17‘ ‚rectplus‘
‚18‘ ‚rectcross‘
‚19‘ ‚null‘
‚20‘ ‚dot‘
Eigenschaft Typ Default-Wert Anmerkung
bar bool '0'  
bar-base-pos int '1' ‚0‘: Bar origin is the minimum axis value, ‚1‘ The origin is set to the drop value (see XYSetDropValue).
bar-fill-color color 'red' color can be specified as: ‚red‘ or ‚#FF0000‘ or ‚rgb(255,0,0)‘
bar-hatch-color color 'black' color can be specified as: ‚red‘ or ‚#FF0000‘ or ‚rgb(255,0,0)‘
bar-hatch-distance double '0.3' Distance between the hatch lines in centimeters.
bar-hatch-offset double '0.0'  
bar-hatch-style int '2'  
bar-hatch-width int '2'  
bar-pen-color color 'black' color can be specified as: ‚red‘ or ‚#FF0000‘ or ‚rgb(255,0,0)‘
bar-pen-type curve_style 'solid'  
bar-pen-width int '4'  
bar-pos double '0'  
bar-type int '0'  
bar-width double '0.5'  
bar-width-type int '0' 0 = width in centimers, 1 = width in percent of the diagram width.
bar-fill-type int '1'  
curve bool '1'  
curve-color color 'black' color can be specified as: ‚red‘ or ‚#FF0000‘ or ‚rgb(255,0,0)‘
curve-style curve_style 'solid' possible values: ‚0‘ or ‚solid‘ , ‚1‘ or ‚dash‘, ‚2‘ or’dot‘, ‚3‘ or ‚dashdot‘, ‚4‘ or ‚dashdotdot‘.
curve-width int '4'  
data-scale-x-factor double '1.0'  
data-scale-x-offset double '0.0'  
data-scale-y-factor double '1.0'  
data-scale-y-offset double '0.0'  
drop-pen bool '0'  
drop-pen-color color 'black' color can be specified as: ‚red‘ or ‚#FF0000‘ or ‚rgb(255,0,0)‘
drop-pen-style int '0'  
drop-pen-width int '1'  
err-bar bool '0'  
err-bar-x-attrib int '0'  
err-bar-x-cap-pen-width int '2'  
err-bar-x-cap-width double '0.2'  
err-bar-x-pen-color color 'black' color can be specified as: ‚red‘ or ‚#FF0000‘ or ‚rgb(255,0,0)‘
err-bar-x-pen-style curve_style 'solid'  
err-bar-x-pen-width int '1'  
err-bar-x-value double '0.03'  
err-bar-y-attrib int '0'  
err-bar-y-cap-pen-width int '2'  
err-bar-y-cap-width double '0.2'  
err-bar-y-pen-color color 'black' color can be specified as: ‚red‘ or ‚#FF0000‘ or ‚rgb(255,0,0)‘
err-bar-y-pen-style curve_style 'solid'  
err-bar-y-pen-width int '1'  
err-bar-y-value double '0.03'  
fill bool '0'  
fill-color color 'red'  
filter-functions string ''  
filter-functions-on int '0'  
hatch bool '0'  
hatch-color color 'black' color can be specified as: ‚red‘ or ‚#FF0000‘ or ‚rgb(255,0,0)‘
hatch-distance double '0.3'  
hatch-offset double '0.0'  
hatch-style int '2'  
hatch-width double '2'  
info-text string '\*'  
legend-text string '\*'  
marker int '0'  
marker-edge-color color 'black' color can be specified as: ‚red‘ or ‚#FF0000‘ or ‚rgb(255,0,0)‘
marker-edge-width int '1'  
marker-fill-color color 'red' color can be specified as: ‚red‘ or ‚#FF0000‘ or ‚rgb(255,0,0)‘
marker-frequency int '1'  
marker-original bool '1'  
marker-size double '0.2'  
marker-style marker_style 'circle'  
marker-transparent bool '0'  
name string ''  
x-delta double '0.0'  
x-start double '0.0'  
y-base double '0.0'  

Anmerkungen:

bar-type legt Balkenausrichtung fest.

‚0‘ Horizontal
‚1‘ Vertikal

bar-fill-type legt die Füllung der Balken fest.

‚0‘ Keine Füllung
‚1‘ Füllung mit Farbe
‚2‘ Füllung mit Schraffur
‚3‘ Füllung mit Farbe und Schraffur

filter-functions legt die Filterfunktionen fest. Die Funktionen werden durch ein Semikolon getrennt. Als Filter stehen beispielsweise Glättungsfunktionen und Splinefunktionen zur Verfügung. Individuelle Filter können zugefügt werden. Eine Liste der Filterfunktionen finden Sie unter Filterfunktionen für XY-Datensätze.

Beispiel

XYSetProps(hData, "filter-functions-on='1' filter-functions='sort(); akimaspline()'");

Farbtabelle

../../_images/color-table.png

id-428776