This dialog window allows users to choose a set of folders and subfolders in which the program Line Counter has to look for files for a line counting analysis. After this dialog window is opened it scans for all existing folders and subfolders beginning at given base folder. Please take a closer look at figure below to get an impression about this dialog.
As shown in figure above, the dialog window Select Included Folders mainly consists of a list box that shows all found subfolders as well as theirs parent folder. Furthermore, in the upper right corner is shown a check–box. This check–box allows uses to switch between list view and details view. In list view just the found folder names are visible. But the whole search result is presented a bit more compact.
Below the list showing the scanning results users can find three buttons which easily allow some standard selecting operations. See following explanations for more details about how these buttons working.
[Check All] | This button marks all available list items as checked independent of if they are selected or not. |
[Uncheck All] | This button removes the checkmarks from all available list items independent of if they are selected or not. |
[Toggle] | This button toggles the checkmarks of all available list items but only if either no list item or just one single list item is currently selected. In case of the user selected more than one list item only the checkmarks of currently selected list items are toggled! |
Right here just one word about preselecting list items seems to be interesting. If this dialog window opened the first time then all fitting searching results are checked by default. If then the user chooses only a subset of all available items and closes the dialog window afterwards by using button [OK] the chosen folder list is saved. If then the user opens this dialog window twice within the same base path then the dialog box only checks all previously chosen folder, but only if they still exist on the hard drive.
As mentioned above the dialog’s item list distinguishes between checked items and selected item. This is reason enough to take a closer look at the difference. A list item is checked as soon as its belonging check–box is marked. Otherwise this item is not checked. On the other hand, a list item is selected as soon as it is chosen with the mouse. This action automatically changes the color of this item to a blue background and a white font. Please note the result list also supports a selection of multiple items. This multi–selection can be accomplished by pressing and keeping pressed either keyboard button SHIFT or CTRL. In case of using button SHIFT all items between the first selected item and the currently click item are selected. In case of using button CTRL only the clicked items are selected. This behavior is very similar to selecting files and folders in the Windows Explorer.
Last but not least, a note to the scanning operation performed by dialog window Select Included Folders. As explained above the dialog window starts scanning given base folder directly after it is opened. But this scan operation may take a second. For this purpose a background thread is started which is doing the work of finding matches. Sometimes it might happen that user choose a base folder that includes many subfolders. In such a case folder searching may take longer. But this shouldn’t be a problem because users can close this dialog window any time. The background thread is then simply aborted.
See also:
Copyright © plexdata.de