Progress
Language Reference
CREATE BROWSE Statement
Creates a dynamic browse, either read-only or updateable. Browse columns are added with the ADD-LIKE-COLUMN, ADD-COLUMNS-FROM, and ADD-CALC-COLUMN methods. The query is specified through the QUERY attribute.
The dynamic updateable browse can only be a NO-ASSIGN browse — all data assignments to the database must be done by the 4GL programmer.
SYNTAX
widget-handle
A variable of type WIDGET-HANDLE that Progress sets to the value of the new widget handle.
IN WIDGET-POOL widget-pool-name
Specifies the widget pool in which the object is created. If you do not specify a widget pool, the object is created in the current default widget pool. The browse will go away when its widget pool goes away or when you do a DELETE OBJECT on it.
ASSIGN { attribute = expression } ...
Assigns specified values to attributes of the object. The attribute parameter must be the name of a valid attribute for the object and expression must evaluate to a valid value for that attribute.
trigger-phrase
A trigger phrase associated with the object. For more information, see the Trigger Phrase reference entry.
EXAMPLEThe following example creates a dynamic browse and adds columns to it.
NOTES
- If the browse’s height is set using the DOWN attribute and a browse column is added, the browse’s height may change to ensure that the number of DOWN is preserved. This may be due to the addition of the horizontal scrollbar or the growth of the column header.
- If the browse’s height is set using the HEIGHT attribute or through direct manipulation, and a browse column is added, the DOWN attribute may change to ensure that the specified height is preserved. This may be due to the addition of the horizontal scrollbar or the growth of the column header.
- The DISPLAY . . . WITH BROWSE browse-name statement cannot be used with a dynamic browse. Instead, the user must set the SCREEN-VALUE attributes.
- A dynamic browse’s validation expression is restricted. It may not contain a CAN-FIND function. To reference the field, the FRAME-VALUE function must be used. The CAN-FIND function will still work for a static browse column.
- If a buffer-field is associated with a dynamic browse column, you should set the buffer-field’s VALIDATE-EXPRESSION attribute before the dynamic browse column is added to the browser (via ADD-LIKE-COLUMN( )). The validation expression is compiled at this time. If the VALIDATE-EXPRESSION attribute is changed later, it is ignored.
SEE ALSO
ADD-CALC-COLUMN() Method, ADD-COLUMNS-FROM( ) Method, ADD-LIKE-COLUMN( ) Method, CREATE QUERY Statement, CREATE Widget Statement, DEFINE BROWSE Statement, DEFINE QUERY Statement, GET-BROWSE-COLUMN( ) Method, QUERY Attribute
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |