Sync to GQview 1.5.9 release.
[geeqie.git] / doc / 2_4_file_pane.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
2 <HTML>
3 <HEAD>
4         <META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=iso-8859-1">
5         <TITLE>File Pane - GQview User Manual</TITLE>
6         <META NAME="GENERATOR" CONTENT="OpenOffice.org 1.1.0  (Linux)">
7         <META NAME="CREATED" CONTENT="20040805;23590500">
8         <META NAME="CHANGED" CONTENT="20041022;16274600">
9 </HEAD>
10 <BODY LANG="en-US" DIR="LTR">
11 <CENTER>
12         <TABLE WIDTH=100% BORDER=0 CELLPADDING=4 CELLSPACING=0 STYLE="page-break-before: always">
13                 <COL WIDTH=85*>
14                 <COL WIDTH=85*>
15                 <COL WIDTH=85*>
16                 <THEAD>
17                         <TR VALIGN=TOP>
18                                 <TD WIDTH=33%>
19                                         <P><A HREF="2_3_layout.html">Previous</A></P>
20                                 </TD>
21                                 <TD WIDTH=33%>
22                                         <P ALIGN=CENTER>File Pane &ndash; Main Window</P>
23                                 </TD>
24                                 <TD WIDTH=33%>
25                                         <P ALIGN=RIGHT><A HREF="2_5_folder_pane.html">Next</A></P>
26                                 </TD>
27                         </TR>
28                 </THEAD>
29         </TABLE>
30 </CENTER>
31 <HR>
32 <H1>2.4 File Pane</H1>
33 <P>The file pane displays the images contained in the active folder.
34 It has two modes of display, allows multiple selection, and can
35 initiate drag and drop operations.</P>
36 <P>A <B>context menu</B> can be displayed by clicking the right mouse
37 button on the file pane or pressing the menu key while the file pane
38 has the focus.</P>
39 <P><BR><BR>
40 </P>
41 <P><U>List view</U></P>
42 <P STYLE="margin-left: 0.79in">This mode can be enabled by selecting
43 &ldquo;List&rdquo; from the View menu, pressing Control + L on the
44 keyboard, or unselecting &ldquo;View as icons&rdquo; from the context
45 menu.</P>
46 <P STYLE="margin-left: 0.79in">The list view mode displays images in
47 a standard vertical list. Three columns provide the file name, size
48 in bytes, and the time the contents were last modified.</P>
49 <P STYLE="margin-left: 0.79in"><B>Thumbnails</B> can be displayed
50 next to each file in the list, to toggle thumbnails on or off by
51 selecting &ldquo;Thumbnails&rdquo; from the View menu, pressing the T
52 key, clicking the thumbnail button on the tool bar, or selecting
53 &ldquo;Show thumbnails&rdquo; from the context menu.</P>
54 <P><BR><BR>
55 </P>
56 <P><U>Icon view</U></P>
57 <P STYLE="margin-left: 0.79in">This mode can be enabled by selecting
58 &ldquo;Icons&rdquo; from the View menu, pressing Control + I on the
59 keyboard, or selecting &ldquo;View as icons&rdquo; from the context
60 menu.</P>
61 <P STYLE="margin-left: 0.79in">The icon view mode displays images as
62 thumbnails in a grid, and by default a file name below each
63 thumbnail.</P>
64 <P STYLE="margin-left: 0.79in">The <B>file name</B> displayed below
65 each thumbnail can be turned on or off by selecting &ldquo;Show
66 filename text&rdquo; from the context menu.</P>
67 <P><BR><BR>
68 </P>
69 <P><U>Multiple selection</U></P>
70 <P STYLE="margin-left: 0.79in">It is possible to select more than one
71 image from the file pane. Multiple files can be selected with several
72 methods:</P>
73 <P STYLE="margin-left: 0.79in"><B>Mouse:</B></P>
74 <UL>
75         <LI><P>Control + Primary mouse button will add or remove the file
76         from the selection.</P>
77         <LI><P>Middle mouse button will toggle selection of the file.</P>
78         <LI><P>Shift + Primary mouse button will select all images between
79         the clicked and focused image, or it will unselect all those images
80         if the clicked image is already selected.</P>
81         <LI><P>Shift + Control + Primary mouse works as Shift + Primary, but
82         will not change the selection of files outside the region between
83         the focus and clicked image.</P>
84 </UL>
85 <P STYLE="margin-left: 0.79in"><B>Keyboard:</B></P>
86 <UL>
87         <LI><P>Control + Arrows will move the focus without changing the
88         selection.</P>
89         <LI><P>Control + Space will toggle selection of the focused image.</P>
90         <LI><P>Shift + Arrows will select a region of images.</P>
91         <LI><P>Shift + Control + Arrows works as Shift + Arrows, but will
92         not change the selection of files outside the current focus region.</P>
93 </UL>
94 <P STYLE="margin-left: 0.79in">To select all files press Control + A,
95 or to unselect all image press Control + Shift + A. These operations
96 are also available from the Edit menu as &ldquo;Select all&rdquo; and
97 &ldquo;Select none&rdquo;.</P>
98 <P STYLE="margin-left: 0.79in">The current number of selected images
99 and their total size will be indicated in the File list section of
100 the <A HREF="2_7_status_bar.html">status bar</A>.</P>
101 <P><BR><BR>
102 </P>
103 <P><U>Sorting</U></P>
104 <P STYLE="margin-left: 0.79in">The order of the images can be changed
105 by clicking the sort area of the status bar or from the context menu.
106 The sort methods are by file name, number, file date, or file size.
107 The number method will sort file names by their natural order, for
108 example files with names of file_10, file_12, and file_9 will appear
109 in order file_9, file_10, and file_12.</P>
110 <P STYLE="margin-left: 0.79in">Selecting the ascending menu item will
111 toggle between increasing and decreasing sort order.</P>
112 <P><BR><BR>
113 </P>
114 <P><U>Context menu</U></P>
115 <P>Right clicking the mouse or pressing the menu key while the file
116 pane has focus will display a menu. The menu functions will perform
117 the same as those that match the window's <A HREF="2_2_menus.html">menu
118 bar</A>, however a few functions are unique to the context menu:</P>
119 <P STYLE="margin-left: 0.79in"><B>View in new window:</B> Opens a new
120 window containing a list of the currently selected images.</P>
121 <P STYLE="margin-left: 0.79in"><B>Sort:</B> Changes the sort order of
122 file pane.</P>
123 <P STYLE="margin-left: 0.79in"><B>View as icons:</B> Toggles between
124 the list and icon view modes.</P>
125 <P STYLE="margin-left: 0.79in"><B>Show thumbnails:</B> Toggles
126 display of thumbnails in the list view display mode.</P>
127 <P STYLE="margin-left: 0.79in; font-weight: medium"><B>Show filename
128 text:</B> Toggles display of file names in the icon view display
129 mode.</P>
130 <P><BR><BR>
131 </P>
132 <P><U>Drag and Drop</U></P>
133 <P STYLE="margin-left: 0.79in">Drag and drop can be initialized with
134 the primary or middle mouse buttons in the file pane. Dragging a file
135 that is selected will include all selected files in the drag.
136 Dragging a file that is not selected will first change the selection
137 to the dragged file, and clear the previous selection.</P>
138 <P><BR><BR>
139 </P>
140 <P><BR><BR>
141 </P>
142 <HR>
143 <CENTER>
144         <TABLE WIDTH=100% BORDER=0 CELLPADDING=4 CELLSPACING=0>
145                 <COL WIDTH=85*>
146                 <COL WIDTH=85*>
147                 <COL WIDTH=85*>
148                 <THEAD>
149                         <TR VALIGN=TOP>
150                                 <TD WIDTH=33%>
151                                         <P><A HREF="2_3_layout.html">Previous</A></P>
152                                 </TD>
153                                 <TD WIDTH=33%>
154                                         <P ALIGN=CENTER><A HREF="index.html">Contents</A></P>
155                                 </TD>
156                                 <TD WIDTH=33%>
157                                         <P ALIGN=RIGHT><A HREF="2_5_folder_pane.html">Next</A></P>
158                                 </TD>
159                         </TR>
160                 </THEAD>
161                 <TBODY>
162                         <TR VALIGN=TOP>
163                                 <TD WIDTH=33%>
164                                         <P><BR>
165                                         </P>
166                                 </TD>
167                                 <TD WIDTH=33%>
168                                         <P ALIGN=CENTER><BR>
169                                         </P>
170                                 </TD>
171                                 <TD WIDTH=33%>
172                                         <P ALIGN=RIGHT>GQview User Manual</P>
173                                 </TD>
174                         </TR>
175                 </TBODY>
176         </TABLE>
177 </CENTER>
178 <P STYLE="margin-bottom: 0in"><BR>
179 </P>
180 </BODY>
181 </HTML>