TXTGETFILE Name
TXTGETFILE Purpose
Select a file name.
Category
Calling Sequence
txtgetfile, name Inputs
Keyword Parameters
Keywords
TITLE_TEXT=txt text for title.
Def = Select file option.
QUIT_TEXT=txt text for quit option.
If specified QUIT_TEXT replaces the Accept file
option and supresses the abort file selection
option if ABORT_TEXT not given.
ABORT_TEXT=txt text to replace abort file selection.
/NOCHECK means don't check if file exists.
/MULTIPLE means allow multiple files to be selected.
When /MULT is in effect /NOCHECK automatically is too.
DIRECTORY=dd set default directory. May change.
New directory returned on exit.
WILDCARD=ww set default filename wildcard for searches.
May change, new value is returned on exit.
DEF_EXTENSION=def_ex Default file extension to add if
none given in an entered file name.
NUMDEF=n on input sets item number to highlight as default.
On output returns item number selected.
OPTION1=[title_text, routine]
title_text = the text describing the action of
the optional user supplied file processing procedure.
routine = name of an optional user supplied
procedure that takes as its one argument the file
currently specified. This routine will process
the file in some way, like list it. The specified
procedure must handle errors such as missing files.
OPTION2 through OPTION5 are also allowed and work same.
Outputs
Common Blocks
Notes
Modification History
R. Sterner, 13 Mar, 1992
R. Sterner, 18 May, 1993 --- Added multiple options.
R. Sterner, 19 May, 1993 --- Added DEF_EXTENSION keyword.
R. Sterner, 1 Jun, 1993 --- Added ABORT_TEXT keyword.
R. Sterner, 2 Sep, 1993 --- Added option 5.
R. Sterner, 2010 May 07 --- Converted arrays from () to [].
Copyright (C) 1992, Johns Hopkins University/Applied Physics Laboratory
This software may be used, copied, or redistributed as long as it is not
sold and this copyright notice is reproduced on each copy made. This
routine is provided as is without any express or implied warranties
whatsoever. Other limitations apply as described in the file disclaimer.txt.