.. highlightlang:: us

.. index:: FontSetWeight

.. _fontsetweight:

FontSetWeight
=============

.. us.tag  FontSetWeight ENGLISH FontSet

:ref:`FontSetWeight`  Specifies the weight of the font, in the range 0 through
1000 (for example, 400 is normal and 700 is bold).

.. function::  bool = FontSetWeight(hFont, nWeight)

.. us.return

**Return Value**

If the function succeeds, the return value is TRUE (1); otherwise it is FALSE (0).

.. us.params

**Parameters**

.. uparam:: hFont

   Identifies the font.

.. uparam:: nWeight

   *nWeight*  is set in the range 0 through 1000:

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

      * - Value
        - Meaning
      * - FW_DONTCARE (0)
        - Lets Windows choose settings
      * - FW_THIN (100)
        - Extra Thin
      * - FW_EXTRALIGHT (200)
        - Very Thin
      * - FW_LIGHT (300)
        - Thin
      * - FW_NORMAL (400)
        - Normal
      * - FW_MEDIUM (500)
        - Medium
      * - FW_SEMIBOLD (600)
        - Half Bold
      * - FW_BOLD (700)
        - Bold
      * - FW_EXTRABOLD (800)
        - Very Bold
      * - FW_HEAVY (900)
        - Extra Bold

.. seealso::
   :ref:`overview-fonts`,
   :ref:`FontCreate`,
   :ref:`FontDialog`,
   :ref:`FontGetWeight`

:sub:`id-1352857`