Mercurial > geeqie

view doc/2_2_menus.html @ 739:3296f8d3a79b

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Move code from exit_program_final() to new sync_options_with_current_state().
author zas_
date Thu, 22 May 2008 22:49:07 +0000
parents e0d0593d519e
children 1b01410e6860
line wrap: on
line source

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD>
	<META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=iso-8859-1">
	<TITLE>Menus - GQview User Manual</TITLE>
	<META NAME="GENERATOR" CONTENT="OpenOffice.org 1.1.3  (Linux)">
	<META NAME="CREATED" CONTENT="20040805;23590500">
	<META NAME="CHANGED" CONTENT="20050131;8375900">
</HEAD>
<BODY LANG="en-US" DIR="LTR">
<CENTER>
	<TABLE WIDTH=100% BORDER=0 CELLPADDING=4 CELLSPACING=0 STYLE="page-break-before: always">
		<COL WIDTH=85*>
		<COL WIDTH=85*>
		<COL WIDTH=85*>
		<THEAD>
			<TR VALIGN=TOP>
				<TD WIDTH=33%>
					<P><A HREF="2_1_navigation.html">Previous</A></P>
				</TD>
				<TD WIDTH=33%>
					<P ALIGN=CENTER>Menus &ndash; Main Window</P>
				</TD>
				<TD WIDTH=33%>
					<P ALIGN=RIGHT><A HREF="2_3_layout.html">Next</A></P>
				</TD>
			</TR>
		</THEAD>
	</TABLE>
