>  Docs Center  >  Libraries  >  JHU/APL/S1R  >  TXTGETFILE

TXTGETFILE

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.



© 2019 Harris Geospatial Solutions, Inc. |  Legal
My Account    |    Store    |    Contact Us