.. highlightlang:: us

.. index:: XYSetProps

.. _xysetprops:

XYSetProps
==========

.. us.tag  XYSetProps NOTREADYGERMAN New403 XYSet

:ref:`XYSetProps` setzt Eigenschaften eines x/y-Datensatzes.

.. function::  bool = XYSetProps(hData, ssProps)

.. us.return

**Returnwert**

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

.. us.params

**Parameter**

.. uparam:: hData

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

.. uparam:: ssProps

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

.. us.example

**Beispiel**

::

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

.. us.comment

**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:

.. list-table::
   :header-rows: 0

   * - '0'
     - 'solid'
   * - '1'
     - 'dash'
   * - '2'
     - 'dot'
   * - '3'
     - 'dashdot'
   * - '4'
     - 'dashdotdot'

marker_style kann die folgenden Werte annehmen:

.. list-table::
   :header-rows: 0

   * - '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'

.. list-table::
   :header-rows: 1

   * - 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 :ref:`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.

.. list-table::
   :header-rows: 0

   * - '0'
     - Horizontal
   * - '1'
     - Vertikal

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

.. list-table::
   :header-rows: 0

   * - '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 
:ref:`filterfunktionen-fur-xy-datensatze`.

.. us.example

**Beispiel**

::

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

**Farbtabelle**

.. image:: S:/uniplot-obj/images/color-table.*

.. seealso::
   :ref:`uberblick-xy-datensatze`,
   :ref:`XYGetProps`,
   :ref:`XYSetDefault`,
   :ref:`XYZSetProps`

:sub:`id-428776`