plotSetXGridPen

Purpose

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

Format

plotSetXGridPen(&myPlot, which_grid, thickness[, clr[, style]])
Parameters:
  • &myPlot (struct pointer) – A plotControl structure pointer.

  • which_grid (string) – The grid to modify, "major", "minor", or "both".

  • thickness (Scalar) – the thickness of the specified x-axis grid lines in pixels.

  • clr (string) – Optional argument, name or rgb value of the new color for the specified x-axis grid lines.

  • style (Scalar) –

    the style of the pen. Options include:

    1

    Solid line.

    2

    Dash line.

    3

    Dot line.

    4

    Dash-Dot line.

    5

    Dash-Dot-Dot line.

Examples

_images/plotsetxgridpen-cr.png
// 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 plotSetXGridPen() is not supported for bar, box, or histogram plots.

Note

This function sets an attribute in a plotControl structure. It does not affect an existing graph, or a new graph drawn using the default settings that are accessible from the Tools > Preferences > Graphics menu.

The axis updated by this function is determined by the value previously specified by plotSetActiveX(). The accepted values are "bottom" (default), "top", and "both".

Future calls to plotSetActiveX() will not retroactively change the values of a previously modified axis.