ChartDirector 7.1 (C++ Edition)

ViewPortManager.updateFullRangeH


Usage

void updateFullRangeH(const char *id, double minValue, double maxValue, int updateType);

Description

Updates the full range of a horizontal viewport data scale.

This method can be called to modify an existing full range (see ViewPortManager.setFullRange). When the full range is modified, there are several ways to update the viewport. This is best explain by using an example.

Suppose in a real-time chart, the full range is 200 seconds, and the viewport is viewing the last 50% of the data. In viewport coordinates, it is viewing from 0.5 to 1.0 of the full range. In axis scale, it is viewing the last 100 seconds of data from time = 100 to 200. Suppose new data comes in and the full range is updated to 300 seconds. The viewport can be updated in the following ways:

Sometimes it is impossible to adjust viewport using the specified method. For example, for real-time charts, some systems will automatically remove old data to avoid unlimited data accumulation. The KeepVisibleRange can become impossible if the visible range was removed. In this case, ChartDirector will adjust the viewport to keep it within the valid range.

Arguments

ArgumentDefaultDescription
id(Mandatory)The name of the horizontal data scale.
minValue(Mandatory)The new minimum value of the data scale.
maxValue(Mandatory)The new maximum value of the data scale.
updateType(Mandatory)The method to update the viewport. Must be one of ViewPortNoUpdate, KeepVisibleRange, ScrollWithMax or ScrollWithMin.

Return Value

None