Tags:
create new tag
view all tags

.POINT ADD NEW

This subroutine adds a new Point to the "current" Dataset.


Usage:

      
      PASS         <dataset_point_value1>     FIELD            SHARE? N
      PASS         <dataset_point_value2>     FIELD            SHARE? N
      PASS         <dataset_point_value3>     FIELD            SHARE? N
      GOSUB    0CD .POINT ADD NEW
      *        check for error
      IF       0CD .POINT ADD NEW             NE

Description:

This subroutine adds a new Point to the "current" Dataset. The dataset must have been previously initialized via .DATASET INITIALIZE before you can add data. If you are working with more than one dataset at a time, you can select which one is the "current" dataset via .DATASET SET CURRENT before using this subroutine. If you are making a Pie chart, you can also add data via .PIE SECT ADD NEXT. That routine will create a default dataset for you (if necessary) and allow you to assign a label to the value all in one step.

You must PASS <dataset_point_value1>, otherwise the routine will Cancel. You must also pass as many <dataset_point_values> as there are dimensions in your dataset (based on what you specified when you initialized the dataset).

The newly added data point is set to be the "current" data point.

You can also pass the constant 'NoValue' (case sensitive) to indicate there is no data for the current data point.

See Datasets Overview for more information on working with data.

Comments:

Read what other users have said about this page or add your own comments.

It appears that this subroutine will not handle negative values when passed as standard APPX numeric fields (i.e., with a trailing minus sign). In order to display negative values, the numeric field must have a display mask with a leading sign (set your field into a formatted numeric field, then use CNV TEXT to turn it into an alpha, and pass that alpha value).

-- Al Kalter - 2016-10-17

The trailing minus sign issue is fixed in 5.4.5.

-- Jean Neron - 2016-10-18

-- JeanNeron - 2011-11-11

Edit | Attach | Watch | Print version | History: r4 < r3 < r2 < r1 | Backlinks | Raw View | Raw edit | More topic actions
Topic revision: r4 - 2016-10-18 - JeanNeron
 
This site is powered by the TWiki collaboration platform Powered by PerlCopyright © 2008-2024 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback