Class lwh.select

Object
   |
   +--lwh.select

class lwh.select

These functions replace the Browser select functions:

• Browsers do not support selecting a block of text (but only lines of text).
  Here, we can specifed select mode "block" or "lines"
• Browser do not support "recalling" a previous selection
  Here, we can show or hide a selection, and can programmatically construct a selection (for example in a macro).

• start(): user starts selecting text on mouse down while dragging the mouse until mouse up.
• make(): programmatically define and show a selection
• show(): show an existing selection, or hide it
• get(): retrieve the text of the current selection

• 2007-02-12 / jf

Field Detail

base

<static> {Object_row_col} base

the base host position: row, col.

isBlock

<static> {boolean} isBlock

true if block select mode; else: lines select mode.

popup

<static> lw.Popup popup

the select popup, or null.

text

<static> {String_Array} text

the currently selected screen text.

lwh.select

lwh.select()

The select functions for host screens.

Version:
• 2007-02-12 / jf


Author: j.fellner@logics.de

get

<static> String get(<boolean> isHidden)

Returns the currently selected text String. Returns empty String if selection is not visible (or empty).

Parameters:
isHidden - optional: if true, returns text String even if selection is not visible; else: returns empty String if selection is hidden.

Returns:
the current selection String, or empty String.

make

<static> void make(start, end, <boolean> isBlock)

Shows the specified selection of the current screen text. Invisible fields such as passwords will be replaced by SPACES.
Note: end column is specified "exclusive": (0, 0, 0, 40) selects chars 0..39 of row 0.

Parameters:
isBlock - if true, shows a text block selection around the starting point; else: shows a text lines selection.
rowStart - the first row of the selection; 0..rowMax
colStart - the first column of the selection; 0..colMax
rowEnd - the last row of the selection; 0..rowMax
colEnd - the last column of the selection (EXCLUSIVE); 0..colMax+1

show

<static> boolean show(mode)

Shows or hides the current selection.

Parameters:
optional - mode if true: shows the selection on the screen (if any); else: hides the selection. If not specified: returns current visibility.

Returns:
true if selection is visible; false if selection is hidden or does not exist.

See:
- make()

start

<static> void start(<boolean> isBlock, <String_Function> action)

Starts text selection via mouse dragging. Event processing function, must be called on mousedown.

Parameters:
isBlock - if true, selects a text block; else, selects lines of text
action - the function or the Menu name to be called on completion

See:
- #event