d3cd284cfaa9f329e3b94f34ab585b6c044bace9
[geeqie.git] / doc / main_window_file_pane.html
1 <?xml version="1.0" encoding="iso-8859-1"?>
2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
3     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
4
5 <html xmlns="http://www.w3.org/1999/xhtml">
6 <head>
7   <meta http-equiv="CONTENT-TYPE" content="text/html; charset=iso-8859-1" />
8
9   <title>File Pane - Geeqie User Manual</title>
10   <link rel="stylesheet" type="text/css" href="style.css" media="all" />
11   <link rel="stylesheet" type="text/css" href="style_screen.css" media="screen" />
12   <link rel="stylesheet" type="text/css" href="style_print.css" media="print" />
13 </head>
14
15 <body lang="en-US" dir="ltr" xml:lang="en-US">
16   <div class="navtop">
17     <table width="100%" border="0" cellpadding="4" cellspacing="0">
18       <col id="navtop_col1" width="33%"></col>
19       <col id="navtop_col2" width="33%"></col>
20       <col id="navtop_col3" width="33%"></col>
21
22         <tr>
23           <th>
24             <p class="previous"><a href="main_window_layout.html">Previous</a>
25             </p>
26           </th>
27
28           <th>
29             <p class="navtop_title">File Pane &ndash; Main Window</p>
30           </th>
31
32           <th>
33             <p class="next"><a href="main_window_folder_pane.html">Next</a>
34             </p>
35           </th>
36         </tr>
37     </table>
38   </div>
39
40   <hr />
41
42   <h1>File Pane</h1>
43
44   <p>The file pane displays the images contained in the active folder. It has two modes of display, allows multiple selection, and can initiate drag and drop operations.</p>
45
46   <p>A <b>context menu</b> can be displayed by clicking the right mouse button on the file pane or pressing the menu key while the file pane has the focus.</p>
47
48   <h2>List view</h2>
49
50   <p>This mode can be enabled by selecting &ldquo;List&rdquo; from the View menu, pressing <span class="key">Ctrl</span> + <span class="key">L</span> on the keyboard, or unselecting &ldquo;View as icons&rdquo; from the context menu.</p>
51
52   <p>The list view mode displays images in a standard vertical list. Three columns provide the file name, size in bytes, and the time the contents were last modified.</p>
53
54   <p><b>Thumbnails</b> can be displayed next to each file in the list, to toggle thumbnails on or off by selecting &ldquo;Thumbnails&rdquo; from the View menu, pressing the <span class="key">T</span> key, clicking the thumbnail button on the tool bar, or selecting &ldquo;Show thumbnails&rdquo; from the context menu.</p>
55
56   <h2>Icon view</h2>
57
58   <p>This mode can be enabled by selecting &ldquo;Icons&rdquo; from the View menu, pressing <span class="key">Ctrl</span> + <span class="key">I</span> on the keyboard, or selecting &ldquo;View as icons&rdquo; from the context menu.</p>
59
60   <p>The icon view mode displays images as thumbnails in a grid, and by default a file name below each thumbnail.</p>
61
62   <p>The <b>file name</b> displayed below each thumbnail can be turned on or off by selecting &ldquo;Show filename text&rdquo; from the context menu.</p>
63
64   <h2>Multiple selection</h2>
65
66   <p>It is possible to select more than one image from the file pane. Multiple files can be selected with several methods:</p>
67
68   <h3>Mouse</h3>
69   
70   <ul>
71     <li>
72       <p><span class="key">Ctrl</span> + Primary mouse button will add or remove the file from the selection.</p>
73     </li>
74
75     <li>
76       <p>Middle mouse button will toggle selection of the file.</p>
77     </li>
78
79     <li>
80       <p><span class="key">Shift</span> + Primary mouse button will select all images between the clicked and focused image, or it will unselect all those images if the clicked image is already selected.</p>
81     </li>
82
83     <li>
84       <p><span class="key">Shift</span> + <span class="key">Ctrl</span> + Primary mouse button works as <span class="key">Shift</span> + Primary mouse button, but will not change the selection of files outside the region between the focus and clicked image.</p>
85     </li>
86   </ul>
87
88   <h3>Keyboard</h3>
89
90   <ul>
91     <li>
92       <p><span class="key">Ctrl</span> + <span class="key">Arrows</span> will move the focus without changing the selection.</p>
93     </li>
94
95     <li>
96       <p><span class="key">Ctrl</span> + <span class="key">Space</span> will toggle selection of the focused image.</p>
97     </li>
98
99     <li>
100       <p><span class="key">Shift</span> + <span class="key">Arrows</span> will select a region of images.</p>
101     </li>
102
103     <li>
104       <p><span class="key">Shift</span> + <span class="key">Ctrl</span> + <span class="key">Arrows</span> works as <span class="key">Shift</span> + <span class="key">Arrows</span>, but will not change the selection of files outside the current focus region.</p>
105     </li>
106   </ul>
107
108   <p>To select all files press <span class="key">Ctrl</span> + <span class="key">A</span>, or to unselect all image press <span class="key">Ctrl</span> + <span class="key">Shift</span> + <span class="key">A</span>. These operations are also available from the Edit menu as &ldquo;Select all&rdquo; and &ldquo;Select none&rdquo;.</p>
109
110   <p>The current number of selected images and their total size will be indicated in the File list section of the <a href="main_window_status_bar.html">status bar</a>.</p>
111
112   <h2>Sorting</h2>
113
114   <p>The order of the images can be changed by clicking the sort area of the status bar or from the context menu. The sort methods are by file name, number, file date, or file size. The number method will sort file names by their natural order, for example files with names of file_10, file_12, and file_9 will appear in order file_9, file_10, and file_12.</p>
115
116   <p>Selecting the ascending menu item will toggle between increasing and decreasing sort order.</p>
117
118   <h2>Context menu</h2>
119
120   <p>Right clicking the mouse or pressing the menu key while the file pane has focus will display a menu. The menu functions will perform the same as those that match the window's <a href="main_window_menus.html">menu bar</a>, however a few functions are unique to the context menu:</p>
121
122   <dl class="menu_desc">
123
124   <dt>View in new window</dt>
125   <dd>Opens a new window containing a list of the currently selected images.</dd>
126
127   <dt>Sort</dt>
128   <dd>Changes the sort order of file pane.</dd>
129
130   <dt>View as icons</dt>
131   <dd>Toggles between the list and icon view modes.</dd>
132
133   <dt>Show thumbnails</dt>
134   <dd>Toggles display of thumbnails in the list view display mode.</dd>
135
136   <dt>Show filename text</dt>
137   <dd>Toggles display of file names in the icon view display mode.</dd>
138  
139   </dl>
140
141   <h2>Drag and Drop</h2>
142
143   <p>Drag and drop can be initialized with the primary or middle mouse buttons in the file pane. Dragging a file that is selected will include all selected files in the drag. Dragging a file that is not selected will first change the selection to the dragged file, and clear the previous selection.</p>
144
145   <hr id="bottomseparator" />
146
147   <div class="navbottom">
148     <table width="100%" border="0" cellpadding="4" cellspacing="0">
149       <col id="navbottom_col1" width="33%"></col>
150       <col id="navbottom_col2" width="33%"></col>
151       <col id="navbottom_col3" width="33%"></col>
152
153         <tr>
154           <th>
155             <p class="previous"><a href="main_window_layout.html">Previous</a>
156             </p>
157           </th>
158
159           <th>
160             <p class="navbottom_title"><a href="index.html">Contents</a>
161             </p>
162           </th>
163
164           <th>
165             <p class="next"><a href="main_window_folder_pane.html">Next</a>
166             </p>
167           </th>
168         </tr>
169
170     </table>
171   </div>
172
173   <div class="footer">Geeqie User Manual</div>
174   <div class="bottomspacer">&nbsp;</div>
175 </body>
176 </html>