Summary

#
  A class for a single input line of text.  The text can
  scroll within the area specified.  By default, a border
  surrounds the text area; this can be turned of by using
  {toggle_draw_border()}.

  The horizontal size must be set by the {set_size()} method:
  there is no default (the vertical size will default, however).

  An event is generated when return is pressed (with code 0),
  and whenever the contents are changed (with code 1).

  @example
  @ t := TextField()
  @ t$set_pos(50, 250)
  @ # Vertical size will default
  @ t$set_size(100)
  @ t$set_contents("Initial string")
  @ self$add(t)

Superclasses:

Component

Package:

(main)

File:

textfield.icn

TextField(argv)

display(buffer_flag)

#
  Return the present contents of the text field.

handle_default(e)

handle_delete1(e)

 Delete

handle_delete_2(e)

handle_delete_line(e)

handle_end_of_line(e)

handle_event(e)

handle_key_right(e)

handle_press()

 Mouse click - compute new cursor position, re-display

handle_return(e)

handle_start_of_line(e)

resize()

#
  Set the contents of the field.  If not invoked then
  the initial content is the empty string.
  @param x   The contents

set_displaychar(c)

set_filter(c)

#
  Set a filter on the characters allowed to be input to the text field.
  @param c  The cset of permissible characters.
  @example
  @ # Permit only hexadecimal characters as input
  @ set_filter('0987654321abcdefABCDEF')