num-var = Set_Csr(line-ptr, col-num, [len-num])


Operands:

line-ptr

the line pointer of the line where the cursor is to be placed when the macro exits.



col-num

the column number where the cursor should be placed. If col-num is zero, the cursor is placed in the line number field of the given line.



len-num

If a non-zero len-num is provided, then the data starting at col-num, for len-num characters will be highlighted. When len-num is omitted, it is treated as 0; that is, the cursor will be positioned, but no highlighting will be performed.


Returns:


If line-ptr is valid, RC will be 0 and Msg$ will be "" (null)


If line-ptr is invalid, RC will be 8 and Msg$ will contain an error message.


Special Notes:


Requests SPFLite to move the cursor to the specified line and column number when the macro terminates. 


Regardless of where a macro's actions may leave the cursor, the cursor will ALWAYS be placed on the command line when the macro exits. 


If you wish to place the cursor elsewhere, you MUST issue a Set_Cur command immediately before the macro ends.


Created with the Personal Edition of HelpNDoc: Keep Your PDFs Safe from Unauthorized Access with These Security Measures