.. highlightlang:: us

.. index:: ObjCreate

.. _objcreate:

ObjCreate
=========

.. us.tag  ObjCreate GERMAN

:ref:`ObjCreate` erzeugt ein Objekt.

.. function::  handle = ObjCreate(nClass)
               handle = ObjCreate(nClass, dat1, ...)

.. us.return

**Returnwert**

handle ist eine Zugriffsnummer, wenn die Funktion erfolgreich war, oder 0, wenn
das Objekt nicht erzeugt werden konnte.

.. us.params

**Parameter**

.. uparam:: nClass

   nClass ist einer der folgenden Werte:

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

      * - Wert
        - Bedeutung
      * - ``OBJ_APPLICATION``
        - Von diesem Objekt gibt es nur eins. Es wird beim Start von UniPlot
          automatisch erzeugt.
      * - ``OBJ_DOCUMENT``
        - siehe :ref:`DocCreate`.
      * - ``OBJ_EDITOR``
        - siehe :ref:`EdCreate`.
      * - ``OBJ_LAYER``
        - siehe :ref:`LayerCreate`.
      * - ``OBJ_XYDATASET``
        - siehe :ref:`XYCreate` und :ref:`TYCreate`.
      * - ``OBJ_XYZDATASET``
        - siehe :ref:`XYZCreate` and :ref:`XYZCreateFromMatrix`.
      * - ``OBJ_TEXT``
        - siehe :ref:`TBCreate`.
      * - ``OBJ_RECT``
        - siehe :ref:`RBCreate`.
      * - ``OBJ_ELLIPSE``
        - siehe :ref:`EBCreate`.
      * - ``OBJ_LINE``
        - siehe :ref:`LBCreate`.
      * - ``OBJ_LINK``
        - siehe :ref:`CBCreate`.
      * - ``OBJ_PEN``
        - siehe :ref:`PenCreate`.
      * - ``OBJ_MARKER``
        - siehe :ref:`MarkerCreate`.
      * - ``OBJ_FONT``
        - siehe :ref:`FontCreate`.
      * - ``OBJ_FILE``
        - siehe :ref:`fopen`.
      * - ``OBJ_CONTAINER``
        - siehe :ref:`CnCreate`.

.. uparam:: dat1

   Der Typ und die Anzahl von Daten zur Erzeugung des Objekts, hängen vom Typ
   des Objekts ab.

.. us.comment

**Kommentar**

Normalerweise wird nicht die Funktion :ref:`ObjCreate` aufgerufen, sondern eine
"verpackte" Funktion. Z. B. ruft man anstatt der Funktion
``ObjCreate("OBJ_DOCUMENT")`` die Funktion :ref:`DocCreate` auf.

.. seealso::
   :ref:`uberblick-objekte`,
   :ref:`ObjDestroy`

:sub:`id-148201`