Progress
Language Reference


BROWSE Widget

A browse widget lets you see data and select records from all the records associated with a database query. You can define a static browse widget with the DEFINE BROWSE statement or a dynamic browse widget with the CREATE BROWSE statement. The CREATE BROWSE is valid only in a graphical interface. A browse can be either a read-only tool for browsing through records, or it can be an editing tool for updating records, depending on the options you specify.

You can also move and resize the browse and its components. Specifically, in graphical interfaces, you can move and resize the browse, move and change the width of the browse-column, and change the height of the browse-row. You can do all this through direct manipulation (by pointing, clicking, and dragging) and through the 4GL. For more information, see the Progress Programming Handbook .

The following figure shows a read-only browse widget:

The following figure shows an updateable browse. Note the inline editing capability in the focused row:

ATTRIBUTES

When describing browse attributes, it is important to understand the scope of each attribute. An attribute can apply to:

When you want to reference an attribute that applies to the browse as a whole, the correct syntax is as follows:

browse-name:attribute-name IN FRAME frame-name  (for a static browse)
OR
browse-handle:attribute-name      (for a dynamic or static browse) 

The IN FRAME qualifier is only necessary for a static browse to avoid ambiguity.

When an attribute applies to a column or a cell, the identifier is the field or variable name as listed in the DEFINE BROWSE statement. This identifier is known as the column name. The browse column’s widget-handle may also be used. Here is the syntax:

column-name:attribute-name IN BROWSE browse-name  (static browse column)
OR
column-handle:attribute-name       (dynamic or static browse column) 

The IN BROWSE qualifier is only necessary for a static browse to avoid ambiguity, but it is good programming practice to always include it, especially when you reference the same field as a separate widget type.

The following table lists all the attributes for the browse widget, whether they are readable and writeable, and their scope.

Attribute
Readable/Writeable
Applies To
Readable/writeable
Browse
Readable/writeable
Column
Readable/writeable
Column
Readable/writeable
Cell
Readable/writeable
Browse, cell
Readable
Column
Readable/writeable (browse), readable (cell)
Browse, cell
Readable/writeable
Column
Readable/writeable
Column
Readable/writeable
Column
Readable/writeable
Column
Readable/writeable
Browse
Readable/writeable
Column
Readable/writeable
Column
Readable/writeable
Browse
Readable/writeable
Browse
Readable/writeable
Browse
Readable/writeable
Browse
Readable
Browse
Readable/writeable
Column, cell
Readable
Column
Readable
Column
Readable (browse), Readable/writeable (cell)
Browse, cell
Readable/writeable
Column
Readable/writeable
Browse
Readable/writeable
Browse
Readable
Browse
Readable/writeable
Column
Readable/writeable
Column
Readable/writeable
Browse
Readable/writeable
Browse, cell
Readable
Browse
Readable
Browse
Readable
Browse
Readable/writeable
Browse, cell
Readable/writeable
Browse
Readable
Browse
Readable
Browse
Readable
Browse
Readable
Browse
Readable
Browse
Readable
Browse, cell
Readable/writeable
Browse, cell
Readable/writeable
Browse, cell
Readable/writeable
Browse, column
Readable/writeable
Browse
Readable
Browse
Readable/writeable
Column
Readable/writeable
Browse
Readable/writeable
Column
Readable/writeable
Column
Readable/writeable
Column
Readable/writeable
Column
Readable/writeable
Browse
Readable/writeable
Browse
Readable/writeable
Browse
Readable
Browse, column
Readable
Browse, column
Readable/writeable
Browse, column
Readable
Browse
Readable/writeable
Browse, cell
Readable
Browse
Readable
Column
Readable
Browse
Readable
Browse
Readable
Browse
Readable
Browse
Readable
Browse
Readable/writeable
Browse
Readable
Browse
Readable
Browse
Readable/writeable
Browse
Readable/writeable
Cell
Readable/writeable
Browse
Readable
Column
Readable
Browse
Readable
Browse
Readable/writeable
Browse, column
Readable/writeable
Browse
Readable/writeable
Browse, column
Readable/writeable
Browse
Readable/writeable
Browse, column
Readable/writeable (browse), readable (cell)
Browse, cell
Readable/writeable
Browse
Readable/writeable
Browse
Readable/writeable
Browse
Readable
Browse
Readable/writeable
Cell
Readable/writeable
Browse
Readable/writeable
Browse
Readable
Column
Readable
Column
Readable
Column
Readable/writeable
Browse
Readable/writeable
Browse
Readable/writeable
Browse
Readable
Browse
Readable/writeable
Browse
Readable
Column
Readable
Column
Readable/writeable
Browse
Readable
Browse
Readable
Browse
Readable
Browse
Readable
Browse
Readable/writeable
Browse
Readable
Browse, cell
Readable/writeable
Browse, column
Readable/writeable
Browse, cell, column
Readable/writeable
Browse, cell, column
Readable
Browse
Readable/writeable (browse), readable (cell)
Browse, cell
Readable/writeable, (browse), readable (cell)
Browse, cell
  1. Graphical interfaces only.
  2. Character interfaces only.
  3. Windows only.
  4. Windows only for column only.

METHODS

Methods

EVENTS

Event Type
Supported
  1. Windows only.

SEE ALSO

The chapter on the browse in the Progress Programming Handbook .


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