.. highlightlang:: us

.. index:: ObjSetUserData

.. _objsetuserdata:

ObjSetUserData
==============

.. us.tag  ObjSetUserData ENGLISH New5120

:ref:`ObjSetUserData` saves a data-object created by :ref:`obj_create` in a
UniPlot-object (dataset, diagram, page, drawing object, etc.).

.. function::  bool = ObjSetUserData(handle, ssObjectName, obj)
               bool = ObjSetUserData(handle, ssObjectName, obj, ssCallbackFuncName)

.. us.return

**Return Value**

bool

.. us.params

**Parameters**

.. uparam:: handle

   *handle* identifies the object (Dataset, Drawing Objekt, 
   Diagram, etc.).

.. uparam:: ssObjectName

   *ssObjectName* is a name under the data object *obj* is saved in the
   UniPlot-object.

.. uparam:: obj

   *obj* is an object created with :ref:`obj_create`. To remove an object
   from the UniPlot-object, set *obj* to 0.

.. uparam:: ssCallbackFuncName

   *ssCallbackFuncName* is an optional name of a UniScript function. In the
   current version only a callback function for data tooltips is supported.
   See :ref:`ObjGetUserData` for an example.

.. us.history

**History**

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

   * - Version
     - Description
   * - 5.12.0
     - New

.. seealso::
   :ref:`overview-objects`,
   :ref:`ObjCreate`,
   :ref:`ObjSetName`,
   :ref:`ObjGetUserData`

:sub:`id-284977`