Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

                                             ◄Up► ◄Contents► ◄Index► ◄Back►
─────PWB Extensions─────────────────────────────────────────────────────────
 
  Syntax:  int AddAColor( char far *Color, char far *Extension );
 
  Returns: An index of the entry in the color table, or -1 if this is a
           duplicate entry or if there is no more space in the table.
 
  See:     GetColor, PutColor, SetColor
 
     AddAColor allows extensions to add colors to the PWB internal color
     table. For each new entry, a color switch is added through which
     the color can be modified by the user.
 
     The <Color> string is the color name assigned to the switch. It
     must be entered in lowercase. The <Extension> string is the name of
     the extension module in which the color is defined. PWB needs this
     information in order to correctly update colors. When PWB saves the
     color switch, it uses the [pwb-<Extension>] section of TOOLS.INI.
 
     New color switches can be modified in TOOLS.INI with the Assign
     function or the Editor Settings command on the Options menu. The
     index returned by AddAColor can be used in extensions to set colors
     with GetColor, PutColor, SetColor, and SetHiLite.
     See: ◄PWB Color Switch► ◄Colors in Extensions►
                                    -♦-