Programming Guide - Actian

Table Field OperationsThe Scroll event is triggered when the user clicks the scroll bar of a table fieldwith an interactive bias (FB_LANDABLE or FB_CHANGEABLE). The Scroll eventis also triggered when scrolling occurs due to use of a scrolling key, PageDown, Page Up, Home, or End.If a SetValue or Exit event is triggered by moving the scroll bar, these eventsare executed before the Scroll event. Because the Scroll event is not chainedoff the SetValue or Exit events, a resume statement in either of those eventsdoes not affect the running of the Scroll event.For more information about Scroll events, see the Language Reference Guideonline help. For more information about event chains, see Managing EventQueues (see page 317).How You Can Scroll to a Specific RowThere are two ways to allow direct scrolling to a particular row:• The SetInputFocus method of the TableField system class• The ActiveRow attribute of the TableField system classIn addition, you can use ArrayObject's Find method to provide the user withthe opportunity to specify a row for scrolling. After the user specifies the row,use the SetInputFocus method or the ActiveRow attribute to scroll the tablefield to the desired row.How You Can Use the SetInputFocus Method to ScrollYou can use the SetInputFocus method to set the input focus of a frame to aspecific cell of a table field. Its syntax is:integer = tablefield.SetInputFocus([row=integer], [column=varchar(256)])rowIdentifies the row in the array to which to move the input focusDefault: row 1columnIdentifies the name of the column in the table field to which to move theinput focusDefault: the first displayed columnThe SetInputFocus method returns ER_OK (value of 0) if the parameters arevalid, and it returns a nonzero number if there is an error.Working with Arrays, Table Fields, and Collections 239