.XY SET PA BG CLR

This subroutine sets the background colors of the "current" chart spec.

Usage:

      PASS         <color_spec_name>          FIELD            SHARE? N
      *        OR
      PASS         <color_value>              FIELD            SHARE? N
      PASS         <color_spec_name>          FIELD            SHARE? N
      *        OR
      PASS         <color_value>              FIELD            SHARE? N
      GOSUB    0CD .XY SET PA BG CLR
      *        Check for error
      IF       0CD .XY SET PA BG CLR          NE

Description:

This subroutine set the background colors of the chart area for the "current" chart spec. You must have initialized the chart as an XY Chart via .CHART INITIALIZE for this to have any effect. This routine receives two, optional values specifying either a <color_spec_name> or a <color_value>.

If a parameter is not received or if the value received is blank, then the background colors of the chart spec are cleared and the default background colors will be rendered. If a second color is passed, it will be alternated with the first color.

If a parameter is received, the system first assumes that the value received is a <color_spec_name> and checks to see if a color spec record has been previously initialized with that name. If a color spec record is found, then that color spec record is used as a prototype to create a color spec for the background color. If a color spec record is not found, then the system assumes that the value received is a literal <color_value> and uses the specified color to create a color spec for the background color.

After setting the background colors, the first background color spec becomes the "current" color spec.

See ColorSpec for more information on working with colors.

Comments:

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

-- JeanNeron - 2011-10-11