</CENTER>
<HR>
<H1>2.2 Menus</H1>
<P>This section describes the functions of each item on the menu bar
in the GQview main window.</P>
<P><BR><BR>
</P>
<P><U>File Menu</U></P>
<P STYLE="margin-left: 0.79in"><B>New window</B>: Opens a new main
window, with the initial path set to the current folder.</P>
<P STYLE="margin-left: 0.79in; font-weight: medium"><B>New
collection</B>: Opens a new collection window, the new collection
will be empty.</P>
<P STYLE="margin-left: 0.79in; font-weight: medium"><B>Open
collection</B>: Displays a dialog to open a collection stored on
disk, the selected collection will then appear in a new window.</P>
<P STYLE="margin-left: 0.79in"><B>Open recent</B>: This menu item
lists the recently active collections, selecting an item from the
list will open that collection in a new window. The most recent item
will appear at the top of the list.</P>
<P STYLE="margin-left: 0.79in; font-weight: medium"><B>Search...</B>:
Opens a new Search window.</P>
<P STYLE="margin-left: 0.79in; font-weight: medium"><B>Find
duplicates...</B>: Opens a new Find Duplicates window.</P>
<P STYLE="margin-left: 0.79in; font-weight: medium"><B>Print..</B>:
Opens a print dialog.</P>
<P STYLE="margin-left: 0.79in"><B>New folder...</B>: Creates a new
folder in the current path.</P>
<P STYLE="margin-left: 0.79in; font-weight: medium"><B>Copy...</B>:
Opens a dialog to select a destination to copy the currently selected
files.</P>
<P STYLE="margin-left: 0.79in; font-weight: medium"><B>Move...</B>:
Opens a dialog to select a destination to move currently selected
files.</P>
<P STYLE="margin-left: 0.79in"><B>Rename...</B>: Renames the current
file selection.</P>
<P STYLE="margin-left: 0.79in"><B>Delete...</B>: Deletes the current
file selection.</P>
<P STYLE="margin-left: 0.79in"><B>Close window</B>: Closes the window
containing the menu, if the window is the last main window GQview
will quit.</P>
<P STYLE="margin-left: 0.79in"><B>Quit</B>: Quits the GQview
application, if collections have been changed but not saved, the user
will be prompted for confirmation.</P>
<P><U>Edit menu</U></P>
<P STYLE="margin-left: 0.79in"><B>in &lt;command name&gt;...</B>:
This will execute the external command associated with &lt;command
name&gt;, these can be changed edited on the <A HREF="10_5_editor_commands.html">Editors
tab</A> of the Option dialog.</P>
<P STYLE="margin-left: 0.79in"><B>Adjust</B> sub menu:</P>
<P STYLE="margin-left: 1.58in"><B>Rotate clockwise</B>: Rotates the
current image clockwise 90 degrees, does not effect the file on disk.</P>
<P STYLE="margin-left: 1.58in"><B>Rotate counterclockwise</B>:
Rotates the current image counterclockwise 90 degrees, does not
effect the file on disk.</P>
<P STYLE="margin-left: 1.58in"><B>Rotate 180</B>: Rotates the current
image 180 degrees, does not effect the file on disk.</P>
<P STYLE="margin-left: 1.58in"><B>Mirror</B>: Swaps the left and
right sides of the image so that the result is similar to that of
looking at the image in a mirror, does not effect the file on disk.</P>
<P STYLE="margin-left: 1.58in"><B>Flip</B>: Swaps the top and bottom
sides of the image, does not effect the file on disk.</P>
<P STYLE="margin-left: 0.79in"><B>Properties</B>: Opens a Properties
Window for the currently selected files.</P>
<P STYLE="margin-left: 0.79in"><B>Select all</B>: Selects all files
displayed in the file list.</P>
<P STYLE="margin-left: 0.79in"><B>Select none</B>: Clears the current
file selection.</P>
<P STYLE="margin-left: 0.79in"><B>Preferences...</B>: Opens the
<A HREF="10_options.html">Preferences Dialog</A> for changing of user
preferences.</P>
<P STYLE="margin-left: 0.79in"><B>Thumbnail maintenance</B>: Opens a
dialog with utilities to manage cached thumbnails and keywords data.</P>
<P STYLE="margin-left: 0.79in"><B>Set as wallpaper</B>: Renders the
current image to the root window (desktop). The resulting image will
be tiled to fit the root window if zoom is not set to <U>fit to
window</U>; when zoom is set to <U>fit to window</U>, the image will
be scaled to fill the root window.</P>
<P><U>View menu</U></P>
<P STYLE="margin-left: 0.79in"><B>Zoom in</B>: Increases the zoom by
one increment, resulting in a larger image.</P>
<P STYLE="margin-left: 0.79in"><B>Zoom out</B>: Decreases the zoom by
one increment, resulting in a smaller image.</P>
<P STYLE="margin-left: 0.79in"><B>Zoom 1:1</B>: Resets the zoom to
the original size of the image.</P>
<P STYLE="margin-left: 0.79in"><B>Zoom to fit</B>: Automatically
adjusts the zoom so that the image will fit within the display pane.
The effect on images with an original size smaller than the display
pane can be changed with the <U>Allow enlargement of image for zoom
to fit</U><SPAN STYLE="text-decoration: none"> option located on the
<A HREF="10_2_image.html">Image tab</A> of the preferences dialog</SPAN>.</P>
<P STYLE="margin-left: 0.79in"><B>Thumbnails</B>: Toggles the display
of image thumbnails in the file list, this item is not available when
the file list is in icon view mode. A check appears next to this item
when thumbnails are enabled.</P>
<P STYLE="margin-left: 0.79in"><B>List</B>: Changes the file list to
display files in list format.</P>
<P STYLE="margin-left: 0.79in"><B>Icons</B>: Changes the file list to
display files as icons.</P>
<P STYLE="margin-left: 0.79in"><B>Tree</B>: Toggles the folder list
between simple and tree modes. A check appears next to this item when
the folder is in tree mode.</P>
<P STYLE="margin-left: 0.79in"><B>Full screen</B>: Toggles the full
screen window display.</P>
<P STYLE="margin-left: 0.79in"><B>Float file list</B>: Toggles the
location of the menu bar, tool bar, status bar, and file lists
between the main window and a second window. A check appears next to
this item when the location is the second window.</P>
<P STYLE="margin-left: 0.79in"><B>Hide file list</B>: Toggles
visibility of the menu bar, tool bar, status bar, and file lists.</P>
<P STYLE="margin-left: 0.79in"><B>Hide toolbar</B>: Toggles
visibility of the tool bar. A check appears next to this item when
the tool bar is not visible.</P>
<P STYLE="margin-left: 0.79in"><B>Keywords</B>: Toggles display of
the Keywords sidebar.</P>
<P STYLE="margin-left: 0.79in"><B>Exif data</B>: Toggles display of
the EXIF sidebar.</P>
<P STYLE="margin-left: 0.79in"><B>Sort manager</B>: Toggles display
of the Sort Manager sidebar.</P>
<P STYLE="margin-left: 0.79in"><B>Toggle slideshow</B>: Begins or
ends a slide show, the slide show status is displayed in the status
bar.</P>
<P STYLE="margin-left: 0.79in"><B>Refresh</B>: Updates the contents
of the folder and file lists to match what is currently on disk, the
current image will also be reread from disk.</P>
<P><U>Help menu</U></P>
<P STYLE="margin-left: 0.79in"><B>Contents</B>: Open the GQview user
manual in a new browser window.</P>
<P STYLE="margin-left: 0.79in"><B>Keyboard shortcuts</B>: Displays a
window listing the default keyboard shortcuts.</P>
<P STYLE="margin-left: 0.79in"><B>Release notes</B>: Displays a
window containing the release notes for the version of GQview in use.</P>
<P STYLE="margin-left: 0.79in"><B>About</B>: Opens a window
containing the GQview version, credits, website, and email contact
information.</P>
<P><BR><BR>
</P>
<P><U>Tear off menus</U></P>
<P>Menus can be permanently displayed by selecting the dotted line
item at the top of each menu category. A tear off menu will behave
the same as an ordinary window. To close a tear off menu, select the
dotted line item at the top of the menu.</P>
<P><BR><BR>
</P>
<P><U>Keyboard shortcuts</U></P>
<P>The keyboard sequence associated to each menu entry is listed
within the main window menu bar. For reference, the complete list of
default keyboard shortcuts can be found in section <A HREF="11_2_keyboard_shortcuts.html">11.2
Keyboard Shortcuts</A>.</P>
<P><BR><BR>
</P>
<P><U>Changing the main window menu bar keyboard shortcuts</U></P>
<P STYLE="text-decoration: none">The keyboard shortcuts associated
with the menu bar items can be changed by editing the accels file
located in the GQview configuration folder <B>while the GQview
application is not running</B>:</P>
<P STYLE="margin-left: 0.79in"><CODE><SPAN STYLE="text-decoration: none">($HOME)/.gqview/accels</SPAN></CODE></P>
<P><SPAN STYLE="text-decoration: none">To change a menu item, first
find the line corresponding to the menu item</SPAN> to change. For
example the File menu Quit line originally looks like this:</P>
<P STYLE="margin-left: 0.79in"><CODE><SPAN STYLE="text-decoration: none">;
(gtk_accel_path &quot;&lt;main&gt;/File/Quit&quot; &quot;&lt;Control&gt;q&quot;)</SPAN></CODE></P>
<P STYLE="text-decoration: none">To change this menu's keyboard
shortcut, first remove the leading semicolon (;), removing the
semicolon will tell GQview that this menu item has been customized.
Then change the keyboard shortcut defined by the text in quotes at
the end of the line, be sure to only change the text within the
quotes; in this case the text &ldquo;&lt;control&gt;q&rdquo;. For
example changing the shortcut associated with Quit to the Q key will
result in this line:</P>
<P STYLE="margin-left: 0.79in"><CODE><SPAN STYLE="text-decoration: none">(gtk_accel_path
&quot;&lt;main&gt;/File/Quit&quot; &quot;q&quot;)</SPAN></CODE></P>
<P STYLE="text-decoration: none">Please note the removed semicolon
and the change of &ldquo;&lt;control&gt;q&rdquo; to &ldquo;q&rdquo;,
be careful not to change any of the other text on the line or GQview
may ignore the customization. The keyboard modifiers and their
respective text are listed below:</P>
<DL>
	<DL>
		<DD>
		<TABLE WIDTH=60% BORDER=0 CELLPADDING=4 CELLSPACING=0>
			<COL WIDTH=128*>
			<COL WIDTH=128*>
			<TR VALIGN=TOP>
				<TD WIDTH=50%>
					<P ALIGN=CENTER><B>Key</B></P>
				</TD>
				<TD WIDTH=50%>
					<P ALIGN=CENTER><B>Text to use in accels file</B></P>
				</TD>
			</TR>
			<TR VALIGN=TOP>
				<TD WIDTH=50%>
					<P ALIGN=CENTER>[Shift]</P>
				</TD>
				<TD WIDTH=50%>
					<P ALIGN=CENTER>&lt;shift&gt;</P>
				</TD>
			</TR>
			<TR VALIGN=TOP>
				<TD WIDTH=50%>
					<P ALIGN=CENTER>[Control]</P>
				</TD>
				<TD WIDTH=50%>
					<P ALIGN=CENTER>&lt;control&gt;</P>
				</TD>
			</TR>
			<TR VALIGN=TOP>
				<TD WIDTH=50%>
					<P ALIGN=CENTER>[Alt]</P>
				</TD>
				<TD WIDTH=50%>
					<P ALIGN=CENTER>&lt;alt&gt;</P>
				</TD>
			</TR>
		</TABLE>
	</DL>
