Progress
Language Reference


DEFAULT-BUTTON Attribute

Indicates whether a button is a default button for the frame or dialog box.

Data Type: WIDGET-HANDLE

Access: Readable/Writeable

Applies To: Dialog-box, Frame

To make the specified button the default button for the frame or dialog box, you must also set the button’s DEFAULT attribute to TRUE.

NOTE: The default button cannot display an image.

A default button is one that handles all RETURN events when no other RETURN-enabling widget in the frame or dialog box has focus. RETURN-enabling widgets include any field-level widget for which a RETURN trigger is defined, or any button, whether or not it has a trigger defined. Thus, if a button has focus, that button handles the next RETURN event. If any other field-level widget without a RETURN trigger has focus, the default button handles the next RETURN event.

NOTE: When the frame receives a default RETURN event, it actually sends a CHOOSE event to the default button. If the user chooses the default button in a frame that has no default button and the frame is part of a frame family, Progress applies the CHOOSE event to the first default button it can find within the frame family in random order.


Copyright © 2004 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095