/* 
   --------------------------------------------------------
   Filename.....: rmmColorList.cc
   ClassName....: rmmColorList   (non-visual).
   Purpose......: function class for dBase colors.
   Programmer...: Rick Miller.
   Date.........: May 22, 2006.
   Notes........: See Notes below.
   Written for..: VdB 7.x and newer.
   Rev. History.: None.
   Dependencies.: None.
   Calls........: None.
   Called by....: Any.
   Usage........: set procedure to rmmColorList.cc additive
   Example......: See Example below.
   --------------------------------------------------------
   Notes:
   --------------------------------------------------------
      1) all get??? methods accept a parameter of:
         <int> (system color),
         or <char> any dBase color name,
         or <char> an rgb triplet (getColor()).
      2) all is??? methods require an <int> parameter
         (system color).
   --------------------------------------------------------
   Example:
   --------------------------------------------------------
      oRef  =  new rmmColorList()
      nApi  =  oRef.getSystem("b")     // any dBase color.
      cDbas =  oRef.getDbase("b")      // any dBase color.
      cHex  =  oRef.getHex("b")        // any dBase color.
      cHtml =  oRef.getHtml("b")       // any dBase color.
      cSafe =  oRef.getHtmlSafe("b")   // any dBase color.
      cJava =  oRef.getJava("b")       // any dBase color.
      cRgb  =  oRef.getRgb("b")        // any dBase color.
      oRef.release()
      oRef  := null
      ? nApi, cDbas, cHex, cHtml, cSafe, cJava, cRgb
   --------------------------------------------------------
   Methods:
   --------------------------------------------------------
      getDbase(any system or dBase color or rgb triplet)
         returns a <char> empty or a dBase color ("R+").
      getHex(any system or dBase color or rgb triplet)
         returns a <char> empty or a hex color "??????".
      getHtml(any system or dBase color or rgb triplet)
         returns a <char> empty or a html color "??????".
      getHtmlSafe(any system or dBase color or rgb triplet)
         returns a <char> empty or a html color "??????".
      getJava(any system or dBase color or rgb triplet)
         returns a <char> empty or a java name ("white").
      getRgb(any system or dBase color)
         returns a <char> empty or an rgb triplet ("128,128,128").
      getSystem(any system or dBase color or rgb triplet)
         returns an <int> -1 or a system color.
      getSystemName(any system or dBase color or rgb triplet)
         returns a <char> empty or a dBase color ("ActiveCaption").
      isBasic(<int> as a system color)
         returns <bool> is a basic dialog color.
      isColor(<int> as a system color)
         returns <bool> is a standard color used in dBase.
      isJava(<int> as a system color)
         returns <bool> is a java name color.
      isSystem(<int> as a system color)
         returns <bool> is a system color.
      refresh()
         refreshes this with the system color values.
      release()
         destroy and close procedure.
   --------------------------------------------------------
   Properties:
   --------------------------------------------------------
      none.
   --------------------------------------------------------
   */