VIEW statement

Displays a widget (sets its VISIBLE attribute to TRUE).

Note: Does not apply to SpeedScript programming.

Syntax

VIEW
  [ STREAM stream | STREAM-HANDLE handle ]
  [ widget-phrase ]
  [ IN WINDOW window ]
STREAM stream

Specifies the name of a stream. If you do not name a stream, the AVM uses the unnamed stream.

STREAM-HANDLE handle

Specifies the handle to a stream. If handle it is not a valid handle to a stream, the AVM generates a run-time error. Note that stream handles are not valid for the unnamed streams. See the chapter on alternate I/O sources in OpenEdge Development: Programming Interfaces for more information on streams and stream handles.

widget-phrase

Specifies the widget you want to view. You can view windows, frames, and field-level widgets. You cannot view menus. If you do not use this option, VIEW sets the VISIBLE attribute for the default frame for the current block.

IN WINDOW window

Specifies the window in which to view the widget.

Example

The r-view2.p procedure displays information on a sales representative and then displays all the Customers belonging to that sales representative. Each new sales representative is displayed on a new page. In addition, if the information for a sales representative takes up more than one page, a separate FORM statement describes a continuation header for that sales representative. The VIEW statement for the PAGE-TOP frame hdr2, activates the header for subsequent page breaks.

r-view2.p

OUTPUT TO slsrep PAGED PAGE-SIZE 10.

FOR EACH SalesRep NO-LOCK:
  PAGE.
  FORM HEADER "Sales rep report" "Page" AT 60 PAGE-NUMBER FORMAT ">>>9".

  DISPLAY SKIP(1) SalesRep.SalesRep SalesRep.RepName SalesRep.Region 
    WITH NO-LABELS.

  FORM HEADER "Sales rep report" SalesRep.SalesRep "(continued)"
    "Page" AT 60 PAGE-NUMBER FORMAT ">>>9" SKIP(1)
    WITH FRAME hdr2 PAGE-TOP.
  VIEW FRAME hdr2.

  FOR EACH Customer OF SalesRep NO-LOCK:
    DISPLAY Customer.CustNum Customer.Name Customer.Address Customer.City
      Customer.State.
  END.
END.

Notes

See also

DEFINE STREAM statement, HIDE statement, Widget phrase, Stream object handle