Move from xhtml transitional to xhtml strict.
[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" />
11 </head>
12
13 <body lang="en-US" dir="ltr" xml:lang="en-US">
14   <div class="navtop">
15     <table width="100%" border="0" cellpadding="4" cellspacing="0">
16       <col id="navtop_col1" width="33%"></col>
17       <col id="navtop_col2" width="33%"></col>
18       <col id="navtop_col3" width="33%"></col>
19
20         <tr>
21           <th>
22             <p class="previous"><a href="main_window_layout.html">Previous</a>
23             </p>
24           </th>
25
26           <th>
27             <p class="navtop_title">File Pane &ndash; Main Window</p>
28           </th>
29
30           <th>
31             <p class="next"><a href="main_window_folder_pane.html">Next</a>
32             </p>
33           </th>
34         </tr>
35     </table>
36   </div>
37
38   <hr />
39
40   <h1>File Pane</h1>
41
42   <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>
43
44   <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>
45
46   <h2>List view</h2>
47
48   <p>This mode can be enabled by selecting &ldquo;List&rdquo; from the View menu, pressing Control + L on the keyboard, or unselecting &ldquo;View as icons&rdquo; from the context menu.</p>
49
50   <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>
51
52   <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 T key, clicking the thumbnail button on the tool bar, or selecting &ldquo;Show thumbnails&rdquo; from the context menu.</p>
53
54   <h2>Icon view</h2>
55
56   <p>This mode can be enabled by selecting &ldquo;Icons&rdquo; from the View menu, pressing Control + I on the keyboard, or selecting &ldquo;View as icons&rdquo; from the context menu.</p>
57
58   <p>The icon view mode displays images as thumbnails in a grid, and by default a file name below each thumbnail.</p>
59
60   <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>
61
62   <h2>Multiple selection</h2>
63
64   <p>It is possible to select more than one image from the file pane. Multiple files can be selected with several methods:</p>
65
66   <h3>Mouse</h3>
67   
68   <ul>
69     <li>
70       <p>Control + Primary mouse button will add or remove the file from the selection.</p>
71     </li>
72
73     <li>
74       <p>Middle mouse button will toggle selection of the file.</p>
75     </li>
76
77     <li>
78       <p>Shift + 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>
79     </li>
80
81     <li>
82       <p>Shift + Control + Primary mouse works as Shift + Primary, but will not change the selection of files outside the region between the focus and clicked image.</p>
83     </li>
84   </ul>
85
86   <h3>Keyboard</h3>
87
88   <ul>
89     <li>
90       <p>Control + Arrows will move the focus without changing the selection.</p>
91     </li>
92
93     <li>
94       <p>Control + Space will toggle selection of the focused image.</p>
95     </li>
96
97     <li>
98       <p>Shift + Arrows will select a region of images.</p>
99     </li>
100
101     <li>
102       <p>Shift + Control + Arrows works as Shift + Arrows, but will not change the selection of files outside the current focus region.</p>
103     </li>
104   </ul>
105
106   <p>To select all files press Control + A, or to unselect all image press Control + Shift + A. These operations are also available from the Edit menu as &ldquo;Select all&rdquo; and &ldquo;Select none&rdquo;.</p>
107
108   <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>
109
110   <h2>Sorting</h2>
111
112   <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>
113
114   <p>Selecting the ascending menu item will toggle between increasing and decreasing sort order.</p>
115
116   <h2>Context menu</h2>
117
118   <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>
119
120   <dl class="menu_desc">
121
122   <dt>View in new window</dt>
123   <dd>Opens a new window containing a list of the currently selected images.</dd>
124
125   <dt>Sort</dt>
126   <dd>Changes the sort order of file pane.</dd>
127
128   <dt>View as icons</dt>
129   <dd>Toggles between the list and icon view modes.</dd>
130
131   <dt>Show thumbnails</dt>
132   <dd>Toggles display of thumbnails in the list view display mode.</dd>
133
134   <dt>Show filename text</dt>
135   <dd>Toggles display of file names in the icon view display mode.</dd>
136  
137   </dl>
138
139   <h2>Drag and Drop</h2>
140
141   <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>
142
143   <hr id="bottomseparator" />
144
145   <div class="navbottom">
146     <table width="100%" border="0" cellpadding="4" cellspacing="0">
147       <col id="navbottom_col1" width="33%"></col>
148       <col id="navbottom_col2" width="33%"></col>
149       <col id="navbottom_col3" width="33%"></col>
150
151         <tr>
152           <th>
153             <p class="previous"><a href="main_window_layout.html">Previous</a>
154             </p>
155           </th>
156
157           <th>
158             <p class="navbottom_title"><a href="index.html">Contents</a>
159             </p>
160           </th>
161
162           <th>
163             <p class="next"><a href="main_window_folder_pane.html">Next</a>
164             </p>
165           </th>
166         </tr>
167
168     </table>
169   </div>
170
171   <div class="footer">Geeqie User Manual</div>
172   <div class="bottomspacer">&nbsp;</div>
173 </body>
174 </html>