</DL>
<P><BR><BR>
</P>
<P>Modifiers can be combined, for example in the exit line above, the
text would be &ldquo;&lt;control&gt;&lt;shift&gt;q&rdquo; to set the
exit shortcut to [Control] + [Shift] + Q.</P>
<P><BR><BR>
</P>
<P><BR><BR>
</P>
<HR>
<CENTER>
	<TABLE WIDTH=100% BORDER=0 CELLPADDING=4 CELLSPACING=0>
		<COL WIDTH=85*>
		<COL WIDTH=85*>
		<COL WIDTH=85*>
		<THEAD>
			<TR VALIGN=TOP>
				<TD WIDTH=33%>
					<P><A HREF="2_1_navigation.html">Previous</A></P>
				</TD>
				<TD WIDTH=33%>
					<P ALIGN=CENTER><A HREF="index.html">Contents</A></P>
				</TD>
				<TD WIDTH=33%>
					<P ALIGN=RIGHT><A HREF="2_3_layout.html">Next</A></P>
				</TD>
			</TR>
		</THEAD>
		<TBODY>
			<TR VALIGN=TOP>
				<TD WIDTH=33%>
					<P><BR>
					</P>
				</TD>
				<TD WIDTH=33%>
					<P ALIGN=CENTER><BR>
					</P>
				</TD>
				<TD WIDTH=33%>
					<P ALIGN=RIGHT>GQview User Manual</P>
				</TD>
			</TR>
		</TBODY>
	</TABLE>
</CENTER>
<P STYLE="margin-bottom: 0in"><BR>
</P>
</BODY>
</HTML>