.. highlightlang:: us

.. index:: AppSetUserColorTable
.. index:: User Colors

.. _appsetusercolortable:

AppSetUserColorTable
====================

.. us.tag  AppSetUserColorTable ENGLISH App New5100

The function :ref:`AppSetUserColorTable` sets the user colors.

.. function::  bool = AppSetUserColorTable(rvColors)

.. us.return

**Return Value**

.. us.params

**Parameters**

.. uparam:: rvColors

   *rvColors*

.. us.example

**Example**

Set the first 8 colors

::

   // rvColorRef = Color_RGB_to_COLORREF(rmColorRGB)
   // rmColorRGB = Color_COLORREF_to_RGB(rvColorRef)
   // rmColorRGB: Matrix with 3 columns

   // Read the user colors
   rvC = AppGetUserColorTable()
   rvC[1] = Color_RGB_to_COLORREF([127,231,123]);
   rvC[2] = Color_RGB_to_COLORREF([127,0,127]);
   ...
   rvC[8] = Color_RGB_to_COLORREF([255,127,0]);
   // Write the new users colors
   AppSetUserColorTable(rvC)

.. us.history

**History**

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

   * - Version
     - Description
   * - 5.10.0
     - New

.. seealso::
   :ref:`overview-application-object`,
   :ref:`AppGetUserColorTable`

:sub:`id-310126`