•  Back 
  •  Main 
  •  Index 
  •  Tree View 
  •  Cross references 
  •  Help 
  •  Show info about hypertext 
  •  View a new file 
Topic       : The GFA-Basic Compendium
Author      : GFA Systemtechnik GmbH
Version     : GFABasic.HYP v2.98 (12/31/2023)
Subject     : Documentation/Programming
Nodes       : 899
Index Size  : 28056
HCP-Version : 3
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Document not found
@help       : Help
@options    : +g -i -s +z
@width      : 75
@hostname   : STRNGSRV
@hostname   : CAB     
@hostname   : HIGHWIRE
@hostname   : THING   
View Ref-FileFORM_KEYBD(tree,obj,char,next_obj[,new_obj,next_char])

tree, obj, char, next_obj: iexp
new_obj, next_char: ivar

Allows a form to be filled out via the keyboard (see OBJC_EDIT()).

Returns 0 if the Form was left by clicking on an object with EXIT or TOUCHEXIT
status. Returns a value >0 if the Form should continue to be processed.

    tree      - Address of the object tree.
    obj       - Number of the object to be edited.
    char      - Input character.
    next_obj  - Number of the next EDITable object in the tree.
    new_obj   - Returns the object to be EDITed on the next call.
    next_char - Returns the next character (derived form the keyboard, etc).

The parameters new_obj and next_char are optional, these values can also be
found by querying GINTOUT(1) to GINTOUT(2).

Explanation: This routine is a subroutine of FORM_DO() and makes it possible to
test a character in BASIC before it is passed to GEM, e.g. to test for Return
character, which would normally cause an exit from the Form and allow it to be
used to terminate an individual enrty, etc.

Memo: In the original manual parameters 'char' and 'next_obj' are swapped.
      The function works fine. Parameter order does not match offical docs.

form_keybd()+