BarLine Object Class


Overview

A Chart Object creates a Plot object of type BarLine when the chart type resource is set to XintCHART_TYPE_BAR. This plot type displays its data as horizontal or vertical bars or lines.

A BarLine creates BarSeries and LineSeries objects to display the bars or the lines. See BarLine Series for a complete list of the applicable resources.


Data

The BarLine class only handles data objects of type DataSampled. It creates a BarSeries for each DataSampled object, with as many bars as the number of samples in the data object. No bars are created for missing or null values. All the DataSampled objects should have the same increment, but can have different starting values (see resource XmNsampledRange to specify a non default start and increment).

The BarLine class supports transposition. In this case a BarSeries is created at each sampled location, with as many bars as there are DataSampled objects.


Inherited Resources and Behavior

The BarLine object class inherits behavior and resources from the Xt Object, Graphic, Group and Plot2D object classes.
The following resources are defined by the BarLine object class:
NameTypeDefaultAccess
XmNbarOrientationintXintVERTICALCSG
XmNbarStyleintXintADJACENTCSG
XmNclusterWidthint75CSG
XmNdrawShadowBooleanFalseCSG
XmNinclinationint0CSG
XmNperspectiveDepthint25CSG
XmNproportionalBooleanFalseCSG
XmNrotationint0CSG


XmNbarOrientation

Specifies if the bars are oriented vertically (XintVERTICAL) or horizontally (XintHORIZONTAL).

XmNbarStyle

Specifies the bar style. You can use one of the following constants:

Resource ValueDescription
XintADJACENTBars are adjacent.
XintOVERLAPPEDBars overlap.
XintSTACKEDBars are stacked.


XmNclusterWidth

Specifies, as a percentage between 0 and 100, the size of a bar cluster (all the bars assigned to the same sampled value). The difference between the specified size and 100 is the size allocated for the space between bar clusters. Specify 100 to have no space between bar clusters.

XmNdrawShadow

If True, and if either resource XmNinclination or XmNdepth is not 0, the side of the bars will drawn using a darker color which simulates a shadow.

XmNinclination

Specifies the inclination in degrees along the X axis (vertical bars) or the Y axis (horizontal bars) of the bars. This value must be between 0 and 45.

XmNperspectiveDepth

This resource specifies the depth of a bar as a percentage of the plot width. This resource is ignored if XmNinclination and XmNrotation are both 0.

XmNproportional

Specifies that the stacked bars should be made proportional to and plotted against an axis ranging between 0 and 100.

XmNrotation

Specifies the rotation clockwise in degrees along the Y axis (vertical bars) or the X axis (horizontal bars) of the bars. This value must be between 0 and 45.

Plot2D Object Class Inherited Resources

See
Plot2D Object Class for a complete listing of the inherited resources for the BarLine object class.

Macros

The XintIsBarLine macro returns True if the specified object is a BarLine object. It returns False otherwise.

     Boolean XintIsBarLine (Object object)


BarLine Series

The BarLine object class displays its data using BarSeries or Polyline Series objects. These object classes inherit their resources from the Graphic class. The following is a list of the applicable resources for these classes. See class Graphic for a complete description of these resources.

BarSeries Resources
NameTypeDefaultAccess
XmNcolorPixel"black"CSG
XmNdashListchar *NULLCSG
XmNfillColorPixelassigned from color listCSG
XmNfillFilenamechar *NULLCSG
XmNfillPixmapPixmapNULLCSG
XmNfillStyleintXintFILL_SOLIDCSG
XmNlineStyleintXintLINE_SOLIDCSG
XmNlineThicknessint1CSG
XmNsensitiveBooleanTrueCSG
XmNstippleColorPixel"black"CSG

Polyline Series Resources
NameTypeDefaultAccess
XmNcolorPixelassigned from color listCSG
XmNdashListchar *NULLCSG
XmNfillColorPixelassigned from color listCSG
XmNfillFilenamechar *NULLCSG
XmNfillPixmapPixmapNULLCSG
XmNfillStyleintdynamicCSG
XmNlineStyleintdynamicCSG
XmNlineThicknessint1CSG
XmNsensitiveBooleanTrueCSG
XmNstippleColorPixel"black"CSG
XmNsymbolBooleandynamicCSG
XmNsymbolColorPixelassigned from color listCSG
XmNsymbolSizeint88CSG
XmNsymbolTypeintassigned from symbol listCSG