~~Title: Checkbox Mode ~~
<pageheader/>

Checkbox mode is a mode that can be turned on in a file display (it is not a global setting like [[single-click_mode|single-click mode]]) that displays checkboxes next to each item.

{{:media:13:check-box_2.png?nolink|}} 

Checkbox mode can be turned on with the command in the **Folder** drop-down menu. It's part of [[:basic_concepts:folder_options|the folder format]] and can be turned on permanently for certain folders using the folder formats system.

==What check-box mode does==

Checkbox mode changes which files are considered for use in file operations (for example, when you click the **Copy Files** button):

  * Normally (when not in check-box mode), functions like **Copy Files** act on all //**selected**// files. 
  * When in checkbox mode, functions like **Copy Files** act on all //**checked**// files. 

So in the above screenshot, clicking the **Copy Files** button would copy the files **IMG2154.JPG** and **Spectrum.mp3** to the destination, but not **What's New.docx**.

==Easier file selection==

The main advantage of check-box mode is that it provides selection persistence in the view modes where it is normally very easy to deselect files accidentally. Clicking an empty area of the file display (or indeed, clicking any file) will still cause all files to be deselected, but their //checked states// will not be disturbed. One practical outcome of this is that you can double-click on a file to open it, or select files and drag-and-drop them, without modifying the checked states of any other files in the list.

==Using checkbox mode : a case study==

Let's look at a real-world case: imagine that you want to browse through a folder of your holiday photos, to identify the ones you want to send to your friends.

  - Turn on checkbox mode in the file display, and open the [[..:..:the_lister:viewer_pane|Viewer pane]] by clicking the button in the toolbar (or press <kbd>F7</kbd>). 
  - Click on the first file in the folder to select it. It will be displayed in the Viewer pane. 
  - If you want to keep that image, click its checkbox with the mouse (or, press the <kbd>Space</kbd> bar) to check it. 
  - Click on the next image in the folder (or, press <kbd>Down</kbd>) to preview the next image, and so on. 

At the end of this process, you will have viewed all the images in the folder, and the ones that you wanted to keep will still be checked. You can then use **Copy Files** to copy them to another folder (or alternatively, use the **Edit / Invert Selection** command to invert the check states, and then delete the files you don't want to keep).

Without check-box mode you would have had to copy or delete each file as you viewed it - this way, you can concentrate on viewing the images, and then copy or delete them as a batch at the very end.

==Points to remember==

The main points to keep in mind about check-box mode are:

  * When in check-box mode, functions that normally act on selected files instead act on checked files. 
  * Selection commands like **Edit / Select All** or **Edit / Invert Selection** will affect the checked state of files rather than the selected state. 
  * You can double-click on a file to open it without losing the check states of other files. 
  * Drag-and-drop still works on selected files, not checked ones. 
  * Pressing <kbd>Space</kbd> toggles the check state of all currently selected files. 

==Selections to checkboxes and back again==

There are two commands in the **Edit / Select Other** menu that can be useful when in check-box mode:

  * **Selection to Checkboxes**: This command copies the current selection state of each file to its checked state (so selected files will be checked, and unselected files will be unchecked). If the file display is not already in check-box mode when you run this command it will be turned on automatically. This could be useful if you have started selecting multiple files and decide that check-box mode would be a better way to accomplish your task. 
  * **Checkboxes to Selection**: The reverse of the above command - the current checked state of each file will be copied to its selection state. This is useful if you have checked some files and then want to select them for drag-and-drop. 

==Another use for checkbox mode==

The [[:additional_functionality:viewing_images:image_marking|image marking]] function in the [[:additional_functionality:viewing_images|standalone image viewer]] can make use of checkbox mode (if the default option to use a File Collection is turned off). When you tag a file through the viewer in this mode, the file display it came from is automatically placed in check-box mode, and the file in question is checked.