# List of Selected Items Window

The "List of Selected Items" window first appears as simply a blank window. During its creation several bindings are made to various mouse buttons when the focus is in a specific window. Since the "List of Selected Items" window can be associated with ANY listbox and has to operate closely with the parent window in which that listbox is contained, the mouse bindings which are defined allow the two listbox's (the one in the "List of Selected Items" window, and the one in the calling window) to be intimately associated.

It is important for the user to realize that while in the following example we are talking about the "File selection window" the SAME mouse bindings are made in ANY window which calls this procedure, and the listbox associated with this window is the listbox in the calling window.

For conveniences sake we will assume that the "List of Selected Items" window is associated with the "File selection window". So when the "List of Selected Items" window is first created it binds the right-most-mouse-button (from the calling listbox) to populate the "List of Selected Items" window. Thus if in the "File selection" window the user points at a file, and presses the right-most-mouse-button the name of the file will appear in the "List of Selected Items" window. (See below.)

We see that the full path has been prepended to the filename that was selected - please note that the left-most-mouse-button in the "File selection" window remains associated ONLY with the "File selection" window, and only when the right-most-mouse-button is pressed in the "File selection" window, does the filename get added to the "List of Selected Items" window. (Note the the user can also keep this button depressed and drag the cursor to select multiple files - they are added upon release of the button.) If the user wished to remove an item from the "List of Selected Items" window, all that is necessary is to press the left-most-mouse-button when over the item that is wished to be removed. (Note that the user can also keep this button depressed and drag the cursor to de-select multiple files - they will be removed upon release of the button.)

Thus the user can creat a list of items (in the above case these items are filenames and their associated paths).

Once the user has a list of selected items then the user can turn to the Menubottons which are available to manipulate this list.

The File menu:

If the user selects the File menu the following will be displayed:

We see here that there are two options that can be selected.

- Save list to File? (also accessible by pressing Control-s):
  This option allows the user to save the selected items to a file. However, the behavior differes depending upon how the List of Selected items window was called, and as a result what exactly is being stored in the file being created. Thus what happens at this point may be:
  - given the option to enter a filename into a dialog box .
  - be returned to the calling window, with a special file having been created for flaunch's usage only.

- Cancel (also accessible by pressing Control-c):
  This option closes the "List of Selected Items" window, and unbinds the associated mouse-keys.

The Help menu:

If the user selects the Help menu the following list of options will be presented:

- About making a list (also accessible by pressing Control-h):
  This displays the on-line help window associated with the "List of Selected Items" window, i.e., the hypertext document you are presently viewing.

- 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.

INDEX
Last modified: Mon Jul 28 14:48:01 EDT