Topic       : The ATARI Compendium
Author      : Scott Sanders / JAY Software
Version     : 1.25 (20/6/2003)
Subject     : Documentation
Nodes       : 1117
Index Size  : 32614
HCP-Version : 6
Compiled on : Atari
@charset    : UTF-8
@lang       : en
@default    : 
@help       : %About
@options    : +g -i -t4 +y +z
@width      : 100
View Ref-Fileform_keybd()
Object Library
objc_edit()                                                             AES

Syntax

WORD objc_edit( tree, obj, kc, idx, mode )
OBJECT *tree;
WORD obj, kc;
WORD *idx
WORD mode;

Function       objc_edit() allows manual control of an editable text
               field.

Opcode         46 (0x2E)

Availability   All AES versions.

Parameters     tree specifies the object tree containing the editable
               object obj to modify. mode specifies the action of the call
               and the meaning of the other parameters as follows:

               mode    Value Meaning

               ED_START  0   Reserved for future use. Do not call.

               ED_INIT   1   Display the edit cursor in the object
                             specified. kc is ignored. The WORD pointed to
                             by idx is filled in with the current index of
                             the edit cursor in the field.

               ED_CHAR   2   A key has been pressed that needs special
                             processing. kc contains the keyboard scan
                             code in the high byte and ASCII code in the
                             low byte. idx points to the current index of
                             the text cursor in the field. idx will be
                             updated as a result of this call.

               ED_END    3   Turn off the text cursor.

Binding        intin[0] = obj;
               intin[1] = kc;
               intin[2] = *idx;
               intin[3] = mode;

               addrin[0] = tree;

               crys_if(0x2E);

               *idx = intout[1];
               return intout[0];

Return Value   objc_edit() returns 0 if an error occurred or non-zero
               otherwise.

Comments       This function is usually used in conjunction with
               form_keybd() in a custom form_do() handler.

See Also       form_keybd()

Group          Object Library