.. highlightlang:: us

.. _auto_xy_setstyleattribs:

auto_xy_SetStyleAttribs
=======================

.. index:: auto_xy_SetStyleAttribs

.. us.tag  auto_xy_SetStyleAttribs GERMAN auto_xy

Die Funktion setzt für eine Kurve die Linien- und Marker-
Darstellung. Die Funktion greift nicht auf die Stildatei zu.

.. function::  bool = auto_xy_SetStyleAttribs(hData, PropName, PropValue)
    bool = auto_xy_SetStyleAttribs(hData, PropName, PropValue, PropName, PropValue)

.. 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 eines 1D oder 2D-Datensatzes. Die
   Zugriffsnummer wird z. B. von der Funktion :ref:`auto_LoadDataset` zurück
   geliefert.

.. uparam:: PropName

   *PropName* ist eine Zeichenkette, die den Wert ``"Line"`` oder ``"Marker"``
   annehmen kann. Abhängig vom Wert folgt dem Parameter *PropName* ein Vektor mit
   den Attributwerten. Die Vektorelemente werden durch ein Komma getrennt und in
   eckige Klammern eingeschlossen (siehe Beispiel).

.. uparam:: PropValue

   *PropValue* ist ein Vektor mit den Attributwerten.

   **Line**
      Für den Wert ``PropName = "Line"`` hat der Vektor 5 Elemente:

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

         * - Wert
           - Bedeutung
         * - rvLine[1]
           - Linientyp (0 bis 5)
         * - rvLine[2]
           - Linienbreite in 0.1 mm Schritten
         * - rvLine[3,4,5]
           - Rot, Grün, Blau-Anteil der Linienfarbe (0 bis 255)

   **Marker**
      Für den Wert *PropName* = ``"Marker"`` hat der Vektor 9 oder 10 Elemente:

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

         * - Wert
           - Bedeutung
         * - rvMarker[1]
           - Markertyp (0 bis 20)
         * - rvMarker[2]
           - Durchmesser in Zentimetern
         * - rvMarker[3,4,5]
           - Linienfarbe: Rot, Grün, Blau-Anteil (0 bis 255)
         * - rvMarker[6,7,8]
           - Füllfarbe: Rot, Grün, Blau-Anteil (0 bis 255)
         * - rvMarker[9]
           - Linienbreite in 0.1 mm Schritten
         * - rvMarker[10]
           - (Optional) Füllung: 0: Opaque, 1: Transparent, Defaultwert: 0.

   **Markertyp**
      Als Markertyp kann ein Wert zwischen 0 und 20 oder der entsprechende Alias
      gewählt werden (z. B. 3 oder ``MS_CIRCLE``):

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

         * - Wert
           - Bedeutung
         * - (0) MS_PLUS
           - Plus-Zeichen
         * - (1) MS_CROSS
           - Kreuz
         * - (2) MS_SIMPLESTAR
           - Stern
         * - (3) MS_CIRCLE
           - Kreis
         * - (4) MS_RECTANGLE
           - Rechteck
         * - (5) MS_DIAMOND
           - Raute
         * - (6) MS_TRIANGLE
           - Dreieck
         * - (7) MS_TRIANGLE1
           - Dreieck um 90 Grad gedreht
         * - (8) MS_TRIANGLE2
           - Dreieck um 180 Grad gedreht
         * - (9) MS_TRIANGLE3
           - Dreieck um 270 Grad gedreht
         * - (10) MS_HOURGLASS
           - Zwei Dreiecke
         * - (11) MS_HOURGLASS1
           - Zwei Dreiecke um 90 Grad gedreht
         * - (12) MS_STAR
           - Stern
         * - (13) MS_CIRCLEDOT
           - Kreis mit Punkt
         * - (14) MS_CIRCLEPLUS
           - Kreis mit Plus-Zeichen
         * - (15) MS_CIRCLECROSS
           - Kreis mit Kreuz
         * - (16) MS_RECTDOT
           - Rechteck mit Punkt
         * - (17) MS_RECTPLUS
           - Rechteck mit Plus-Zeichen
         * - (18) MS_RECTCROSS
           - Rechteck mit Kreuz
         * - (19) MS_NULL
           - keine Ausgabe
         * - (20) MS_DOT
           - kleinster darstellbarer Punkt

.. us.example

**Beispiel**

Beispielaufrufe

::

   auto_xy_SetStyleAttribs(hData, "Line", [0, 4, 255, 0, 0], ...
           "Marker", [3, 0.15, 0, 0, 0, 255, 0, 0 , 1]);

   auto_xy_SetStyleAttribs(hData, "Line", [0, 4, 255, 0, 0]);

   auto_xy_SetStyleAttribs(hData, "Marker", [3, 0.15, 0, 0, 0, 255, 0, 0 , 1]);

   auto_xy_SetStyleAttribs(hData, "Marker", ...
                  [MS_CIRCLE, 0.15, 0, 0, 0, 255, 0, 0 , 1]);

   rvMarker = [MS_CIRCLE, 0.15, 0, 0, 0, 255, 0, 0 , 1]
   auto_xy_SetStyleAttribs(hData, "Marker", rvMarker);

Ein vollständiges Beispiel

::

   auto_AddToUI("Examples", "Example", "RS_Example");

   def RS_Example()
   {
       rmColor = [255,0,0; 0,0,255]; // Red, Blue

       auto_SetFileNameDialogInit("*.dat;*.nc");
       svFile = auto_GetFileNameDialog(2);
       if (svFile[1] == "DLG_CANCEL") {
       return;
       }

       auto_LoadTemplate("Example.ipw");

       nFile = len(svFile);
       for (i in 1:nFile) {
       auto_ImportData(svFile[i]);
       hData = auto_LoadDataset("Diagramm 1", "Zeitkanal", "LAMBDA");
       auto_xy_SetStyleAttribs(hData, ...
               "Line", [0, 4, rmColor[i;]], ...
               "Marker", [3, 0.15, 0, 0, 0 ,rmColor[i;], 1]);
       hData = auto_LoadDataset("Diagramm 2", "Zeitkanal", "TMOT");
       auto_xy_SetStyleAttribs(hData, "Line", [0, 4, rmColor[i;]]);
       }
       auto_ScaleAxes();
       auto_UpdatePage();
   }

.. seealso::
   :ref:`uberblick-automatisierung-der-diagrammerstellung`,
   :ref:`auto_LoadDataset`,
   :ref:`PenCreate`,
   :ref:`MarkerCreate`,
   :ref:`XYSetStyle`,
   :ref:`XYSetPen`,
   :ref:`XYSetMarker`

:sub:`id-61470`