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)‘. Der folgende Wert setzt zusätzlich die Transparenz: ‚argb(127,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-fill-alpha	int	'255'	'0': transparent, '255': opaque, Exception: The value '1' sets alpha to opaque to be compatible to older versions.
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'
fill-alpha	int	'255'	'0': transparent, '255': opaque, Exception: The value '1' sets alpha to opaque to be compatible with older versions.
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)‘ or ‚argb(127, 255,0,0)‘
marker-fill-alpha	int	'255'	'0': transparent, '255': opaque, Exception: The value '1' sets alpha to opaque to be compatible with older versions.
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

Siehe auch

Überblick XY-Datensätze, XYGetProps, XYSetDefault, XYZSetProps

_id-428776