.. highlightlang:: us

.. index:: auto_xyz_CreateColorLegend

.. _auto_xyz_createcolorlegend:

auto_xyz_CreateColorLegend
==========================

.. us.tag  auto_xyz_CreateColorLegend ENGLISH auto_xyz Changed550

:ref:`auto_xyz_CreateColorLegend` creates a color legend for the given 3D dataset.

.. function::  hTable = auto_xyz_CreateColorLegend(hData)

.. us.return

**Return Value**

*hTable* is the handle of the color legend. The color legend is a table object.

.. us.params

**Parameters**

.. uparam:: hData

   *hData* is the handle of a 3D dataset.

.. us.comment

**Comment**

The color legend is drawn on the right side of the diagram. The color legend uses
the field function :ref:`@f{update3dcolorlegendtable}`. To set the field function
parameters right click on the legend and choose settings.

.. us.history

**History**

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

   * - Version
     - Description
   * - 5.5.0
     - A table object is used.

.. seealso::
   :ref:`overview-automation`,
   :ref:`auto_LoadDataset`

:sub:`id-356410`