SELECT_READ$()

SELECT_READ$(N)

RETURNS THE SELECTED TEXT OF THE SYSTEM OBJECT NUMBER N

  • Type: Function
  • Parameter: 1
  • Group: System Objects

ACTION

The function SELECT_READ$(N) returns the selected text of the system object designated by its number N.

The system object is of type : EDIT, MEMO, COMBO, SPIN, MEMO_RICH, SYNEDIT.

Remark: the keyword SELECT_READ$ ends by '$' because the returned value is a string.

SYNTAX: Result$=SELECT_READ$(N)

  • N = system object number (integer or real). Must be greater than 0 and less than or equal to the allowed maximum number of system objects.
  • Result$ is a string.

USE

  • The function SELECT_READ$() is used to know the text selected by software or by the user.

ERROR

  • If number N is not a correct expression.
  • If number N exceeds the allowed maximum number of system objects.
  • If number N is less than 0.
  • If the system object number N does not exist.
  • If number N is not of type : EDIT, MEMO, COMBO, SPIN, MEMO_RICH, SYNEDIT.

EXAMPLE

rem create an EDIT

edit 1

rem display a text

text 1,"Hello world"

rem select 3 characters from the 2sd

select_text 1,3,2

rem display the selected text

print select_read$(1)

SEE ALSO

EDIT

MEMO

COMBO

SPIN

MEMO_RICH

SYNEDIT

SELECT_TEXT

SELECT_DELETE