LayerSetAxesAttribsΒΆ

The LayerSetAxesAttribs sets display attribs for the x an y axis.

bool = LayerSetAxesAttribs(hLayer, nAttrib)

Return Value

bool is TRUE (1) if the function was successful and otherwise FALSE (0).

Parameters

hLayer

hLayer is the handle of a diagram (layer).

nAttrib

nAttrib is an or combination of the following values:

Define

Value

Description

YAXIS_STACKEDDIA_LABELFREE

1

The axis scaling can be set independently of the stacked diagram grid settings. Otherwise the scaling is adjusted to the grid. This setting has no effect, if the diagram is not part of a stacked diagram. If the axis belongs to a stacked diagram, only two blue handles at to top and bottom of the diagram box are displayed. Otherwise 8 blue handles are displayed.

XAXIS_PROTECTTITLE

2

The axis title can only be set manually. If the attribute is not set, the axis title will be updated if a new dataset is loaded.

XAXIS_AUTOTITLE

4

The x-channel name of the first dataset will be displayed as an axis title.

YAXIS_PROTECTTITLE

8

The axis title can only be set manually. If the attribute is not, set the axis title will be updated if a new dataset is loaded.

YAXIS_AUTOTITLE

16

The axis title is the y-channel name of the displayed datasets.

ZAXIS_PROTECTTITLE

32

The axis title can only be set manually. If the attribute is not set the axis title will be updated if a new dataset is loaded.

ZAXIS_AUTOTITLE

64

The axis title is the channel name of the displayed datasets.

YAXIS_SHOWSYMBOL

128

A line symbol will be displayed in front of the axis title.

YAXIS_AUTOCOLORTITLE

256

The axis title will be displayed in the color of the first dataset.

YAXIS_AUTOCOLORAXIS

512

The axis and the labelling will be displayed in the color of the first dataset.

YAXIS_SYMBOL_MARKER

1024

The marker symbol will be displayed in front of the axis title.

To set the attributes the following helper functions can be used:

LayerIsYAxisTitleInCurveColor(hLayer)   // YAXIS_AUTOCOLORTITLE
LayerIsYAxisInCurveColor(hLayer)        // YAXIS_AUTOCOLORAXIS
LayerIsAxisShowSymbol(hLayer)           // YAXIS_SHOWSYMBOL
LayerIsYLabelFree_StackedDia(hLayer)    // YAXIS_STACKEDDIA_LABELFREE
LayerIsTitleProtected(hLayer, ssAxis)   // XAXIS_PROTECTTITLE, YAXIS.., ZAXIS...
LayerIsAutoTitle(hLayer, ssAxis)        // XAXIS_AUTOTITLE,...
LayerIsTitleSetOnLoad(hLayer, ssAxis)   // XAXIS_PROTECTTITLE, ..
LayerSetYAxisTitleInCurveColor(hLayer, bool) // YAXIS_AUTOCOLORTITLE
LayerSetYAxisInCurveColor(hLayer, bool) // YAXIS_AUTOCOLORAXIS, ..
LayerSetAutoTitle(hLayer, ssAxis, bool) // XAXIS_AUTOTITLE, ...
LayerSetAxisShowSymbol(hLayer, bool)    // YAXIS_SHOWSYMBOL
IsAxisShowSymbol(hLayer)                // YAXIS_SHOWSYMBOL
LayerGetAxisSymbolID(hLayer)            // YAXIS_SYMBOL_MARKER
LayerSetAxisSymbolID(hLayer, bool)      // YAXIS_SYMBOL_MARKER
LayerSetYLabelFree_StackedDia(hLayer, bool)  // YAXIS_STACKEDDIA_LABELFREE
LayerSetTitleProtected(hLayer, ssAxis, bool) // XAXIS_PROTECTTITLE;

History

Version

Description

R2013.10

Documentation added.

See also

Overview Diagrams, LayerCreate, LayerIsFirstLabel, LayerShowFirstLabel, LayerGetLastLabel, LayerSetFixedLabelNum, LayerGetAxesAttribs, LayerSetAxisTitle, LayerShowAxisTitle

id-307275