.. highlightlang:: us

.. _xyseterrorbarconfig:

XYSetErrorbarConfig
===================

.. index:: XYSetErrorbarConfig

.. us.tag  XYSetErrorbarConfig GERMAN XYSet New400

:ref:`XYSetErrorbarConfig` setzt die Fehlerbalkeneinstellungen.

.. function::  bool = XYSetErrorbarConfig(hData, ssXY, rvConfig)

.. 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:: ssXY

   *ssXY* ist ein skalarer String. Für den String "X" wird die Konfiguration der 
   x-Fehlerbalken und für "Y" die Konfiguration der y-Fehlerbalken erfragt.

.. uparam:: rvConfig

   *rvConfig* ist ein Vektor mit 5 Elementen:

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

      * - Wert
        - Name
        - Bedeutung
      * - rvConfig[1]
        - Pen
        - Pen Handle des Zeichenstifts.
      * - rvConfig[2]
        - LineWidthCap
        - Liniendicke der Querstrichs in Schritten von 0.1 mm.
      * - rvConfig[3]
        - CapWidth
        - Breite des Querstrichs in cm. Bei einer Breite von 0 wird kein Querstrich gezeichnet.
      * - rvConfig[4]
        - dValue
        - Fehlerwert. Die Bedeutung ist abhängig vom Attribut-Wert.
      * - rvConfig[5]
        - Attribut
        - Siehe nächste Tabelle.

   Das Element rvConfig[5] (Attribut) kann eine Kombination der folgenden Werte sein: 

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

      * - Name
        - Wert
        - Bedeutung
      * - 
        - 0
        - Keine Fehlerbalken ausgeben
      * - ERRORBAR_PERCENT
        - 1
        - Fehlerwert in Prozent
      * - ERRORBAR_CONSTANT
        - 2
        - Fehlerwert absolut
      * - ERRORBAR_PLUS
        - 8
        - Positiven Fehlerbalken ausgeben
      * - ERRORBAR_MINUS
        - 16
        - Negativen Fehlerbalken ausgeben
      * - ERRORBAR_PLUSMINUS
        - 24
        - Positiven und negativen Fehlerbalken ausgeben

.. us.comment

**Kommentar**

Die Funktion liefert eine Kopie des Zeichenstifts. Nachdem der Zeichenstift 
nicht mehr benötigt wird, muss er mit :ref:`PenDestroy` gelöscht werden, um ein
Speicherleck zu vermeiden.

.. us.example

**Beispiel**

::

       XYSetStyle(hData, XY_SHOWLINE | XY_SHOWERRORBARS);
       rvConfig = XYGetErrorbarConfig(hData, "Y");
       rvConfig[4] = 0.03; // Percent
       rvConfig[5] = ERRORBAR_PERCENT | ERRORBAR_PLUSMINUS; // Attrib
       XYSetErrorbarConfig(hData, "Y", rvConfig);
       PenDestroy(rvConfig[1]);  // Delete Pen
       // Do not display x-errorbars
       rvConfig = XYGetErrorbarConfig(hData, "X");
       rvConfig[5] = 0; // switch off
       XYSetErrorbarConfig(hData, "X", rvConfig);
       PenDestroy(rvConfig[1]);  // Delete Pen

.. seealso::
   :ref:`uberblick-xy-datensatze`,
   :ref:`XYCreate`,
   :ref:`XYGetErrorbarConfig`

:sub:`id-288974`