# File Selection Window

The "File Selection" window allows the user to perform several useful functions depending upon:

- How the File selection window was called.
  1. If the window is called from File menubutton within the Parameter Editing window, (and no Entry-box had been previously selected) then the file selected is not directly associated with an "entry box" within the Parameter Editing window. However, the default is to associate it with the first entry box. There are two ways too change this behavior.
     1. You must have selected an Entry-box (place the cursor on and Entry-box and press Button-1), and then use either Control-f, or use the pull-down menu. Then any items selected will be inserted in the entry-box that was selected.
     2. You must select an entry box and hit the third (right-most) mouse button - Button-3. (If Button-3 is already used in your window-manager, you can also use Control-Button-3 or Shift-Button-3.)
     Of course any file high-lighted in the File selection window can be copied into any entry box by using the left-mouse-button (Button-1) to select a file, and then selecting an entry box within the Parameter Editing window, and using the middle-mouse-button (Button-2) to insert the filename.

  2. If this window was called by selecting an entry box from within the Parameter Editing window and clicking the right-most-mouse-button (Button-3) within an entry-box, any file selected with the File selection window (or associate windows, e.g., the List of selected items window) will appear in that box once the "OK" button is clicked (or other terminating action is taken). This also causes the File Selection window (and associated windows) to disappear.

- Actions taken by pressing a button after a file is selected:
  1. If the "File" menubutton is selected, the user will be presented with a menu which contains a series of options.
     - Make a list of files? (also accessible by pressing Control-m in the File selection window):
       causes a "List of selected items" window to appear. And operates in connection with the right-most-mouse-button (Button-3). Files selected in the "File selection window" by depressing the right-most-mouse-button (Button-3) will appear in the "List of selected items" window.
     - Cancel? (also accessible by pressing Control-c):
       closes the "File selection window" without returning anything to the "Parameter Editing Window".

  2. If the "Fv" button is used then the "fits_viewer" program is called. This program allows the user to view FITS files as well as examine their contents and plot the information. Thus once you select a file you can hit the "Fv" button to examine the contents of that file, before inputting it into the parameter entry box. This button is provided as a convenience and launchs Fv which is a separate program.

  3. The "OK" button actually has two usages depending upon how the "File Selection" window was called. Basically, if the "File Selection" window was called from the File menu, than the "OK" button is not bound to any entry-box (although the tool now assumes you wish the output sent to the first entry-box), however in general the user should only use this when using the mouse to copy the file into memory, and paste the selected file to a particular entry-box using the middle-mouse-button (Button-2). If the "File Selection" window was called by using the right-mouse-button (Button-3) from within an entry-box than the selected file is inserted into that entry-box.

     If the user has selected the "Attempt to uncompress files automatically?" option from the "Flaunch" window's "Option" menubutton

  4. If the "Help" menubutton is selected, the user will be presented with a menu which contains a series of options.
     - About File selection (also accessible by pressing Control-h):
       displays the hypertext help available on the "File selection window", i.e., the page you are presently looking at.
     - All Topics available (also accessible by pressing Control-a):
       Displays the hypertext help available on all Topics, i.e., a general INDEX of available help pages for Flaunch are displayed, allowing the user to select which windows or behavior they wish to learn about.

Note: The Directory Selection window and the File Selection window rely upon the same procedures, as such they cannot co-exist at the same time without the potential for posible conflicts arising. Thus the window is destroyed and recreated each time it is called. This should not be a problem is the user is calling this window as intended. This window should be called, and used immediately after its creation before the user moves on to other things.

INDEX

Last modified: Tue Jul 29 12:13:34 EDT