.. highlightlang:: us

.. index:: FontCreate

.. _fontcreate:

FontCreate
==========

.. us.tag  FontCreate GERMAN

:ref:`FontCreate` erzeugt einen Font.

.. function::  hFont = FontCreate()
    hFont = FontCreate(hFontOld)
    hFont = FontCreate(rsHeight, nWeight, rsPitchAndFamily, ssFaceName, bUnderline, bItalic, bStrikeOut, rsAngle, rvColorRGB)

.. us.return

**Returnwert**

*hFont* ist die Zugriffsnummer (handle) des erzeugten Fonts oder 0, wenn der Font
nicht erzeugt werden konnte.

.. us.params

**Parameter**

.. uparam:: hFontOld

   *hFontOld* ist eine Zugriffsnummer auf einen Font. Die Anweisung
   ``hFontNew = FontCreate(hFontOld)`` erzeugt eine Kopie von *hFontOld*.

.. uparam:: rsHeight

   *rsHeight* ist die Höhe des Fonts in Punkten (pt). 28.453pt sind 1cm. Der
   Zeichensatz in Büchern/Zeitschriften hat ca. 10pt.

.. uparam:: nWeight

   *nWeight* gibt an wie "fett" ein Font ist. *nWeight* kann einen der
   folgenden Werte annehmen:

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

      * - Wert
        - Bedeutung
      * - FW_DONTCARE (0)
        - überläßt Windows die Einstellung
      * - FW_THIN (100)
        - Hauchdünn
      * - FW_EXTRALIGHT (200)
        - Sehr dünn
      * - FW_LIGHT (300)
        - Dünn
      * - FW_NORMAL (400)
        - Normal
      * - FW_MEDIUM (500)
        - Mittel
      * - FW_SEMIBOLD (600)
        - Halbfett
      * - FW_BOLD (700)
        - Fett
      * - FW_EXTRABOLD (800)
        - Sehr Fett
      * - FW_HEAVY (900)
        - Extra Fett

.. uparam:: rsPitchAndFamily

   *rsPitchAndFamily* ist einer der folgenden Werte:

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

      * - Wert
        - Bedeutung
      * - DEFAULT_PITCH
        - Zeichenbreite ist nicht festgelegt
      * - FIXED_PITCH
        - Schrift mit konstanter Zeichenbreite
      * - VARIABLE_PITCH
        - Schrift mit variabler Zeichenbreite
      * - FF_DONTCARE
        - Nicht klassifizierte Schrift
      * - FF_ROMAN
        - Schrift mit Serifen (Times Roman, Century Schoolbook, etc.)
      * - FF_SWISS
        - Schrift ohne Serifen aber mit variabler Liniendicke, wie zum Beispiel Helvetica, Swiss, etc.
      * - FF_MODERN
        - Schrift ohne Serifen mit gleichmäßiger Liniendicke (Pica, Elite, Courier, etc.)
      * - FF_SCRIPT
        - Schreibschrift ähnliche Schrift (Cursive etc.)
      * - FF_DECORATIVE
        - Schmuckschrift (Old English, etc.)

.. uparam:: ssFaceName

   *ssFaceName* ist der Name des Fonts, z. B. ``"Courier"``

.. uparam:: bUnderline

   *bUnderline* ist TRUE (1), wenn der Font unterstrichen werden soll.

.. uparam:: bItalic

   *bItalic* ist TRUE (1), wenn der Font italic ist.

.. uparam:: bStrikeOut

   *bStrikeOut* ist TRUE (1), wenn der Font durchgestrichen dargestellt werden soll.

.. uparam:: rsAngle

   *rsAngle* ist der Winkel des Fonts im Bereich 0 bis 360 Grad.

.. uparam:: rvColorRGB

   *rvColorRGB* ein Vektor mit drei Elementen, der die Farbe des Fonts angibt:

   .. 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

.. seealso::
   :ref:`uberblick-fonts`,
   :ref:`FontDestroy`,
   :ref:`FontDialog`,
   :ref:`LayerSetAxisLabelFont`,
   :ref:`LayerSetAxisTitleFont`,
   :ref:`TBSetFont`,
   :ref:`XYZSetIsoLabelFont`,
   :ref:`XYZSetMarkerLabelFont`

:sub:`id-1015183`