.. highlightlang:: us

.. index:: HatchCreate

.. _hatchcreate:

HatchCreate
===========

.. us.tag  HatchCreate NOTREADYGERMAN HATCH_Create Changed427

:ref:`HatchCreate` erzeugt ein Schraffur-Objekt, das an einen Datensatz übergeben
werden kann.

.. function::  hHatch = HatchCreate()
    hHatch = HatchCreate(hHatchOther)
    hHatch = HatchCreate(nStyle, rsDistance, rsOffset, nWidth, rvColorRGB)

.. us.return

**Returnwert**

*hHatch* ist die Zugriffsnummer (Handle) mit der auf das Schraffur-Objekt
zugegriffen werden kann. Falls das Objekt nicht erzeugt werden kann ist
*hHatch* gleich 0.

.. us.params

**Parameter**

.. uparam:: hHatchOther

   *hHatchOther* enthält ein Schraffur-Objekt-Handle der kopiert werden soll.

.. uparam:: nStyle

   *nStyle* ist eine ODER-verknüpfte Kombination der folgenden Werte:

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

      * - Wert
        - Bedeutung
      * - HATCH_0
        - Schraffur mit Winkel 0 Grad
      * - HATCH_45
        - Schraffur mit Winkel 45 Grad
      * - HATCH_90
        - Schraffur mit Winkel 90 Grad
      * - HATCH_135
        - Schraffur mit Winkel 135 Grad

.. uparam:: rsDistance

   *rsDistance* ist der Abstand benachbarter Linien in Zentimetern.

.. uparam:: rsOffset

   *rsOffset* ist die Verschiebung des Schraffur-Ursprungs in Zentimetern.

.. uparam:: nWidth

   *nWidth* ist die Dicke der Schraffur-Linien in 0.1 mm.

.. uparam:: rvColorRGB

   *rvColorRGB* ein Vektor mit drei Elementen, der die Farbe der Schraffur-Linien
   festlegt:

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

      * - Wert
        - Bedeutung
      * - rvColorRGB[1]
        - Rotanteil der Farbe im Bereich 0 bis 255
      * - rvColorRGB[2]
        - Grünanteil der Farbe im Bereich 0 bis 255
      * - rvColorRGB[3]
        - Blauanteil der Farbe im Bereich 0 bis 255

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - 4.2.7
     - Funktion kann auch mit einem Parameter aufgerufen werden (Kopier-Konstruktor).

.. seealso::
   :ref:`uberblick-schraffuren`,
   :ref:`HatchDestroy`,
   :ref:`XYGetHatch`,
   :ref:`XYSetHatch`,
   :ref:`ObjCopy`

:sub:`id-245745`