.. highlightlang:: us

.. _pensetstyle:

PenSetStyle
===========

.. index:: PenSetStyle

.. us.tag  PenSetStyle ENGLISH

:ref:`PenSetStyle` sets the line style of a pen object.

.. function::  bool = PenSetStyle(hPen, nStyle)

.. us.return

**Return Value**

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

.. us.params

**Parameters**

.. uparam:: hPen

   Identifies the pen.

.. uparam:: nStyle

   *nStyle* is one of the following values:

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

   * - Value
     - Meaning
   * - PS_SOLID
     - solid line pen
   * - PS_DASH
     - dash pen
   * - PS_DOT
     - dot pen
   * - PS_DASHDOT
     - dash dot pen
   * - PS_DASHDOTDOT
     - dash dot dot pen
   * - PS_NULL
     - invisible pen

.. seealso::
   :ref:`overview-pens`,
   :ref:`PenCreate`

:sub:`id-1443077`