.. highlightlang:: us

.. index:: y^edit-conditionalformatting

.. _edit_conditional_formatting:

Edit=>Bedingte Formatierung
---------------------------

Mit Hilfe der bedingten Formatierung kann in einer Tabelle die
Zellfarbe und die Schriftfarbe geändert werden, wenn bestimmte Bedingungen
erfüllt sind. Beispielsweise kann die Zelle hellrot gefüllt werden, wenn der 
angezeigte Wert größer als ein Schwellwert ist.

Um eine neue Bedingung zu definieren, gehen Sie wie folgt vor:

*  Markieren Sie in der Tabelle die Zellen, die formatiert werden sollen. Das
   kann beispielsweise eine einzelne Zelle, eine ganze Zeile oder ein 
   größerer Bereich sein.

*  Klicken Sie dann in der Markierung mit der rechten Maustaste und 
   wählen das Kommando *Bedingte Formatierung=>Neue Regel*, um das 
   folgende Dialogfeld zu öffnen. Sie können entweder eine Regel definieren,
   die den Zellwert mit einer Konstanten vergleicht oder einen 
   Formelausdruck verwenden.

.. image:: S:/uniplot-obj/images/TableConditionalFormat_Add-de.*

.. us.dialog

.. us.dlgitem

**Zellbezug**

   Legt den Zellbezug für die Formatierung im A1-Stil fest (Spalte wird mit 
   Buchstabe und Zeile mit Zahl definiert). Der Zellbezug kan eine einzelne 
   Zelle, z. B. C2 oder einen Bereich definieren, z. B. A1:C4.

.. us.dlgitem

**Alle Zellen basierend auf Ihren Werten formatieren**

   Wenn diese Option markiert ist, wird der Zellwert mit dem ausgewählten Operator
   mit dem Wert **Wert 1**  verglichen.

      Lister der Vergleichsoperatoren:

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

         * - Operator
         * - größer als (>)
         * - größer oder gleich (>=)
         * - kleiner als (<)
         * - kleiner oder gleich (<=)
         * - zwischen  (>= v1 && < v2)
         * - nicht zwischen (< v1 || > v2)
         * - gleich (==)
         * - nicht gleich (!=)

.. us.dlgitem

**Wert 1**
   Ist ein reeller Wert. Dezimalzeichen ist ein Punkt.

.. us.dlgitem

**Wert 2**

   Ist ein reeller Wert. Dieser Wert wird für den Operator``zwischen`` und 
   ``nicht zwischen`` verwendet.

.. us.dlgitem

**Alle Zellen basierend auf dem Ausdruck formatieren**

   Wenn der Ausdruck den Wert TRUE (1) liefert, werden die Zellen formatiert.
   In einem Ausdruck können alle UniScript-Funkionen verwendet werden. Das
   Ergebnis des Ausdrucks muss ein Zahlenwert sein.

.. us.dlgitem

**Ausdruck**

   In einem Ausdruck können Sie die Vergleichsoperatoren aus der Tabelle oben
   verwenden (``>``, ``>=``, ``<``, ``>=``, ``==``, ``!=``). Die Bedingungen
   können UND (``&&``) und  ODER (``||``) Verknüpft werden. 

   Liste mit Beispielen:

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

         * - Ausdruck
           - Beschreibung
         * - ``A1 > 10``
           - Wenn der Wert in Zelle A1 größer als 10 ist, liefert der Ausdruck TRUE (1) zurück.
         * - ``B2 > C2``
           - Wenn der Wert in der Zelle B2 größer als der Wert in der Zelle C2 ist, liefert der Ausdruck TRUE (1) zurück.
         * - ``sum(B2:E2) <= 10`` 
           - Wenn die Summe der Werte B2 bis E2 <= 10 ist, iefert der Ausdruck TRUE (1) zurück.
         * - ``A1 > B1 && A1 < C2``
           - Zell A1 zwischen den Werten von B1 und C1.

.. us.dlgitem

**Füllfarbe**

   Die Ausgewählte Farbe wird für die Zelle verwendet, wenn der Ausdruck TRUE (1) 
   ist.

.. us.dlgitem

**Schriftfarbe**

   Die ausgewählte Farbe wird für die Schriftfarbe der Zelle verwendet, wenn der 
   Ausdruck TRUE (1) ist.

Liste der bedingten Formatierungen
----------------------------------

Mit Hilfe des folgenden Dialogs können Regeln zugefügt, gelöscht oder bearbeitet
werden.

.. image:: S:/uniplot-obj/images/TableConditionalFormat_Manage-de.*

.. us.dialog

.. us.dlgitem

**Liste der bedingten Formatierungen**

   Jede Zeile in der Liste zeigt eine Regel für die bedingte Formatierung an.
   Die Reglen werden in der angezeigten Reihenfolge ausgewertet.

UniScript-Interface
-------------------

Mit der Funktion **TableFormatCondition_AddFormat** kann in UniScript
eine bedingte Formatierung für eine Tabelle definiert werden. Die Bedingung
wird als Objekt an die Funktion übergeben. Beispiel::

   oFormat = [. sqref = "a1:a2",  
                type = "cellvalue", 
                formula = ["less", "0"], 
                format = "fill-color = 'cyan' font-color = 'red'"];
   TableFormatCondition_AddFormat(hTable, oFormat)

Die Farben können auch als RGB-Farbe definiert werden::

   oFormat.format = "fill-color = 'rgb(255,0,0)' font-color = 'rgb(100,100,100)'";

Namen der Operatoren: greater, between, notbetween, greaterequal, less, lessequal,
equal, notequal.

Weitere Beispiele::

   oFormat = [. sqref = "a1", type = "cellvalue",  formula = ["between", "10", "20"], format = fill-color='rgb(255,0,0)'];
   oFormat = [. sqref = "a1", type = "cellvalue",  formula = ["between", "10", "20"], format = fill-color='rgb(255,0,0)'];
   oFormat = [. sqref = "C4:G4",  type = "expression", formula = "(C4 < D4)",  format = fill-color='green'];
   oFormat = [. sqref = "D9:G13", type = "expression", formula = "(D9/1000 > 0.46)", format = fill-color='rgb(255,0,0)'];

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - R2018.6
     - Neu.

.. seealso::
   :ref:`edit-objecttable-configuration`,
   :ref:`edit-objecttable`

:sub:`id-1237658`