Difference: CDPieSectorAddNext (1 vs. 2)

Revision 22011-10-04 - JeanNeron

Line: 1 to 1
 
META TOPICPARENT name="CDChartDirectorDesignerAPI"

.PIE SECT ADD NEXT

Line: 10 to 10
  PASS <sector_data_point> FIELD SHARE? N PASS <sector_label> FIELD SHARE? N PASS <text_spec_name> FIELD SHARE? N
Changed:
<
<
GOSUB OCD .PIE SECT INITIALIZE
    • Check for chart initiailization error
>
>
GOSUB OCD .PIE SECT ADD NEXT
    • Check for error
  IF OCD .PIE SECT ADD NEXT NE

Description:

Revision 12011-10-03 - JeanNeron

Line: 1 to 1
Added:
>
>
META TOPICPARENT name="CDChartDirectorDesignerAPI"

.PIE SECT ADD NEXT

This subroutine is called to create a new pic chart sector spec.


Usage:

      
      PASS         <sector_data_point>          FIELD            SHARE? N
      PASS         <sector_label>               FIELD            SHARE? N
      PASS         <text_spec_name>             FIELD            SHARE? N
      GOSUB    OCD .PIE SECT INITIALIZE
      *        Check for chart initiailization error
      IF       OCD .PIE SECT ADD NEXT          NE

Description:

This subroutine creates a new pic chart sector spec for the "current" chart, and optionally adds a label. This is an easy way to add data and labels to your pie chart simutaneously. If you want to change the attributes of the sector just added (ie, 3D Depth, Color, etc), do that before adding the next sector. Any changes you made to the attributes of the newly added sector will be inherited by the next sector you add, unless you pass 'initialize' as the <text_spec_name> parameter (see below).

The <sector_data_point> parameter is optional. If a <sector_data_point> is received, then the corresponding data point record is created or updated.

The <sector_label> parameter is optional. If a <sector_label> is received, that label will be used on your pie chart and a text spec will be created for the label. You can use the .TEXT routines to change the attributes of the text associated with this data point. Remember that any changes you make will be inherited by the next sector you add, unless you pass 'initialize' as the <text_spec_name> parameter

The <text_spec_name> parameter is optional. If a <text_spec_name> is received, that text spec will be used to create the label. You can also pass "current" to use the "current" text spec, or "initialize" to reset the text spec back to defaults before adding the sector. The "initialize" value is useful if you have changed the attributes on the previous sector and you want the next one(s) to use default values. If you do not pass a <text_spec_name>, the previous text spec will be used.

The newly added data point is set to be the "current" data point, the newly added sector is set to be the "current" sector spec, and if a <text_spec_name> is provided, it becomes the "current" text spec.

Comments:

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


<--/commentPlugin-->

-- JeanNeron - 2011-10-03

 
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