\documentclass[10pt,letterpaper, final]{report} % \documentclass{} required in all files

\usepackage{../preamble/myWEPS} % This is now our single preamble file inclusion (it assumes a “.sty” file extension)

\begin{document}

% \chapter{\WEPSFileChoosers} \label{ch:\WEPSFileChoosers}

WEPS users often have the need to select files and folders within the WEPS user interface,
whether it be management and soil records, WEPS Projects, selecting WEPS Run names, etc.
For WebStart WEPS, these files and records could be located within the local computer file system,
available on shared drive locations or even obtained remotely via a CSIP service.
The standard Java FileChooser did not have the ability to provide all of that functionality
through a single interface window.
Therefore we developed the WEPS FileChooser that provides the necessary functionality
that WebStart WEPS requires through a common FileChooser interface.
This FileChooser contains some unique features that probably don't exist in most other FileChooser interfaces,
so we have provided this chapter %%section?
documenting all of the WEPS FileChooser features and functionality.

	\section{\WEPSFileChooserElements} \label{sec:\WEPSFileChooserElements}

An example of a WebStart WEPS FileChooser (\cref{fig:WebStart_WEPS_FileChooser})
is shown here.

\begin{figure}[H]
\centering
	\includegraphics[scale=1.68]{images/WEPS_FileChoosers/WebStart_WEPS_FileChooser.jpg}
\caption{A standard WebStart WEPS FileChooser.}
\label{fig:WebStart_WEPS_FileChooser}
\end{figure}

The standard WebStart WEPS FileChooser may contain the following elements:

\begin{itemize}[noitemsep]
\item{WEPS FileChooser title} (e.g. \textbf{Select directory for new Run Location.} in \cref{fig:WebStart_WEPS_FileChooser})
\item{\textbf{Path:} prompt and folder field} with a drop down choice list selection option on right side of field 
\scalerel*{\img{images/icons/down_arrow.png}}{\strut}
\item{Full path displayed as text}
\item{\textbf{Button Toolbar} with button shortcuts to specific locations}
(e.g. \scalerel*{\img{images/WEPS_FileChoosers/DefLoc_CfgDefLoc_ProjDir_Home_buttons.jpg}}{\strut} in \cref{fig:WebStart_WEPS_FileChooser})
\item{\textbf{Create new subfolder} button icon}
\scalerel*{\img{images/icons/folder.jpg}}{\strut}
\item{\textbf{Move into parent folder location} button icon}
\scalerel*{\img{images/icons/file_up_arrow.jpg}}{\strut}
\item{\textbf{List Details} button (provides additional table columns)}
\item{Tabular display containing the following columns:}
\begin{itemize}[noitemsep]
\item[]{Col 1:} folder or file icon
\item[]{Col 2:} file and folder names
\item[]{Col 3:} file or folder type
\item[]{Col 4:} file or folder date (if \scalerel*{\img{images/WEPS_FileChoosers/list_details_button.jpg}}{\strut} button enabled)
\item[]{Col 5:} file size in bytes (if \scalerel*{\img{images/WEPS_FileChoosers/list_details_button.jpg}}{\strut} button enabled)
\end{itemize}
\item{\textbf{File:} prompt and input field} (prompt could be named differently, e.g. \textbf{Folder:} as in \cref{fig:WebStart_WEPS_FileChooser})
\item{\textbf{Filter type:} prompt and filter field with a drop down choice list selection option on right side of field}
\scalerel*{\img{images/icons/down_arrow.png}}{\strut}
\item{\textbf{Select} button} (could be named differently, e.g.
\scalerel*{\img{images/WEPS_FileChoosers/Select_Run_Loc_button.jpg}}{\strut} as in \cref{fig:WebStart_WEPS_FileChooser})
\item{\textbf{Cancel} button}
\end{itemize}

Additional elements may exist on individual WEPS FileChoosers, such as this one
(\cref{fig:WebStart_WEPS_FileChooser_1})

\begin{figure}[H]
\centering
	\includegraphics[scale=1.68]{images/WEPS_FileChoosers/WebStart_WEPS_FileChooser_1.jpg}
\caption{WEPS FileChooser containing \textbf{Recursive} and \textbf{In Place} check box elements.}
\label{fig:WebStart_WEPS_FileChooser_1}
\end{figure}

