FIT-LAST-COLUMN attribute

(Graphical interfaces only)

Allows the browse to be displayed so that there is no empty space to the right and no horizontal scroll bar by potentially widening or shrinking the last browse column’s width.

Data type: LOGICAL

Access: Readable/Writeable

Applies to: BROWSE widget

When this attribute is specified, and the last browse column can be fully or partially displayed in the browse’s viewport, then the last browse column’s width is adjusted so that it fits within the viewport with no empty space to its right and no horizontal scroll bar.

If the last browse column is fully contained in the viewport with empty space to its right, it grows so that its right edge is adjacent to the vertical scroll bar.

If the last browse column extends outside the viewport, it shrinks so its right edge is adjacent to the vertical scroll bar and the horizontal scroll bar is not needed.

The default value is FALSE.

Note: The FIT-LAST-COLUMN attribute performs the same function as the EXPANDABLE attribute. Progress Software Corporation recommends that you use the FIT-LAST-COLUMN attribute instead of the EXPANDABLE attribute. This recommendation includes replacing EXPANDABLE with FIT-LAST-COLUMN in your current code.

The following shows the DEFINE BROWSE statement syntax with FIT-LAST-COLUMN specified:

DEFINE BROWSE b1 QUERY q1   DISPLAY Customer.CustNum Customer.Name   ENABLE Customer.CustNum WITH 3 DOWN WIDTH 40 FIT-LAST-COLUMN.

The MIN-COLUMN-WIDTH attribute affects the FIT-LAST-COLUMN attribute. As a result, if FIT-LAST-COLUMN is set to TRUE, the last browse column is resized to fit within the viewport only if its width is no smaller than the minimum width. To specify the minimum size that the last browse column’s width can be reduced to, use the MIN-COLUMN-WIDTH-PIXELS or MIN-COLUMN-WIDTH-CHARS attribute. See MIN-COLUMN-WIDTH-PIXELS attribute and MIN-COLUMN-WIDTH-CHARS attribute for more information.

FIT-LAST-COLUMN and NO-EMPTY-SPACE are mutually exclusive. If both are specified in the DEFINE BROWSE statement, the compiler displays an error message. If one attribute is set to TRUE while the other attribute is already TRUE, a warning message displays at run time.

FIT-LAST-COLUMN is primarily intended for use in the initial layout of a static browse. It is most useful when laying out a browse with a specified width when you have only a few browse columns and you want to fully use the available space in your viewport.

If the FIT-LAST-COLUMN attribute is set to TRUE, and, subsequently, any browse column’s width is changed or the browse’s width is changed, then the last browse column’s width might be adjusted so that it fits within the viewport with no empty space and no horizontal scroll bar.

When the last browse column’s width is set at run time after the browse is realized, then FIT-LAST-COLUMN is ignored.

If the FIT-LAST-COLUMN attribute is set to FALSE, the last browse column’s width remains the same and is never changed by ABL.

The FIT-LAST-COLUMN attribute and the EXPANDABLE attribute have the same behavior. Therefore, if you specify the Expand Browse (-expandbrow) startup parameter at startup, the FIT-LAST-COLUMN attribute is set to TRUE for each browse in that session.

See also: DEFINE BROWSE statement

OpenEdge Release 10.2B

Copyright © 2009 Progress Software Corporation