.. highlightlang:: us

.. index:: G_ConfigureLine

.. _g_configureline:

G_ConfigureLine
===============

.. us.tag  G_ConfigureLine NOTREADYENGLISH

:ref:`G_ConfigureLine` configures the pattern which is used to draw lines for
datasets.

.. function::  bool = G_ConfigureLine(nLineType, rvLineStyle)

.. us.return

**Return Value**

*bool*

.. us.params

**Parameters**

.. uparam:: nLineType

   *nLineType* is one of the following values:

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

      * - Value
        - Meaning
      * - PS_DASH
        - 
      * - PS_DOT
        - 
      * - PS_DASHDOT
        - 
      * - PS_DASHDOTDOT
        - 

.. uparam:: rvLineStyle

   *rvLineStyle* is a vector wit 2 to 16 elements. Positive values specify the
   length of a line in 0.1 mm steps. Negative values specify the length of a gap
   in 0.1 mm steps. The valid range for a line is 0 to 500 and for a gap 0 to 250.
   The first element must be a line. A line element must be followed by a gap
   and vice versa.

.. us.example

**Example**

The startup file contains the following four calls with the default settings.

::

   G_ConfigureLine(PS_DASH, [30, -4]);
   G_ConfigureLine(PS_DOT, [4, -4]);
   G_ConfigureLine(PS_DASHDOT, [40, -4, 5, -4]);
   G_ConfigureLine(PS_DASHDOTDOT, [40, -4, 5, -4, 5, -4]);

.. seealso::
   :ref:`loadlib`

:sub:`id-1291773`