The two additional check box elements shown in \cref{fig:WebStart_WEPS_FileChooser_1} are:
\begin{itemize}[noitemsep]
\item{\textbf{Recursive}} check box for applying the action recursively below the selected folder
\item{\textbf{In Place}} check box for applying the action within the current selected folder
\end{itemize}

	\section{\WEPSFileChooserFeatures} \label{sec:\WEPSFileChooserFeatures}

As mentioned previously WEPS FileChoosers are used to select either files or folders
and in some FileChooser instances possibly multiple files or folders.
The FileChooser prompts may adjust depending on whether it is being used to select files or folders.
In addition, the \textbf{Filter} (or \textbf{File}) type specification
determines what kind of files or folders are displayed
and selectable based upon their name extensions.

	\subsection{\WEPSFileChooserSelectionMethods} \label{subsec:\WEPSFileChooserSelectionMethods}
	
For example a FileChooser intended to select an existing \textbf{WEPS Project},
which is a folder with a \textbf{.prj} extension,
will allow immediate selection and close the FileChooser with a left mouse button double click.
If the folder does not contain that \textbf{.prj} extension (as specified via the \textbf{Filter type}),
then a left mouse button double click will instead simply change the current folder displayed to having the selected
folder become the current folder displayed.

The user can also simply select a file or folder with a single left button mouse click
and then click the FileChooser's \textbf{Select} \scalerel*{\img{images/icons/select.png}}{\strut} button
to initiate the FileChooser's action and close the displayed window.

	\subsection{\WEPSFileChooserPathShortcuts} \label{subsec:\WEPSFileChooserPathShortcuts}

The user has several options available to traverse the currently selected path within the FileChooser
or switch to other locations for the desired file(s) or folder(s) to select.

The user can traverse up the path tree one folder at a time by clicking on the up arrow folder icon
\scalerel*{\img{images/icons/file_up_arrow.jpg}}{\strut}
and selecting folders within the display to traverse down the path.
Or, they can select a subfolder from within the current path displayed
via the \textbf{Path:} field by using the drop down choice list
\scalerel*{\img{images/icons/down_arrow.png}}{\strut}.
An example is shown here in 
\cref{fig:WebStart_WEPS_FileChooser_dropdown_path} 
using the mouse to select the \textbf{WEPS Files} subfolder.
The current path of the selected subfolder will immediately update after the selection is made as shown in
\cref{fig:WebStart_WEPS_FileChooser_current_path}.

\begin{figure}[H]
\centering
	\includegraphics[scale=1.68]{images/WEPS_FileChoosers/WebStart_WEPS_FileChooser_dropdown_path.jpg}
\caption{WEPS FileChooser drop down choice list displaying subfolders.}
\label{fig:WebStart_WEPS_FileChooser_dropdown_path}
\end{figure}

\begin{figure}[H]
\centering
	\includegraphics[scale=1.68]{images/WEPS_FileChoosers/WebStart_WEPS_FileChooser_current_path.jpg}
\caption{WEPS FileChooser current path display.}
\label{fig:WebStart_WEPS_FileChooser_current_path}
\end{figure}

There are usually a shortcut button available that can take the user back to the original default location,
e.g. the \scalerel*{\img{images/WEPS_FileChoosers/DefLoc_button.jpg}}{\strut} button.
Other shortcut buttons are normally available on individual FileChoosers based upon what the individual FileChooser's intent is.
For example, some common generic shortcut buttons are the \scalerel*{\img{images/WEPS_FileChoosers/ProjDir_button.jpg}}{\strut}
and \scalerel*{\img{images/WEPS_FileChoosers/Home_button.jpg}}{\strut} buttons,
which go to the current WEPS Project folder and the user's "home" folder on their computer system respectively.

	\subsection{\WEPSFileChooserActionOptions} \label{subsec:\WEPSFileChooserActionOptions}

In some FileChoosers, there may be actions initiated when clicking on the FileChooser's \textbf{Select}
\scalerel*{\img{images/icons/select.png}}{\strut} button.
Those actions may be modified by other options available in a specific FileChooser,
such as the \textbf{Recursive} and \textbf{In Place} check boxes shown in the
Management Updating folder selection's FileChooser window
as shown in \cref{fig:WebStart_WEPS_FileChooser_1}
(which is accessible via the MCREW \textbf{Tools/Update WEPS Management files/Select Directory} menu sub-option).


\end{document}