plotSetXGridPen
==============================================

Purpose
----------------
Controls the thickness, color, and style for the x-axis grid lines.

Format
----------------
.. function:: plotSetXGridPen(&myPlot, which_grid, thickness[, clr[, style]])

    :param &myPlot: A :class:`plotControl` structure pointer.
    :type &myPlot: struct pointer

    :param which_grid: The grid to modify, ``"major"``, ``"minor"``, or ``"both"``.
    :type which_grid: string

    :param thickness: the thickness of the specified x-axis grid lines in pixels.
    :type thickness: Scalar

    :param clr: Optional argument, name or rgb value of the new color for the specified x-axis grid lines.
    :type clr: string

    :param style: the style of the pen. Options include:

        .. include:: include/plotpenstyletable.rst

    :type style: Scalar

Examples
----------------
.. figure:: _static/images/plotsetxgridpen-cr.png
   :scale: 50 %

::

    // Declare plotControl structure
    struct plotControl myPlot;

    // Initialize plotControl structure
    myPlot = plotGetDefaults("scatter");

    // Set the major grid lines to be 0.5 px, black, and dashed
    plotSetXGridPen(&myPlot, "major", 0.5, "Black", 2);

    // Create a scatter plot of random data
    plotScatter(myPlot, seqa(1, 1, 10 ), rndn(10, 1));


Remarks
-------
Please note that :func:`plotSetXGridPen` is not supported for bar, box, or histogram plots.

.. include:: include/plotattrremark.rst
.. include:: include/plotsetactivexremark.rst

.. seealso:: Functions :func:`plotSetActiveX`, :func:`plotSetYGridPen`, :func:`plotSetGridPen`