.COLOR GET NAME

This subroutine is called to get the name of the "current" color object.

Usage:

      PASS         <color_spec_name>          FIELD            SHARE? Y
      GOSUB    0CD .COLOR GET NAME
      *        Check for error
      IF       0CD .COLOR GET NAME            NE

Description:

<color_spec_name> is the value returned to you, and is the name which uniquely identifies the "current" color object. The receiving field should be at least 30 characters in length. This is a required field, and the subroutine will cancel if it is not received.

If the "unnamed" color object is the current color object, then the name returned will be blank.

The name of the current color is returned in <color_spec_name> so this parameter must be passed shared.

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-11-15