# coyote: CGPICKFILE

- coyote/Utilities
- [Source code]

Description

      This is a utility program for selecting data files. It is a wrapper for DIALOG_PICKFILE,
      with the additional functionality of being able to "remember" the name and directory of
      the last file selected by the program. It basically allows you to start the next file
      selection from the location of the previous file selection.

Categories

      Utility

Returns

      The fully-qualified name of the selected file or a null string if the CANCEL
      button was selected.

Keywords

      datadir: in, optional, type=string
          Set this keyword to the name of the data directory. If not set, the program
          assumes the data directory is rooted in the directory that holds this program
          file, or the directory directly above it. If it can't find a "data" directory
          in either of these two locations, the current directory is used as the "data"
          directory. The data directory is ONLY used if there is no "current" last
          directory. In other words, it is only used if cgPickfile has not been called
          in the current IDL session.
      demo: in, optional, type=boolean, default=0
          If set, starts in the !DIR/examples/data directory.
      jpeg: in, optional, type=boolean, default=0
          If set, starts in the "jpeg" directory. It assumes the jpeg directory is rooted
          in the "data" directory.
      hdf: in, optional, type=boolean, default=0
          If set, starts in the "hdf" directory. It assumes the hdf directory is rooted
          in the "data" directory.
      last_file: in, optional, type=boolean, default=0
          If set, the name of the last file opened is placed in the filename widget.
      lidar: in, optional, type=boolean, default=0
          If set, starts in the "lidar" directory. It assumes the lidar directory is
          rooted in the "data" directory.
      ncdf: in, optional, type=boolean, default=0
          If set, starts in the "ncdf" directory. It assumes the ncdf directory is
          rooted in the "data" directory.
      png: in, optional, type=boolean, default=0
          If set, starts in the "png" directory. It assumes the png directory is
          rooted in the "data" directory.
      tiff: in, optional, type=boolean, default=0
          If set, starts in the "tiff" directory. It assumes the tiff directory is
          rooted in the "data" directory.
      title: in, optional, type=string, default="Please Select a File"
          The title for the selection dialog window. If the `Write` keyword is set,
          the default title becomes "Please Select a File for Writing".
      rite: in, optional, type=boolean, default=0
          Set this keyword to change the default title to "Please Select a File for Writing".
      _ref_extra: in, optional
           Accepts any input keywords to DIALOG_PICKFILE (e.g., FILTER).

Author

      FANNING SOFTWARE CONSULTING::
          David W. Fanning
          1645 Sheely Drive
          Fort Collins, CO 80526 USA
          Phone: 970-221-0438
          E-mail: david@idlcoyote.com
          Coyote's Guide to IDL Programming: http://www.idlcoyote.com

History

      Change History::
         Adapted from FSC_PICKFILE to be a Coyote Graphics routine by David W. Fanning, 4 Aug 2011.
         Added keywords TITLE and WRITE to work around a bug in Dialog_Pickfile that clips the
            input filenames. 25 Feb 2012. DWF.
         Swithched from ProgramRootDir to cgSourceDir. 27 Jan 2014. DWF.

Copyright

      Copyright (c) 2011-2014, Fanning Software Consulting, Inc.