.CLIENT GET CLIPBOARD

This subroutine gets the current content of the system clipboard.

Usage:

      PASS         <clip_data>                FIELD            SHARE? Y
      PASS         <num_chars>                FIELD            SHARE? Y
      PASS         <max_chars>                FIELD            SHARE? N
      GOSUB    --- .CLIENT GET CLIPBOARD
      *        check for errors
      IF       --- .CLIENT GET CLIPBOARD      NE

Description:

This subroutine gets the current content of the system clipboard. The first two parameters are required, if any are missing the subroutine will CANCEL. The <max_chars> field is optional.

<clip_data> is the data returned from the clipboard (Required). This field must be PASSed with Share "Y" to receive the value.

<num_chars> is the number of characters on the system clipboard (Required). This field must be PASSed with Share "Y" to receive the value.

<max_chars> is the maximum number of characters you want read from the clipboard (Optional). If not PASSed, the default is 32,767.

If <clip_data> is not large enough to hold the requested number of characters, --- .CLIENT GET CLIPBOARD will contain 'Clipdb chars truncat'.

Comments:

Read what other users have said about this page or add your own comments.

-- JeanNeron - 2012-02-01