Release 10.1A: OpenEdge Development:
Progress 4GL Reference

> ## SCREEN-VALUE attribute

> The data value in the screen buffer associated with the widget.

> Data type: CHARACTER

> Access: Readable/Writeable

> Applies to: BROWSE widget (cell), COMBO-BOX widget, EDITOR widget, FILL-IN widget, LITERAL widget, RADIO-SET widget, SELECTION-LIST widget, SLIDER widget, TEXT widget, TOGGLE-BOX widget

> Note that setting the SCREEN-VALUE attribute does not affect the record buffer. To apply the updated value to the record buffer you must explicitly assign the field or variable. Likewise, assigning the record buffer does not affect the screen buffer. To display a value in the record buffer, you must explicitly assign it to the SCREEN-VALUE attribute or implicitly move it to the screen buffer using a DISPLAY or UPDATE statement.

> For combo boxes, this attribute returns the screen buffer value of the combo box fill-in. If no item in the list is selected or the list is empty, this attribute returns the Unknown value (`?`). Setting this attribute to an item in the list deselects the previously selected item and assigns the value of the selected item to the fill-in screen buffer. For SIMPLE and DROP-DOWN combo boxes, if the new value in the fill-in is not an item in the list, the fill-in screen buffer is set to the new value and no item in the list is selected. For DROP-DOWN-LIST combo boxes, if the new value in the fill-in is not an item in the drop down list, Progress ignores the value and displays a warning message.

> For browse cells, screen values are applied to the buffers automatically when the user leaves the row. If the browse has the NO-ASSIGN option specified in the DEFINE BROWSE statement or it is a dynamic browse, then you must apply the screen values.

> Changing the SCREEN-VALUE attribute for a browse column is useful in setting the cells in a non-database browse column.

> Note: If you assign a value to the SCREEN-VALUE attribute of a widget and display the widget using a DISPLAY or UPDATE statement, the value you assigned appears as the initial value.

> If a selection list is not already realized and you reference its SCREEN-VALUE attribute, Progress realizes the widget.

> In Windows, SCREEN-VALUE applies to the regular editor and to the large editor.

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