sf_cua_filecopy     File copy function processes a COPY FILE
------------------------------------------------------------------------------

    function ulong sf_cua_filecopy
      parameters const char from_string,;
                 const char to_string,;
                 value uint attribute,;
                 value int lr,;
                 value int lc,;
                 value int window_color,;
                 const char header_string,;
                 value int header_color,;
                 value int progress_color,;
                 value uint delay_value,;
                 const logical verify_on

    The CUA file copy function processes a COPY FILE... based upon the
    given parameters.  Most of the paramaters are obvious based upon other
    CUA functions.  The lr and lc are the top, left row and column position
    for the window.  Keep in mind that the window is 41 characters wide and
    8 characters high.  The from string should include any path required and
    supports wild cards just like FIND_FIRST().  The to_string should only
    contain the path ending with a backslash.  The delay_value is provided
    to allow the user longer viewing time per file.  By passing .t. to
    verify_on, DOS verify will be set on prior to the copy and returned
    to it's origional state afterward.

    Example:

    sf_cua_filecopy( "*.*", "d:\trash\", 0x20, 5, 5, &CUA_BWHITE,;
                     "CUA File Copy", 31, &LIGHT_BLUE_BLACK, 1 )