Get text fromn the MS Windows clipboard.
──────────────────────────────────────────────────────────────────────────────

 Syntax

        GT_CBCopy() --> cText

 Arguments:

      None.

 Returns:

      The text contents of the Windows clipboard if there is any text
      there, or an empty string if there was an error or there was no
      text in the clipboard.

 Description:

      GT_CBCopy() can be used to retrieve text from the Windows clipboard
      when your application is running in a DOS window.

      If for any reason the function is unable to locate any text in
      the clipboard the function will return an empty string. For the
      function to fail to copy from the clipboard one of the following has
      to happen:

              a) The application is not running under MS Windows.
              b) The DOS paste service is not available.
              c) The clipboard could not be opened.

      I have only been able to test this function under WFWG 3.11, you
      may also want to note that changes will have to be made before
      this function will work in protected mode.

 Examples:

      // Attempt to grab some text from the clipboard and display it.

      If GT_IsWin()
         ? "The content is '" + GT_CBCopy() + "'"
      Else
         ? "You are not running under Windows"
      EndIf

 Source: WINCLIPB.C

 Author:  Dave Pearson