XDISPLAYFILE

The XDISPLAYFILE procedure displays an ASCII text file using a widget interface.

This routine is written in the IDL language. Its source code can be found in the file xdisplayfile.pro in the lib subdirectory of the IDL distribution.

Calling Sequence

XDISPLAYFILE, Filename

Arguments

Filename

A scalar string that contains the filename of the file to display. Filename can include a path to that file.

Keywords

BLOCK

Set this keyword to have XMANAGER block when this application is registered. By default, BLOCK is set equal to zero, providing access to the command line if active command line processing is available. Note that setting BLOCK=1 will cause all widget applications to block, not just this application. For more information, see the documentation for the NO_BLOCK keyword to XMANAGER .

FONT

A string containing the name of the font to use. The font specified is a "device font" (an X Windows font on Motif systems; a TrueType or PostScript font on Windows or Macintosh systems). See for details on specifying names for device fonts. If this keyword is omitted, the default font is used.

GROUP

The widget ID of the widget that calls XDISPLAYFILE. If this keyword is specified, the death of the group leader results in the death of XDISPLAYFILE.

HEIGHT

The number of text lines that the widget should display at one time. If this keyword is not specified, 24 lines is the default.

MODAL

Set this keyword to create the XDISPLAYFILE dialog as a modal dialog. Setting the MODAL keyword allows you to call XDISPLAYFILE from another modal dialog.

TEXT

A string or string array to be displayed in the widget instead of the contents of a file. If this keyword is present, the Filename input argument is ignored (but is still required). String arrays are displayed one element per line.

TITLE

A string to use as the widget title rather than the file name or "XDisplayFile".

WIDTH

The width of the widget display in characters. If this keyword is not specified, 80 characters is the default.

See Also

PRINT/PRINTF , XYOUTS