"areaFixed"

Synopsis

setValue(string shape,"areaFixed", int area, bool fixed );

getValue(string shape,"areaFixed", int area, bool fixed );

shape.areaFixed(int area, bool fixed);

Parameter

Description

With the trend attribute "areaFixed" of a trend you can fix a trend area to the current geometry. Thus, a fixed time scale can be shown even when the areas are large enough for scrollbars to be needed and the time scale is currently invisible because of scrolling.

With the attribute, you can fix one area for a trend with several areas and then link all areas. Thus, several trend areas can be moved by using one time scale. You can also link curves for one area and display other curves for another fixed area. To link areas, use the attribute "linkAreas".

Example

This example sets the minimum size of the trend areas via the attribute "areaMinimumSize". If the sum of the minimal sizes of the areas is bigger than the available size of the trend, scroll bars are shown for the trend widget. The trend area 3 (index 2) is fixed.

main()
{
  TREND2.areaMinimumSize(0, 250);
  TREND2.areaMinimumSize(1, 250);
  TREND2.areaMinimumSize(2, 250);
  TREND2.areaFixed(2, true);
}

Example

The second example shows how trend areas are fixed and linked.

main()
{
  int timeArea = TREND1.numTrendAreas - 1;
//Number trend areas -1
  if ( this.toggleState )
//Status of a button (ON = enabled & OFF = disabled).
  {
    if ( !TREND1.areaFixed(timeArea) )
//If trend area is not fixed
    {
      TREND1.addTrendArea();
//Adds a new trend area to the trend
      timeArea++;
      TREND1.timeScaleVisibility(timeArea, true, SCALE_BOTTOM);
//Shows a time scale at the bottom of the trend
      TREND1.areaFixed(timeArea, true);
//The area is fixed
    }
    int num = TREND1.numTrendAreas;
//Number of trend areas

    for (int i = 0; i < num; i++)
//As long as i < number of trend areas
    {
      TREND1.linkAreas(0, i);
//link areas
      if ( i != (num - 1) )
        TREND1.timeScaleVisibility(i, false, SCALE_BOTTOM);
    }
  }
  else
  {
    TREND1.removeTrendArea(timeArea);
//Delete trend area
    int num = TREND1.numTrendAreas;

    for (int i = 0; i < num; i++)
    {
      TREND1.unlinkAreas(0, i);
//unlink areas
      TREND1.timeScaleVisibility(i, true, SCALE_BOTTOM);
    }
  }
}

Assignment

Trend