Skip to main content
A newer version of this page is available.

DXDateTimeAxisX Class

The date-time arguments axis.

Declaration

@interface DXDateTimeAxisX: DXAxisX

Remarks

This class introduces the following main properties:

Date-time axis parameters

Refer to the Axes guide for more information about axes.

Inheritance

NSObject

Properties

aggregationType Property

Gets or sets the date-time arguments axis’s aggregation function’s type.

Declaration

@property (readwrite, nonatomic) DXAggregationType aggregationType

Property Value

Type Description
DXAggregationType

The DXAggregationType enumeration value that specifies the aggregation function used to aggregate data.

Remarks

If series data provides more detailed data than measure unit, for example, data points are by hours and the measurement unit is a day, data is aggregated using function specified by this property.

gridAlignment Property

Gets or sets the date-time arguments axis’s measurement unit by which grid is aligned.

Declaration

@property (readwrite) DXDateTimeMeasureUnit gridAlignment

Property Value

Type Description
DXDateTimeMeasureUnit

The DXDateTimeMeasureUnit enumeration value that specifies the measurement unit by which the grid is aligned.

gridOffset Property

Gets or sets the first major tickmark’s and gridline’s initial offset from the range’s minimum value on the date-time arguments axis.

Declaration

@property (readwrite) NSInteger gridOffset

Property Value

Type Description
NSInteger

The first major tickmark’s and gridline’s initial offset, in measurement units.

gridSpacing Property

Gets or sets the distance between two major tickmarks and gridlines on the date-time arguments axis.

Declaration

@property (readwrite) NSInteger gridSpacing

Property Value

Type Description
NSInteger

The distance between two major tickmarks and gridlines, in grid alignment units.

labelTextFormatter Property

Gets or sets a formatter that provides date-time X-axis labels’ text.

Declaration

@property (readwrite, nullable) id<DXDateTimeAxisLabelTextFormatter> labelTextFormatter

Property Value

Type Description
id<DXDateTimeAxisLabelTextFormatter>

An object of a class implementing the DXDateTimeAxisLabelTextFormatter interface that formats axis values.

Remarks

Note that this property has a higher priority than the DXSeriesLabel.format. If both are specified, the formatted value this property provides is used.

measureUnit Property

Gets or sets the date-time arguments axis’s measurement unit.

Declaration

@property (readwrite, nonatomic) DXDateTimeMeasureUnit measureUnit

Property Value

Type Description
DXDateTimeMeasureUnit

The DXDateTimeMeasureUnit enumeration value that specifies the axis’s measuring unit.

Remarks

Note that measurement unit specifies the maximum detail level that the chart displays. If your data is more detailed, it is aggregated using the aggregation function the aggregationType property specifies. For example, data points are by hours and the measurement unit is a day, data is aggregated by day.

range Property

Gets or sets the date-time arguments axis’s range parameters.

Declaration

@property (readwrite, nullable) DXDateTimeRange *range

Property Value

Type Description
DXDateTimeRange *

The DXDateTimeRange object that specifies the range settings.

Instance Methods

addConstantLine: Instance Method

Adds the specified constant line to the date-time X-axis.

Declaration

- (void)addConstantLine:(nonnull DXDateTimeConstantLine *)line

Parameters

Name Type Description
line DXDateTimeConstantLine *

The DXDateTimeConstantLine object that specifies the constant line to be added to the axis.

addStrip: Instance Method

Adds the specified strip to the date-time X-axis.

Declaration

- (void)addStrip:(nonnull DXDateTimeStrip *)strip

Parameters

Name Type Description
strip DXDateTimeStrip *

The DXDateTimeStrip object that specifies the strip to be added to the axis.

removeConstantLine: Instance Method

Removes the specified constant line from the axis.

Declaration

- (void)removeConstantLine:(nonnull DXDateTimeConstantLine *)line

Parameters

Name Type Description
line DXDateTimeConstantLine *

The DXDateTimeConstantLine object that specifies the constant line to be removed from the axis.

removeStrip: Instance Method

Removes the specified strip from the axis.

Declaration

- (void)removeStrip:(nonnull DXDateTimeStrip *)strip

Parameters

Name Type Description
strip DXDateTimeStrip *

The DXDateTimeStrip object that specifies the strip to be removed from the axis.