Text Entry: _getCurrow

Text Entry: _getCurrow

Returns the position of the text cursor relative to the first row of a text entry field

Syntax
Details
Examples

Syntax

CALL NOTIFY (text-field-name, '_getCurrow', row);

Argument Description

row
returns the cursor position relative to the field's first row:

>0 the number of rows below the field's first row plus 1

<=0 the absolute number of rows above the field's first row minus 1

Argument	Description
row	returns the cursor position relative to the field's first row:
		>0	the number of rows below the field's first row plus 1
		<=0	the absolute number of rows above the field's first row minus 1

Details

The _getCurrow method returns the position of the text cursor (relative to the text entry field) when a user clicks with the mouse or presses the RETURN or ENTER key. The cursor can be in the master region or in another object. If the cursor is in an area below that first row, the number returned is positive. If the cursor is in an area above the receiver field's first row, the number returned is less than or equal to zero.

Examples

_getCurrow returns the cursor position relative to the first row of the field TEXT1. TEXT1 has a length of 6.

Assume a user presses the ENTER key when the cursor is on the first row of TEXT1, as shown here:

 row
number

 -2
 -1
  0
  1   X_ _ _ _ _    
  2                   
  3

(cursor on row 1 relative to position
 of TEXT1 field)

This statement returns a 1 in the SCL variable MYROW:

 call notify ('text1','_get_currow_',myrow);

Assume the user presses the ENTER key when the cursor is 3 rows (in any column) above TEXT1, as shown here:
```
  row
 number

  -2     X         (cursor position)
  -1
   0
   1   _ _ _ _ _ _ (field position)
   2
   3
```
This statement returns a -2 in the SCL variable MYROW:
```
 call notify ('text1','_get_currow_',myrow);
```

Chapter Contents
Previous
Next
Top of Page