Progress
Programming
Handbook
Fill-in Attributes
At run time, a procedure can query or set fill-in specific attributes in these ways:
- Set AUTO–ZAP to TRUE to allow the initial screen value of the fill-in to be erased when the user begins typing in the field. The fill-in must have input focus to set AUTO–ZAP.
- Query or set the FORMAT attribute. The format determines the number of spaces and special characters (such as dollar signs and decimal points) Progress uses when displaying the fill-in. Note that the format also establishes a constraint on the data that the user can enter. However, changing the format has no effect on the data type of the field. For more information, see "Applying Formats When Displaying Widgets" later in this chapter.
- Enable or disable automatic tabbing with the AUTO–RETURN attribute. If this attribute is true, Progress tabs to the next widget when the fill-in is full. If you set AUTO–RETURN to true for the last widget in a frame, then when the field is full, Progress issues a GO event for the frame.
- Enable or disable character-echo during data entry with the BLANK attribute.
- Query the FRAME–NAME attribute to find the name of the frame that contains the field. This is equivalent to using the FRAME–NAME function and is useful for context-sensitive help.
- Query the DBNAME, INDEX, and TABLE attributes to find the name and index of the corresponding database field and the table in which that database field resides.
NOTE: The value of the SESSION handle’s DATA–ENTRY–RETURN attribute determines the meaning of the RETURN key in a fill-in. If the attribute is TRUE, Progress interprets a RETURN as a TAB event for most fill-ins and as a GO event for a fill-in if that fill-in is the last tab item in a frame family (Version 6 behavior). In this case, the GO event is propagated to all frames of the frame family. If the attribute is FALSE, the window system determines the meaning of the RETURN key. The default value is TRUE for character interfaces and FALSE for graphical interfaces. For more information on frame families, see Frames." For more information on tab order, tab items, and DATA–ENTRY–RETURN, see Interface Design."
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |