path: root/gnome2-user-guide/C/gospanel.xml

<chapter id="gospanel-1">
  <title>Working With Panels</title>
  <highlights>
    <para>The information in this chapter describes how to use panels. </para>
  </highlights>
  <sect1 id="gospanel-2">
    <title>Introducing Panels</title>
    <indexterm>
      <primary>panels</primary>
      <secondary>introduction</secondary>
    </indexterm>
    <para>A panel is an area in your desktop environment from which you can run
applications and applets, and perform other tasks. When you start a session
for the first time, the desktop environment contains at least one panel. Your
system administrator might have set your default panels according to your
local requirements, so you might see slightly different default panels.</para>
    <para>You can change the behavior and appearance of your panels to suit your
requirements. You can also add or remove objects from your panels. You can
create multiple panels, and choose different properties, objects, and backgrounds
for each panel. You can also hide panels.</para>
    <para>Typically, the GNOME Desktop contains a panel at the top edge of the
screen, and a panel at the bottom edge of the screen. The following sections
describe these panels.</para>
    <sect2 id="gospanel-6">
      <title>Top Edge Panel</title>
      <para><indexterm><primary>panels</primary><secondary>top edge panel</secondary><see>top edge panel</see></indexterm><indexterm><primary>top edge panel</primary><secondary>introduction</secondary></indexterm><xref linkend="gospanel-FIG-60"/>
shows the panel at the top edge of the screen. Your system administrator might
have set your default top edge panel according to your local requirements,
so you might see a slightly different top edge panel. </para>
      <figure id="gospanel-FIG-60">
        <title>Typical Top Edge Panel</title>
        <screenshot>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/menu_panel.png" format="PNG"/>
            </imageobject>
            <textobject>
              <phrase>Typical top edge panel. The context describes the graphic.</phrase>
            </textobject>
          </mediaobject>
        </screenshot>
      </figure>
      <para>The typical top edge panel contains the following objects: <indexterm><primary>top edge panel</primary><secondary>default contents</secondary></indexterm></para>
      <informaltable frame="topbot">
        <tgroup cols="2" colsep="0" rowsep="0">
          <colspec colname="colspec3" colwidth="30.95*"/>
          <colspec colname="colspec4" colwidth="69.05*"/>
          <thead>
            <row rowsep="1">
              <entry valign="top">
                <para>Object</para>
              </entry>
              <entry valign="top">
                <para>Description </para>
              </entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry colname="colspec3">
                <para><application>Menu Bar</application> applet</para>
              </entry>
              <entry colname="colspec4">
                <para>Contains the <guimenu>Applications</guimenu> and the <guimenu>Actions</guimenu> menu. The <guimenu>Applications</guimenu> menu contains the standard GNOME applications. The <guimenu>Actions</guimenu> menu provides commands that enable you to perform desktop environment
tasks.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec3">
                <para>Home folder launcher</para>
              </entry>
              <entry colname="colspec4">
                <para>Click on this launcher to open your home folder in
a <application>Nautilus</application> file manager window. </para>
              </entry>
            </row>
            <row>
              <entry colname="colspec3">
                <para><application>Terminal</application> launcher</para>
              </entry>
              <entry colname="colspec4">
                <para>Click on this launcher to start
the <application>Terminal</application> application. <application>Terminal</application> provides access to a UNIX command line.</para>
              </entry>
            </row>
            <row>
              <entry valign="top">
                <para><application>Clock</application> applet</para>
              </entry>
              <entry valign="top">
                <para><application>Clock</application> shows the current
time. Click on the time readout to display a menu of clock commands.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec3">
                <para><application>Volume Control</application>
applet</para>
              </entry>
              <entry colname="colspec4">
                <para><application>Volume Control</application> enables you to control the volume of the speaker on your system.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec3" valign="top">
                <indexterm>
                  <primary>top edge panel</primary>
                  <secondary>window list icon</secondary>
                </indexterm>
                <para>Window
list icon</para>
              </entry>
              <entry colname="colspec4" valign="top">
                <para>The window
list is a list of all your open windows. To give focus to a window, click
on the icon at the extreme right of the top edge panel, then choose the window.</para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </informaltable>
    </sect2>
    <sect2 id="gospanel-3">
      <title>Bottom Edge Panel</title>
      <indexterm>
        <primary>panels</primary>
        <secondary>bottom edge panel</secondary>
        <see>bottom edge panel</see>
      </indexterm>
      <indexterm>
        <primary>bottom edge panel</primary>
        <secondary>introduction</secondary>
      </indexterm>
      <para><xref linkend="gospanel-FIG-58"/>
shows a typical bottom edge panel. Your system administrator might have set
your default bottom edge panel according to your local requirements, so you
might see a slightly different bottom edge panel. </para>
      <figure id="gospanel-FIG-58">
        <title>Typical Bottom Edge Panel</title>
        <screenshot>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/gnome_panel.png" format="PNG"/>
            </imageobject>
            <textobject>
              <phrase>Typical bottom edge panel. The context describes the graphic.</phrase>
            </textobject>
          </mediaobject>
        </screenshot>
      </figure>
      <indexterm>
        <primary>bottom edge panel</primary>
        <secondary>default contents</secondary>
      </indexterm>
      <para>The bottom edge panel contains the following
items:</para>
      <itemizedlist>
        <listitem>
          <para><guibutton>Show Desktop</guibutton> button: Click on this
button to minimize all open windows and show the desktop.</para>
        </listitem>
        <listitem>
          <para><application>Window List</application> applet: Displays a
button for each window that is open. <application>Window List</application>
enables you to minimize and restore windows.</para>
        </listitem>
        <listitem>
          <para><application>Workspace Switcher</application> applet: Enables
you to navigate between your workspaces.</para>
        </listitem>
      </itemizedlist>
    </sect2>
  </sect1>
  <sect1 id="gospanel-5">
    <title>Managing Your Panels</title>
    <indexterm>
      <primary>panels</primary>
      <secondary>managing</secondary>
    </indexterm>
    <para>The following sections describe how to manage your panels.</para>
    <sect2 id="gospanel-10">
      <title>To Add a New Panel</title>
      <indexterm>
        <primary>panels</primary>
        <secondary>adding new</secondary>
      </indexterm>
      <para>To add a panel, right-click on a vacant space on any panel, then choose <guimenuitem>New Panel</guimenuitem>. The new panel is added to your desktop environment.
The new panel contains no objects. You can customize the new panel to suit
your preferences.</para>
    </sect2>
    <sect2 id="gospanel-11">
      <title>To Interact With a Panel</title>
      <indexterm>
        <primary>panels</primary>
        <secondary>interacting with</secondary>
      </indexterm>
      <para>To interact with a panel, you must left-click, middle-click,
or right-click on a vacant space on the panel. You can also middle-click or
right-click on one of the hide buttons to select the panel, if the panel has
no vacant space. If the hide buttons are not visible on a panel, modify the
properties of the panel so that the hide buttons are visible. </para>
      <para>You use the mouse buttons to interact with a panel in the following
ways:</para>
      <variablelist>
        <varlistentry>
          <term>Middle-click</term>
          <listitem>
            <para>Enables you to grab
a panel, then drag the panel to a new location.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Right-click</term>
          <listitem>
            <para>Opens the panel popup
menu.</para>
          </listitem>
        </varlistentry>
      </variablelist>
    </sect2>
    <sect2 id="gospanel-12">
      <title>To Move a Panel</title>
      <indexterm>
        <primary>panels</primary>
        <secondary>moving</secondary>
      </indexterm>
      <para>You can move panels to different locations. To move a panel, middle-click
and hold on any vacant space on the panel, then drag the panel to the new
location.</para>
    </sect2>
    <sect2 id="gospanel-7">
      <title>To Hide a Panel</title>
      <indexterm>
        <primary>panels</primary>
        <secondary>hiding</secondary>
      </indexterm>
      <para>You can hide or show panels. To hide a panel, use a hide button. If
the hide buttons are not visible on a panel, modify the panel properties so
that the hide buttons are visible. </para>
      <para>Hide buttons are at either end of a panel. The hide buttons contain
an optional arrow icon. The following illustration shows hide buttons. </para>
      <screenshot>
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/four_hide_button.png" format="PNG"/>
          </imageobject>
          <textobject>
            <phrase>A horizontal panel and a vertical panel, both with hide buttons.</phrase>
          </textobject>
        </mediaobject>
      </screenshot>
      <para>To hide a panel, click on one of the hide buttons. The panel reduces
in the direction of the arrow on the hide button. The hide button at the other
end of the panel remains visible.</para>
      <para>To show a hidden panel again, click on the visible hide button. The
panel expands in the direction of the arrow on the hide button. Both hide
buttons are now visible.</para>
      <para>You can set a panel to autohide. When you set autohide, the panel hides
automatically when the mouse is not pointing to the panel. The panel reappears
when you point to the part of the screen where the panel resides. To set your
panel to autohide, modify the properties of the panel.</para>
    </sect2>
    <sect2 id="gospanel-28">
      <title>To Modify Panel Properties</title>
      <indexterm>
        <primary>panels</primary>
        <secondary>modifying properties</secondary>
      </indexterm>
      <para>To modify preferences for all panels, use the <guilabel>Panel</guilabel> preference tool to make the changes that you require. For
example, you can specify various settings related to the appearance and behavior
of panel objects. </para>
      <para>You can also modify properties for each individual panel. You can change
the features for each panel, such as the type of the panel, the hide behavior,
and the visual appearance. </para>
      <para>To modify the properties of a panel perform the following steps: </para>
      <orderedlist>
        <listitem>
          <para>Right-click on a vacant space on the panel, then choose <guimenuitem>Properties</guimenuitem> to display the <guilabel>Panel Properties</guilabel>
dialog. The <guilabel>Panel Properties</guilabel> dialog contains the following
tabbed sections: </para>
          <itemizedlist>
            <listitem>
              <para>
                <guilabel>General</guilabel>
              </para>
            </listitem>
            <listitem>
              <para>
                <guilabel>Background</guilabel>
              </para>
            </listitem>
          </itemizedlist>
        </listitem>
        <listitem>
          <para>To modify panel size, position, and hiding properties, click
on the <guilabel>General</guilabel> tab. The following table describes the
dialog elements on the <guilabel>General</guilabel> tabbed section: </para>
          <informaltable frame="topbot">
            <tgroup cols="2" colsep="0" rowsep="0">
              <colspec colname="colspec0" colwidth="28.57*"/>
              <colspec colname="colspec1" colwidth="71.43*"/>
              <thead>
                <row rowsep="1">
                  <entry valign="top">
                    <para>Dialog Element</para>
                  </entry>
                  <entry valign="top">
                    <para>Description </para>
                  </entry>
                </row>
              </thead>
              <tbody>
                <row>
                  <entry colname="colspec0">
                    <para>
                      <guilabel>Name</guilabel>
                    </para>
                  </entry>
                  <entry colname="colspec1">
                    <para>Type a name for the panel. When you use shortcut
keys to switch between your panels and the desktop, this panel name is displayed.</para>
                  </entry>
                </row>
                <row>
                  <entry colname="colspec0">
                    <para>
                      <guilabel>Orientation</guilabel>
                    </para>
                  </entry>
                  <entry colname="colspec1">
                    <para>Select the position of the panel on your screen.
Click on the required position for the panel. </para>
                  </entry>
                </row>
                <row>
                  <entry valign="top">
                    <para>
                      <guilabel>Size</guilabel>
                    </para>
                  </entry>
                  <entry valign="top">
                    <para>Use the spin box to specify the size of the panel.</para>
                  </entry>
                </row>
                <row>
                  <entry colname="colspec0">
                    <para>
                      <guilabel>Expand</guilabel>
                    </para>
                  </entry>
                  <entry colname="colspec1">
                    <para>Select this option if you want the panel to
expand to the full length of the edge of the screen where the panel is located.</para>
                  </entry>
                </row>
                <row>
                  <entry valign="top">
                    <para>
                      <guilabel>Autohide</guilabel>
                    </para>
                  </entry>
                  <entry valign="top">
                    <para>Select this option to enable autohide. </para>
                  </entry>
                </row>
                <row>
                  <entry valign="top">
                    <para>
                      <guilabel>Show hide buttons</guilabel>
                    </para>
                  </entry>
                  <entry valign="top">
                    <para>Select this option to display hide buttons on your
panel.</para>
                  </entry>
                </row>
                <row>
                  <entry valign="top">
                    <para>
                      <guilabel>Arrows on hide button</guilabel>
                    </para>
                  </entry>
                  <entry valign="top">
                    <para>Select this option to display arrows on the hide
buttons, if the hide button is enabled.</para>
                  </entry>
                </row>
              </tbody>
            </tgroup>
          </informaltable>
        </listitem>
        <listitem>
          <para>To modify the panel background, click on the <guilabel>Background</guilabel> tab. The <guilabel>Background</guilabel> tabbed section contains
the following elements: </para>
          <para>Choose the type of background for the panel. The choices are as follows:</para>
          <informaltable frame="topbot">
            <tgroup cols="2" colsep="0" rowsep="0">
              <colspec colwidth="32.32*"/>
              <colspec colwidth="67.68*"/>
              <thead>
                <row rowsep="1">
                  <entry>
                    <para>Dialog Element</para>
                  </entry>
                  <entry>
                    <para>Description</para>
                  </entry>
                </row>
              </thead>
              <tbody>
                <row>
                  <entry>
                    <para>
                      <guilabel>None (use system theme)</guilabel>
                    </para>
                  </entry>
                  <entry>
                    <para>Select this option to use the default panel background. The default
panel background depends on the settings in the <application>Theme</application>
preference tool.</para>
                  </entry>
                </row>
                <row>
                  <entry>
                    <para>
                      <guilabel>Solid color</guilabel>
                    </para>
                  </entry>
                  <entry>
                    <para>Select this option to specify a single color for the panel background. Click
on the <guibutton>Color</guibutton> button to display the color selector dialog.
Choose the color that you require from the color selector dialog. </para>
                    <para>Use the <guilabel>Style</guilabel> slider to specify the degree of transparency
or opaqueness for the color. For example, to make the panel transparent, move
the slider towards the <guilabel>Transparent</guilabel> end.</para>
                  </entry>
                </row>
                <row>
                  <entry>
                    <para>
                      <guilabel>Background image</guilabel>
                    </para>
                  </entry>
                  <entry>
                    <para>Select this option to specify an image for the panel background. Enter the
filename of the image to use in the drop-down combination box. Alternatively,
to                       browse for the file, click on the <guibutton>Browse</guibutton> button. When you have selected the file, click OK. </para>
                  </entry>
                </row>
              </tbody>
            </tgroup>
          </informaltable>
          <para>You can also drag a color or image on to a panel to set the color or
image as the background of the panel. For more information, see <xref linkend="gospanel-61"/>.</para>
        </listitem>
        <listitem>
          <para>Click <guibutton>Close</guibutton> to close the <guilabel>Panel Properties</guilabel> dialog.</para>
        </listitem>
      </orderedlist>
      <sect3 id="gospanel-61">
        <title>To Drag a Color or Image to the Background of a Panel</title>
        <indexterm>
          <primary>panels</primary>
          <secondary>changing background</secondary>
        </indexterm>
        <para>You can drag a color or image on to a panel to set the color
or image as the background of the panel. You can drag a color or image from
many applications. For example, you can drag a color from the <application>Nautilus</application> file manager to a panel to set the color as the background
of the panel. You can also drag a color from any color selector dialog.</para>
        <para>You can drag an image to a panel to set the image as the background
of the panel. You can also drag pattern images from the file manager to set
the background of the panel.</para>
      </sect3>
    </sect2>
    <sect2 id="gospanel-31">
      <title>To Delete a Panel</title>
      <indexterm>
        <primary>panels</primary>
        <secondary>deleting</secondary>
      </indexterm>
      <para>To delete a panel from your desktop environment, right-click on the
panel that you want to delete, then choose <menuchoice><guimenuitem>Delete
This Panel</guimenuitem></menuchoice>.</para>
      <note>
        <para>You must always have at least one panel in your desktop environment.
If you have only one panel in your desktop environment, you cannot delete
that panel.</para>
      </note>
    </sect2>
  </sect1>
  <sect1 id="gospanel-8">
    <title>Panel Objects</title>
    <indexterm>
      <primary>panels</primary>
      <secondary>panel objects</secondary>
      <see>panel objects</see>
    </indexterm>
    <para>This section describes the objects that
you can add to your panels, and use from your panels.</para>
    <sect2 id="gospanel-100">
      <title>Interacting With Panel Objects</title>
      <indexterm>
        <primary>panel objects</primary>
        <secondary>interacting with</secondary>
      </indexterm>
      <para>You use the mouse buttons to interact with a panel object
in the following ways:</para>
      <variablelist>
        <varlistentry>
          <term>Left-click</term>
          <listitem>
            <para>Launches the panel object.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Middle-click</term>
          <listitem>
            <para>Enables you to grab
an object, then drag the object to a new location.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Right-click</term>
          <listitem>
            <para>Opens the panel object
popup menu.</para>
          </listitem>
        </varlistentry>
      </variablelist>
      <para>You interact with applet panel objects in a different
way. For more information, see <xref linkend="gospanel-39"/>.</para>
    </sect2>
    <sect2 id="gospanel-15">
      <title>To Add an Object to a Panel</title>
      <indexterm>
        <primary>panel objects</primary>
        <secondary>adding</secondary>
      </indexterm>
      <para>You can add an object to a panel in several ways, as follows: </para>
      <itemizedlist>
        <listitem>
          <para>From the panel popup menu</para>
          <para>Right-click on a vacant space on a panel to open the panel popup menu.
The panel popup menu contains an <guisubmenu>Add to Panel</guisubmenu> submenu.
The <guisubmenu>Add to Panel</guisubmenu> submenu enables you to add the following
objects to your panels: <itemizedlist><listitem><para>Applets in the following categories: <guilabel>Accessory</guilabel>, <guilabel>Amusement</guilabel>, <guilabel>Internet</guilabel>, <guilabel>Multimedia</guilabel>, <guilabel>Utility</guilabel>.</para></listitem><listitem><para>Buttons for quick access to common actions: <guibutton>Force
Quit</guibutton> button, <guibutton>Lock</guibutton> button, <guibutton>Log
Out</guibutton> button, <guibutton>Run</guibutton> button, <guibutton>Screenshot</guibutton> button, <guibutton>Search</guibutton> button, <guibutton>Show
Desktop</guibutton> button.</para></listitem><listitem><para>Launchers</para></listitem><listitem><para>Launchers from menus</para></listitem><listitem><para><guimenu>Main Menu</guimenu></para></listitem><listitem><para><application>Menu Bar</application></para></listitem><listitem><para>Drawers</para></listitem></itemizedlist></para>
        </listitem>
        <listitem>
          <para>From any menu</para>
          <para>When you right-click on a launcher in any menu, a popup menu for the
launcher opens. You can use this popup menu to add the launcher to a panel. </para>
          <para>You can also drag menus, launchers, and applets from menus to panels. </para>
        </listitem>
        <listitem>
          <para>From the file manager</para>
          <para>Each launcher corresponds to a <filename>.desktop</filename> file. You
can drag the <filename>.desktop</filename> file on to your panels to add the
launcher to the panel. </para>
<!--Each menu corresponds to a directory. You can drag the directory on to your panels to add the directory to the panel as a menu object. Is this still true?-->
        </listitem>
      </itemizedlist>
    </sect2>
    <sect2 id="gospanel-9">
      <title>To Modify the Properties of an Object</title>
      <indexterm>
        <primary>panel objects</primary>
        <secondary>modifying properties</secondary>
      </indexterm>
      <para>Some panel objects, such as launchers and drawers,
have a set of associated properties. The properties are different for each
type of object. The properties specify details such as the following: <itemizedlist><listitem><para>The command that starts a launcher application.</para></listitem><listitem><para>The location of the source files for a menu.</para></listitem><listitem><para>The icon that represents the object.</para></listitem></itemizedlist></para>
      <para>To modify the properties of an object perform the following steps: </para>
      <orderedlist>
        <listitem>
          <indexterm>
            <primary>panel object popup menu, illustration</primary>
          </indexterm>
          <para>Right-click on the object to open the panel object popup
menu, as shown in <xref linkend="gospanel-FIG-54"/>.</para>
          <figure id="gospanel-FIG-54">
            <title>Panel Object Popup Menu</title>
            <screenshot>
              <mediaobject>
                <imageobject>
                  <imagedata fileref="figures/panel_object_popup_menu.png" format="PNG"/>
                </imageobject>
                <textobject>
                  <phrase>Panel object popup menu. Menu items: Properties, Remove From Panel, Lock, Move.</phrase>
                </textobject>
              </mediaobject>
            </screenshot>
          </figure>
        </listitem>
        <listitem>
          <para>Choose <guimenuitem>Properties</guimenuitem>. Use the <guilabel>Properties</guilabel> dialog to modify the properties as required. The properties
in the <guilabel>Properties</guilabel> dialog depend on which object you select
in step 1. </para>
        </listitem>
        <listitem>
          <para>Click <guibutton>OK</guibutton> to apply the changes, then
close the <guilabel>Properties</guilabel> dialog.</para>
        </listitem>
      </orderedlist>
    </sect2>
    <sect2 id="gospanel-32">
      <title>To Move a Panel Object</title>
      <indexterm>
        <primary>panel objects</primary>
        <secondary>moving</secondary>
      </indexterm>
      <para>You can move panel objects within a panel, and from one panel to another
panel. You can also move objects between panels and drawers.</para>
      <para>To move a panel object, middle-click and hold on the object and drag
the object to a new location. When you release the middle mouse button, the
object anchors at the new location.</para>
      <para>Alternatively, you can use the panel object popup menu to move an object,
as follows: </para>
      <orderedlist>
        <listitem>
          <para>Right-click on the object, then choose <guimenuitem>Move</guimenuitem>.</para>
        </listitem>
        <listitem>
          <para>Point to the new location for the object, then click any mouse
button to anchor the object to the new location. This location can be on any
panel that is currently in your desktop environment. </para>
        </listitem>
      </orderedlist>
      <para>Movement of a panel object affects the position of other objects on
the panel. To control how objects move on a panel, you can specify a movement
mode. To specify the movement mode, press one of the following keys as you
move the panel object:</para>
      <informaltable frame="topbot">
        <tgroup cols="3" colsep="0" rowsep="0">
          <colspec colname="colspec2" colwidth="15.00*"/>
          <colspec colname="colspec1" colwidth="30.00*"/>
          <colspec colname="colspec3" colwidth="54.00*"/>
          <thead>
            <row rowsep="1">
              <entry colname="colspec2" valign="top">
                <para>Key</para>
              </entry>
              <entry valign="top">
                <para>Movement Mode</para>
              </entry>
              <entry colname="colspec3" valign="top">
                <para>Description</para>
              </entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry colname="colspec2" valign="top">
                <para>No key</para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Switched movement</para>
              </entry>
              <entry colname="colspec3" valign="top">
                <para>The object swaps places with other panel
objects. Switched movement is the default movement mode.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec2" valign="top">
                <para><keycap>Alt</keycap> key</para>
              </entry>
              <entry valign="top">
                <para>Free movement</para>
              </entry>
              <entry colname="colspec3" valign="top">
                <para>The object jumps over other panel objects
into the next vacant space on the panel.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec2" valign="top">
                <para><keycap>Shift</keycap> key </para>
              </entry>
              <entry valign="top">
                <para>Push movement</para>
              </entry>
              <entry colname="colspec3" valign="top">
                <para>The object pushes other panel objects
further along the panel. </para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </informaltable>
    </sect2>
    <sect2 id="gospanel-566">
      <title>To Lock a Panel Object</title>
      <indexterm>
        <primary>panel objects</primary>
        <secondary>locking</secondary>
      </indexterm>
      <indexterm>
        <primary>locking panel objects</primary>
      </indexterm>
      <para>You can lock panel objects so that the objects stay in the same position
on the panel. This feature is useful if you do not want some panel objects
to change position when you move other panel objects.</para>
      <para>To lock an object to the current location of the object in the panel,
right-click on the object to open the panel object popup menu, then choose <guimenuitem>Lock</guimenuitem>. To unlock the object, right-click on the object, then
choose <guimenuitem>Unlock</guimenuitem>. </para>
    </sect2>
    <sect2 id="gospanel-33">
      <title>To Remove a Panel Object</title>
      <indexterm>
        <primary>panel objects</primary>
        <secondary>removing</secondary>
      </indexterm>
      <para>To remove an object from a panel right-click on the object
to open the panel object popup menu, then choose <guimenuitem>Remove From
Panel</guimenuitem>. </para>
    </sect2>
  </sect1>
  <sect1 id="gospanel-17">
    <title>Applets</title>
    <indexterm>
      <primary>applets</primary>
      <secondary>introduction</secondary>
    </indexterm>
    <indexterm>
      <primary>panel objects</primary>
      <secondary>applets</secondary>
      <see>applets</see>
    </indexterm>
    <para>An applet is a small application whose
user interface resides within a panel. You use the applet panel object to
interact with the applet. For example, the following figure shows the following
applets, from left to right: </para>
    <itemizedlist>
      <listitem>
        <para><application>Window List</application>: Displays the windows
currently open on your system.</para>
      </listitem>
      <listitem>
        <para><application>CD Player</application>: Enables you to control
the compact disc player on your system.</para>
      </listitem>
      <listitem>
        <para><application>Volume Control</application>: Enables you to
control the volume of the speaker on your system.</para>
      </listitem>
    </itemizedlist>
    <screenshot>
      <mediaobject>
        <imageobject>
          <imagedata fileref="figures/sample_applet.png" format="PNG"/>
        </imageobject>
        <textobject>
          <phrase>Sample applets. The context describes the graphic.</phrase>
        </textobject>
      </mediaobject>
    </screenshot>
    <sect2 id="gospanel-40">
      <title>To Add an Applet to a Panel</title>
      <indexterm>
        <primary>applets</primary>
        <secondary>adding to panel</secondary>
      </indexterm>
      <para>You can add an applet to a panel from the panel popup menu.
Right-click on any vacant space on the panel to open the panel popup menu.
Choose <guimenu>Add to Panel</guimenu>, then choose the applet that you want
to add from one of the following submenus:</para>
      <itemizedlist>
        <listitem>
          <para>
            <guimenu>Accessories</guimenu>
          </para>
        </listitem>
        <listitem>
          <para>
            <guimenu>Amusements</guimenu>
          </para>
        </listitem>
        <listitem>
          <para>
            <guimenu>Internet</guimenu>
          </para>
        </listitem>
        <listitem>
          <para>
            <guimenu>Multimedia</guimenu>
          </para>
        </listitem>
        <listitem>
          <para>
            <guimenu>Utility</guimenu>
          </para>
        </listitem>
      </itemizedlist>
      <para>Alternatively, drag the applet from the submenu on to the panel. </para>
    </sect2>
    <sect2 id="gospanel-39">
      <title>To Select an Applet</title>
      <indexterm>
        <primary>applets</primary>
        <secondary>selecting</secondary>
      </indexterm>
      <para>To modify the properties of an applet, you must first right-click on
the applet to display the panel object popup menu. To move an applet, you
must middle-click on the applet. </para>
      <para>Some restrictions apply on where you can click on an applet in order
to display the panel object popup menu, or to move the applet, as follows: </para>
      <itemizedlist>
        <listitem>
          <para>Some applets have popup menus of applet-specific commands
that open when you right-click on particular parts of the applet. For example,
the <application>Window List</application> applet has a vertical handle on
the left side, and buttons that represent your windows on the right side.
To open the panel object popup menu for the <application>Window List</application>
applet, you must right-click on the handle. If you right-click on a button
on the right side, a popup menu for the button opens.</para>
        </listitem>
        <listitem>
          <para>Some applets have areas that you cannot use to select the
applet. For example, the <application>Command Line</application> applet has
a field in which you enter commands. You cannot middle-click or right-click
on this field to select the applet. Instead, middle-click or right-click on
another part of the applet. </para>
        </listitem>
      </itemizedlist>
    </sect2>
    <sect2 id="gospanel-41">
      <title>To Modify Preferences for an Applet</title>
      <indexterm>
        <primary>applets</primary>
        <secondary>modifying preferences</secondary>
      </indexterm>
      <para>To modify the preferences for an applet perform the following
steps: </para>
      <orderedlist>
        <listitem>
          <para>Right-click on the applet, then choose <guimenuitem>Preferences</guimenuitem>. Use the <guilabel>Preferences</guilabel> dialog to modify
the preferences as required. The preferences for applets vary depending on
the applet.</para>
        </listitem>
        <listitem>
          <para>Click <guibutton>Close</guibutton> to close the <guilabel>Preferences</guilabel> dialog.</para>
        </listitem>
      </orderedlist>
    </sect2>
  </sect1>
  <sect1 id="gospanel-16">
    <title>Launchers</title>
    <indexterm>
      <primary>panel objects</primary>
      <secondary>launchers</secondary>
      <see>launchers</see>
    </indexterm>
    <para>When you click on a launcher, you initiate
one of the following actions: </para>
    <itemizedlist>
      <listitem>
        <para>Start a particular application.</para>
      </listitem>
      <listitem>
        <para>Execute a command.</para>
      </listitem>
      <listitem>
        <para>Open a folder in a file manager window.</para>
      </listitem>
      <listitem>
        <para>Open a browser at a particular <firstterm>Uniform Resource
Locator</firstterm> (URL). A URL is the address of a particular location on
the Web.</para>
      </listitem>
      <listitem>
        <para>Open special <firstterm>Uniform Resource Identifiers</firstterm>
(URIs). The GNOME Desktop contains special URIs that enable you to access
particular functions from the file manager. <indexterm><primary>special URI
locations</primary><secondary>and launchers</secondary></indexterm></para>
      </listitem>
    </itemizedlist>
    <para>You can find launchers in the following places in the desktop environment:</para>
    <itemizedlist>
      <listitem>
        <para>Panels: On panels, launchers are represented by icons.</para>
      </listitem>
      <listitem>
        <para>Menus: On menus, launchers are represented by menu items.
The menu items usually have an icon beside the menu item.</para>
      </listitem>
      <listitem>
        <para>Desktop: On the desktop, launchers are represented by icons.</para>
      </listitem>
    </itemizedlist>
    <para>You can modify the properties of a launcher. For example, the properties
of a launcher include the name of the launcher, the icon that represents the
launcher, and how the launcher runs. </para>
    <sect2 id="gospanel-34">
      <title>To Add a Launcher to a Panel</title>
      <indexterm>
        <primary>launchers</primary>
        <secondary>adding to panel</secondary>
      </indexterm>
      <para>You can add a launcher to a panel in one of the following
ways:</para>
      <itemizedlist>
        <listitem>
          <para>From the panel popup menu</para>
          <para>To create a new launcher, right-click on any vacant space on the panel,
then choose <menuchoice><guimenu>Add to Panel</guimenu><guimenuitem>Launcher</guimenuitem></menuchoice>. A <guilabel>Create Launcher</guilabel>
dialog is displayed. For more information on how to complete this dialog,
see <xref linkend="gospanel-52"/>.</para>
          <para>Alternatively, to add an existing launcher to the panel, choose <menuchoice><guimenu>Add to Panel</guimenu><guimenuitem>Launcher from menu</guimenuitem></menuchoice> from the panel popup menu. Choose the launcher that you want
to add from the menu.</para>
        </listitem>
        <listitem>
          <para>From any menu</para>
          <para>To add a launcher to a panel from any menu, perform one of the following
steps:<itemizedlist><listitem><para>Open a menu that contains the launcher. Drag the launcher
on to the panel. </para></listitem><listitem><para>Open the menu that contains the launcher from the panel where
you want the launcher to reside. Right-click on the title of the launcher.
Choose <guimenuitem>Add this launcher to panel</guimenuitem>. </para></listitem></itemizedlist></para>
        </listitem>
        <listitem>
          <para>From the file manager</para>
          <para>To add a launcher to a panel from the file manager, find the <filename>.desktop</filename> file for the launcher in your file system. To add the
launcher drag the <filename>.desktop</filename> file to the panel. </para>
        </listitem>
      </itemizedlist>
      <sect3 id="gospanel-52">
        <title>To Create a Launcher With the Create Launcher Dialog</title>
        <para>To create a launcher with the <guilabel>Create Launcher</guilabel> dialog
perform the following steps: </para>
        <orderedlist>
          <listitem>
            <para>Right-click on any part of a panel to open the panel popup
menu. Choose <menuchoice><guimenu>Add to Panel</guimenu><guimenuitem>Launcher</guimenuitem></menuchoice> to display the <guilabel>Create Launcher</guilabel> dialog. The dialog displays the <guilabel>Basic</guilabel> tabbed
section.</para>
          </listitem>
          <listitem>
            <para>Enter the properties of the launcher in the dialog. The following
table describes the dialog elements on the <guilabel>Basic</guilabel> tabbed
section: </para>
            <informaltable frame="topbot">
              <tgroup cols="2" colsep="0" rowsep="0">
                <colspec colname="colspec0" colwidth="26.19*"/>
                <colspec colname="colspec1" colwidth="73.81*"/>
                <thead>
                  <row rowsep="1">
                    <entry valign="top">
                      <para>Dialog Element</para>
                    </entry>
                    <entry valign="top">
                      <para>Description </para>
                    </entry>
                  </row>
                </thead>
                <tbody>
                  <row>
                    <entry valign="top">
                      <para>
                        <guilabel>Name</guilabel>
                      </para>
                    </entry>
                    <entry valign="top">
                      <para>Use this text box to specify the name of the launcher.
You can use the <guilabel>Advanced</guilabel> tab to add translations of the
name. This name is the name that appears when you add the launcher to a menu
or to the desktop. </para>
                    </entry>
                  </row>
                  <row>
                    <entry colname="colspec0">
                      <para>
                        <guilabel>Generic name</guilabel>
                      </para>
                    </entry>
                    <entry colname="colspec1">
                      <para>Use this text box to specify the class of
application to which the launcher belongs. For example, you might type <userinput>Text Editor</userinput> in this text box for a <application>gedit</application>
launcher. You can use the <guilabel>Advanced</guilabel> tab to add translations
of the generic name.</para>
                    </entry>
                  </row>
                  <row>
                    <entry valign="top">
                      <para>
                        <guilabel>Comment</guilabel>
                      </para>
                    </entry>
                    <entry valign="top">
                      <para>Use this text box to specify a short description
of the launcher. The comment is displayed as a tooltip when you point to the
launcher icon on the panel. You can use the <guilabel>Advanced</guilabel>
tabbed section to add translations of the comment. </para>
                    </entry>
                  </row>
                  <row>
                    <entry valign="top">
                      <para>
                        <guilabel>Command</guilabel>
                      </para>
                    </entry>
                    <entry valign="top">
                      <para>Use this field to specify a command to execute when
you click on the launcher. For sample commands, see the next section.</para>
                    </entry>
                  </row>
                  <row>
                    <entry valign="top">
                      <para>
                        <guilabel>Type</guilabel>
                      </para>
                    </entry>
                    <entry valign="top">
                      <para>Use this drop-down combination box to specify the type
of launcher. Select from the following: </para>
                      <itemizedlist>
                        <listitem>
                          <para><guilabel>Application</guilabel>: Select this option to create
a launcher that starts an application.</para>
                        </listitem>
                        <listitem>
                          <para><guilabel>Link</guilabel>:  Select this option to create a
launcher that links to a URI.</para>
                        </listitem>
                      </itemizedlist>
                    </entry>
                  </row>
                  <row>
                    <entry valign="top">
                      <para>
                        <guilabel>Icon</guilabel>
                      </para>
                    </entry>
                    <entry valign="top">
                      <para>Choose an icon to represent the launcher. To choose an
icon, click on the <guibutton>No Icon</guibutton> button. An icon selector
dialog is displayed. Choose an icon from the dialog. Alternatively, to choose
an icon from another directory, click <guibutton>Browse</guibutton>. When
you choose an icon, click <guibutton>OK</guibutton>. </para>
                    </entry>
                  </row>
                  <row>
                    <entry valign="top">
                      <para>
                        <guilabel>Run in Terminal</guilabel>
                      </para>
                    </entry>
                    <entry valign="top">
                      <para>Select this option to run the application or command
in a terminal window. Choose this option for an application or command that
does not create a window in which to run.</para>
                    </entry>
                  </row>
                </tbody>
              </tgroup>
            </informaltable>
          </listitem>
          <listitem>
            <para>To set advanced properties for the launcher, click on the <guilabel>Advanced</guilabel> tab. The <guilabel>Launcher Properties</guilabel> dialog
displays the <guilabel>Advanced</guilabel> tabbed section.</para>
          </listitem>
          <listitem>
            <para>Enter the advanced properties of the launcher in the dialog.
The following table describes the dialog elements on the top part of the <guilabel>Advanced</guilabel> tabbed section: </para>
            <informaltable frame="topbot">
              <tgroup cols="2" colsep="0" rowsep="0">
                <colspec colwidth="32.03*"/>
                <colspec colwidth="67.97*"/>
                <thead>
                  <row rowsep="1">
                    <entry valign="top">
                      <para>Dialog Element</para>
                    </entry>
                    <entry valign="top">
                      <para>Description </para>
                    </entry>
                  </row>
                </thead>
                <tbody>
                  <row>
                    <entry valign="top">
                      <para>
                        <guilabel>Try this before using</guilabel>
                      </para>
                    </entry>
                    <entry valign="top">
                      <para>Enter a command here to check before starting the
launcher. If the command is executable and is in your path, the launcher appears
on the panel.</para>
                    </entry>
                  </row>
                  <row>
                    <entry valign="top">
                      <para>
                        <guilabel>Documentation</guilabel>
                      </para>
                    </entry>
                    <entry valign="top">
                      <para>Enter the path to the help file for the launcher.
If you enter a path in this field, a <guimenuitem>Help on <replaceable>launcher-name</replaceable> Application</guimenuitem> menu item is displayed on the popup
menu for the launcher.</para>
                    </entry>
                  </row>
                </tbody>
              </tgroup>
            </informaltable>
          </listitem>
          <listitem>
            <para>You can also add a translation of the <guilabel>Name</guilabel>, <guilabel>Generic name</guilabel>, and <guilabel>Comment</guilabel> fields from the <guilabel>Basic</guilabel> tabbed section. To add a translation, enter the details of
the translation in the <guilabel>Name/Comment translations</guilabel> table
as follows: </para>
            <informaltable frame="topbot">
              <tgroup cols="2" colsep="0" rowsep="0">
                <colspec colname="colspec0" colwidth="20.78*"/>
                <colspec colname="colspec1" colwidth="79.22*"/>
                <thead>
                  <row rowsep="1">
                    <entry valign="top">
                      <para>Field</para>
                    </entry>
                    <entry valign="top">
                      <para>Description </para>
                    </entry>
                  </row>
                </thead>
                <tbody>
                  <row>
                    <entry valign="top">
                      <para>First field</para>
                    </entry>
                    <entry valign="top">
                      <para>Enter the two-letter code for the language for which you want to add a translation.</para>
                    </entry>
                  </row>
                  <row>
                    <entry valign="top">
                      <para>Second field</para>
                    </entry>
                    <entry valign="top">
                      <para>Enter the translation of the <guilabel>Name</guilabel> of the launcher.</para>
                    </entry>
                  </row>
                  <row>
                    <entry colname="colspec0">
                      <para>Third field</para>
                    </entry>
                    <entry colname="colspec1">
                      <para>Enter the translation of the <guilabel>Generic name</guilabel> of the launcher.</para>
                    </entry>
                  </row>
                  <row>
                    <entry valign="top">
                      <para>Fourth field</para>
                    </entry>
                    <entry valign="top">
                      <para>Enter the translation for the <guilabel>Comment</guilabel> for the launcher. </para>
                    </entry>
                  </row>
                </tbody>
              </tgroup>
            </informaltable>
            <para>Then click on the <guibutton>Add/Set</guibutton> button. </para>
            <para>To edit a translation, select the translation. The translated text appears
in the lower part of this dialog. Edit the fields as required, then click
on the <guibutton>Add/Set</guibutton> button.</para>
            <para>To remove a translation, select the translation, then click on the <guibutton>Remove</guibutton> button.</para>
          </listitem>
          <listitem>
            <para>To create the launcher and close the <guilabel>Launcher Properties</guilabel> dialog, click <guibutton>OK</guibutton>.</para>
          </listitem>
        </orderedlist>
      </sect3>
      <sect3 id="gospanel-556">
        <title>Launcher Commands</title>
        <para>The type of commands that you can enter in the <guilabel>Command</guilabel>
field depend on the option that you choose from the <guilabel>Type</guilabel>
drop-down combination box. If you choose <guilabel>Application</guilabel>
from the <guilabel>Type</guilabel> drop-down combination box, you can enter
a normal command. The following table shows some sample commands and the actions
that the commands perform:</para>
        <informaltable frame="topbot">
          <tgroup cols="2" colsep="0" rowsep="0">
            <colspec colname="colspec0" colwidth="47.36*"/>
            <colspec colname="colspec1" colwidth="52.64*"/>
            <thead>
              <row rowsep="1">
                <entry valign="top">
                  <para>Sample Application Command</para>
                </entry>
                <entry valign="top">
                  <para>Action</para>
                </entry>
              </row>
            </thead>
            <tbody>
              <row>
                <entry colname="colspec0" valign="top">
                  <para>
                    <command>gedit</command>
                  </para>
                </entry>
                <entry colname="colspec1" valign="top">
                  <para>Starts the <application>gedit</application> application.</para>
                </entry>
              </row>
              <row>
                <entry valign="top">
                  <para>
                    <command>gedit /user123/loremipsum.txt</command>
                  </para>
                </entry>
                <entry valign="top">
                  <para>Opens the file <filename>/user123/loremipsum.txt</filename> in the <application>gedit</application> application.</para>
                </entry>
              </row>
              <row>
                <entry colname="colspec0" valign="top">
                  <para>
                    <command>nautilus /user123/Projects</command>
                  </para>
                </entry>
                <entry colname="colspec1" valign="top">
                  <para>Opens
the folder <filename>/user123/Projects</filename> in a file manager window.</para>
                </entry>
              </row>
            </tbody>
          </tgroup>
        </informaltable>
        <para>If you choose <guilabel>Link</guilabel> from the <guilabel>Type</guilabel>
drop-down combination box, you can enter a link command. The following table
shows some sample link commands and the actions that the commands perform:<indexterm><primary>special URIs</primary><secondary>launchers</secondary></indexterm></para>
        <informaltable frame="topbot">
          <tgroup cols="2" colsep="0" rowsep="0">
            <colspec colname="colspec0" colwidth="47.36*"/>
            <colspec colname="colspec1" colwidth="52.64*"/>
            <thead>
              <row rowsep="1">
                <entry valign="top">
                  <para>Sample Link Command</para>
                </entry>
                <entry valign="top">
                  <para>Action</para>
                </entry>
              </row>
            </thead>
            <tbody>
              <row>
                <entry colname="colspec0" valign="top">
                  <para>
                    <command>http://www.gnome.org</command>
                  </para>
                </entry>
                <entry colname="colspec1" valign="top">
                  <para>Opens
the GNOME website in your default browser.</para>
                </entry>
              </row>
              <row>
                <entry valign="top">
                  <para>
                    <command>ftp://ftp.gnome.org</command>
                  </para>
                </entry>
                <entry valign="top">
                  <para>Opens the GNOME FTP site in your default browser. </para>
                </entry>
              </row>
              <row>
                <entry colname="colspec0">
                  <para>
                    <command>applications:///</command>
                  </para>
                </entry>
                <entry colname="colspec1">
                  <para>Opens the <guilabel>Applications</guilabel>
location in a file manager window. Double-click on an application to start
the application.</para>
                </entry>
              </row>
              <row>
                <entry colname="colspec0">
                  <para>
                    <command>preferences:///</command>
                  </para>
                </entry>
                <entry colname="colspec1">
                  <para>Opens the <guilabel>Desktop Preferences</guilabel>
location in a file manager window.  Double-click on a preference tool to start
the preference tool.</para>
                </entry>
              </row>
            </tbody>
          </tgroup>
        </informaltable>
      </sect3>
    </sect2>
    <sect2 id="gospanel-36">
      <title>To Modify the Properties of a Launcher</title>
      <indexterm>
        <primary>launchers</primary>
        <secondary>modifying properties</secondary>
      </indexterm>
      <para>To modify the properties of a launcher perform the following
steps: </para>
      <orderedlist>
        <listitem>
          <para>Right-click on the launcher to open the panel object popup
menu.</para>
        </listitem>
        <listitem>
          <para>Choose <guimenuitem>Properties</guimenuitem>. Use the <guilabel>Launcher Properties</guilabel> dialog to modify the properties as required.
For more information on the <guilabel>Launcher Properties</guilabel> dialog,
see <xref linkend="gospanel-52"/>. </para>
        </listitem>
        <listitem>
          <para>Click <guibutton>Close</guibutton> to close the <guilabel>Launcher Properties</guilabel> dialog.</para>
        </listitem>
      </orderedlist>
    </sect2>
  </sect1>
  <sect1 id="gospanel-557">
    <title>Buttons</title>
    <indexterm>
      <primary>buttons</primary>
      <secondary>adding to panel</secondary>
    </indexterm>
    <para>You can add buttons to your panels to provide quick access
to common actions and functions. </para>
    <sect2 id="gospanel-563">
      <title>Force Quit Button</title>
      <indexterm>
        <primary>buttons</primary>
        <secondary>Force Quit</secondary>
      </indexterm>
      <indexterm>
        <primary>panel objects</primary>
        <secondary>Force Quit button</secondary>
      </indexterm>
      <indexterm>
        <primary>Force Quit button</primary>
      </indexterm>
      <indexterm>
        <primary>terminating applications</primary>
      </indexterm>
      <indexterm>
        <primary>applications</primary>
        <secondary>terminating</secondary>
      </indexterm>
      <screenshot>
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/force_quit.png" format="PNG"/>
          </imageobject>
          <textobject>
            <phrase>Force Quit icon.</phrase>
          </textobject>
        </mediaobject>
      </screenshot>
      <para>The <guibutton>Force Quit</guibutton> button enables you to select a
window to terminate an application. This button is useful if you want to terminate
an application that does not respond to your commands. </para>
      <para>To add a <guibutton>Force Quit</guibutton> button to a panel, right-click
on any vacant space on the panel. Choose <menuchoice><guimenu>Add to Panel</guimenu><guisubmenu>Actions</guisubmenu><guimenuitem>Force Quit</guimenuitem></menuchoice>. To terminate an application, click on the <guibutton>Force Quit</guibutton> button, then click on a window from the application
that you want to terminate. If you do not want to terminate an application
after you click on the <guibutton>Force Quit</guibutton> button, press <keycap>Esc</keycap>.</para>
    </sect2>
    <sect2 id="gospanel-21">
      <title>Lock Button</title>
      <screenshot>
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/lockscreen_icon.png" format="PNG"/>
          </imageobject>
          <textobject>
            <phrase>Lock screen icon.</phrase>
          </textobject>
        </mediaobject>
      </screenshot>
      <indexterm>
        <primary>buttons</primary>
        <secondary>Lock</secondary>
      </indexterm>
      <indexterm>
        <primary>panel objects</primary>
        <secondary>Lock button</secondary>
      </indexterm>
      <indexterm>
        <primary>Lock button</primary>
      </indexterm>
      <indexterm>
        <primary>locking screen</primary>
      </indexterm>
      <para>The <guibutton>Lock</guibutton>
button locks your screen and activates your screensaver. To access your session
again, you must enter your password. To lock your screen correctly, you must
have a screensaver enabled.</para>
      <para>To add a <guibutton>Lock</guibutton> button to a panel, right-click
on any vacant space on the panel. Choose <menuchoice><guimenu>Add to Panel</guimenu><guisubmenu>Actions</guisubmenu><guimenuitem>Lock</guimenuitem></menuchoice>. </para>
      <para>Right-click on the <guibutton>Lock</guibutton> button to open a menu
of screensaver-related commands. <xref linkend="gosstartsession-TBL-83"/> describes
the commands that are available from the menu.</para>
      <table frame="topbot" id="gosstartsession-TBL-83">
        <title>Lock Screen Menu Items</title>
        <tgroup cols="2" colsep="0" rowsep="0">
          <colspec colname="colspec0" colwidth="43.55*"/>
          <colspec colname="colspec1" colwidth="56.45*"/>
          <thead>
            <row rowsep="1">
              <entry valign="top">
                <para>Menu Item</para>
              </entry>
              <entry valign="top">
                <para>Function</para>
              </entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry valign="top">
                <para>
                  <guimenuitem>Activate Screensaver</guimenuitem>
                </para>
              </entry>
              <entry valign="top">
                <para>Activates the screensaver immediately, but does
not lock the screen.</para>
              </entry>
            </row>
            <row>
              <entry valign="top">
                <para>
                  <guimenuitem>Lock Screen</guimenuitem>
                </para>
              </entry>
              <entry valign="top">
                <para>Locks the screen immediately. This command performs
the same function as when you click on the <guibutton>Lock</guibutton> button.</para>
              </entry>
            </row>
            <row>
              <entry valign="top">
                <para>
                  <guimenuitem>Kill Screensaver Daemon</guimenuitem>
                </para>
              </entry>
              <entry valign="top">
                <para>Terminates the screensaver process. After you terminate
the screensaver process, you cannot lock your screen.</para>
              </entry>
            </row>
            <row>
              <entry valign="top">
                <para>
                  <guimenuitem>Restart Screensaver Daemon</guimenuitem>
                </para>
              </entry>
              <entry valign="top">
                <para>Terminates and restarts the screensaver process.
Use this command after you change your password. When you restart the screensaver
process, use your new password with the screensaver.</para>
              </entry>
            </row>
            <row>
              <entry valign="top">
                <para>
                  <guimenuitem>Properties</guimenuitem>
                </para>
              </entry>
              <entry valign="top">
                <para>Displays the <guilabel>XScreenSaver</guilabel> preference
tool. </para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </table>
    </sect2>
    <sect2 id="gospanel-20">
      <title>Log Out Button</title>
      <screenshot>
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/logout_icon.png" format="PNG"/>
          </imageobject>
          <textobject>
            <phrase>Log Out icon.</phrase>
          </textobject>
        </mediaobject>
      </screenshot>
      <indexterm>
        <primary>buttons</primary>
        <secondary>Log Out</secondary>
      </indexterm>
      <indexterm>
        <primary>panel objects</primary>
        <secondary>Log Out button</secondary>
      </indexterm>
      <indexterm>
        <primary>Log Out button</primary>
      </indexterm>
      <para>The <guibutton>Log Out</guibutton> button begins the process to log out of
a GNOME session. </para>
      <para>To add a <guibutton>Log Out</guibutton> button to a panel, right-click
on any vacant space on the panel. Choose <menuchoice><guimenu>Add to Panel</guimenu><guisubmenu>Actions</guisubmenu><guimenuitem>Log Out</guimenuitem></menuchoice>. To log out of your session or shut down your system, click
on the <guibutton>Log Out</guibutton> button. </para>
    </sect2>
    <sect2 id="gospanel-555">
      <title>Run Button</title>
      <screenshot>
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/run_button.png" format="PNG"/>
          </imageobject>
          <textobject>
            <phrase>Run Application icon.</phrase>
          </textobject>
        </mediaobject>
      </screenshot>
      <indexterm>
        <primary>buttons</primary>
        <secondary>Run</secondary>
      </indexterm>
      <indexterm>
        <primary>panel objects</primary>
        <secondary>Run button</secondary>
      </indexterm>
      <indexterm>
        <primary>Run button</primary>
      </indexterm>
      <para>You
can use the <guibutton>Run</guibutton> button to open the <guilabel>Run Application</guilabel> dialog. </para>
      <para>To add a <guibutton>Run</guibutton> button to a panel, right-click on
any vacant space on the panel. Choose <menuchoice><guimenu>Add to Panel</guimenu><guisubmenu>Actions</guisubmenu><guimenuitem>Run</guimenuitem></menuchoice>. To open the <guilabel>Run Application</guilabel> dialog, click
on the <guibutton>Run</guibutton> button. </para>
      <para>For more information on the <guilabel>Run Application</guilabel> dialog,
see <citetitle>Working With Menus</citetitle>.</para>
    </sect2>
    <sect2 id="gospanel-553">
      <title>Screenshot Button</title>
      <screenshot>
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/screenshot_button.png" format="PNG"/>
          </imageobject>
          <textobject>
            <phrase>Screenshot icon.</phrase>
          </textobject>
        </mediaobject>
      </screenshot>
      <indexterm>
        <primary>buttons</primary>
        <secondary>Screenshot</secondary>
      </indexterm>
      <indexterm>
        <primary>panel objects</primary>
        <secondary>Screenshot button</secondary>
      </indexterm>
      <indexterm>
        <primary>Screenshot button</primary>
      </indexterm>
      <para>You can use the <guibutton>Screenshot</guibutton> button to take a screenshot
of your screen. </para>
      <para>To add a <guibutton>Screenshot</guibutton> button to a panel, right-click
on any vacant space on the panel. Choose <menuchoice><guimenu>Add to Panel</guimenu><guisubmenu>Actions</guisubmenu><guimenuitem>Screenshot</guimenuitem></menuchoice>. To take a screenshot of your screen, click on
the <guibutton>Screenshot</guibutton> button.</para>
      <para>For more information on how to take screenshots, see <citetitle>Working
With Menus</citetitle>.</para>
    </sect2>
    <sect2 id="gospanel-554">
      <title>Search Button</title>
      <screenshot>
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/searchtool_button.png" format="PNG"/>
          </imageobject>
          <textobject>
            <phrase>Search Tool icon.</phrase>
          </textobject>
        </mediaobject>
      </screenshot>
      <indexterm>
        <primary>buttons</primary>
        <secondary>Search</secondary>
      </indexterm>
      <indexterm>
        <primary>panel objects</primary>
        <secondary>Search button</secondary>
      </indexterm>
      <indexterm>
        <primary>Search button</primary>
      </indexterm>
      <para>You can use the <guibutton>Search</guibutton> button to open the <application>Search Tool</application>. </para>
      <para>To add a <guibutton>Search</guibutton> button to a panel, right-click
on any vacant space on the panel. Choose <menuchoice><guimenu>Add to Panel</guimenu><guisubmenu>Actions</guisubmenu><guimenuitem>Search</guimenuitem></menuchoice>. To open the <application>Search Tool</application>, click on
the <guibutton>Search</guibutton> button. </para>
      <para>For more information on the <application>Search Tool</application>,
see the <citetitle>Search Tool Manual</citetitle>.</para>
    </sect2>
    <sect2 id="gospanel-564">
      <title>Show Desktop Button</title>
      <indexterm>
        <primary>buttons</primary>
        <secondary>Show Desktop</secondary>
      </indexterm>
      <indexterm>
        <primary>panel objects</primary>
        <secondary>Show Desktop button</secondary>
      </indexterm>
      <indexterm>
        <primary>Show Desktop button</primary>
      </indexterm>
      <screenshot>
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/show_desktop_button.png" format="PNG"/>
          </imageobject>
          <textobject>
            <phrase>Show Desktop icon.</phrase>
          </textobject>
        </mediaobject>
      </screenshot>
      <para>You can use the <guibutton>Show Desktop</guibutton> button to minimize
all open windows and show the desktop.</para>
      <para>To add a <guibutton>Show Desktop</guibutton> button to a panel, right-click
on any vacant space on the panel. Choose <menuchoice><guimenu>Add to Panel</guimenu><guisubmenu>Actions</guisubmenu><guimenuitem>Show Desktop</guimenuitem></menuchoice>. To minimize all windows and show the desktop,
click on the <guibutton>Show Desktop</guibutton> button. </para>
    </sect2>
    <sect2 id="gospanel-567">
      <title>Notification Area Applet</title>
      <indexterm>
        <primary>applets</primary>
        <secondary>Notification Area</secondary>
      </indexterm>
      <indexterm>
        <primary>panel objects</primary>
        <secondary>Notification
Area applet</secondary>
      </indexterm>
      <indexterm>
        <primary>Notification Area applet</primary>
      </indexterm>
      <screenshot>
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/notification_area_icon.png" format="PNG"/>
          </imageobject>
          <textobject>
            <phrase>Notification Area icon.</phrase>
          </textobject>
        </mediaobject>
      </screenshot>
      <para>The <application>Notification Area</application> applet displays icons
from various applications to indicate activity in the application. For example,
when you use the <application>CD Player</application> application to play
a CD, a CD icon is displayed in the <application>Notification Area</application>
applet. The graphic above illustrates the CD icon in the <application>Notification
Area</application> applet. </para>
      <para>To add a <application>Notification Area</application> applet to a panel,
right-click on any vacant space on the panel. Choose <menuchoice><guimenu>Add to Panel</guimenu><guisubmenu>Utility</guisubmenu><guimenuitem>Notification Area</guimenuitem></menuchoice>.</para>
    </sect2>
  </sect1>
  <sect1 id="gospanel-37">
    <title>Menus</title>
    <indexterm>
      <primary>menus</primary>
      <secondary>adding to panel</secondary>
    </indexterm>
    <indexterm>
      <primary>panel objects</primary>
      <secondary>menus</secondary>
    </indexterm>
    <para>You can add the following types of menu to your panels: </para>
    <itemizedlist>
      <listitem>
        <para><guimenu>Main Menu</guimenu>: You can access almost all of
the standard applications, commands, and configuration options from the <guimenu>Main Menu</guimenu>. To add a <guimenu>Main Menu</guimenu> to a panel, right-click
on any vacant space on the panel, then choose <menuchoice><guimenu>Add to
Panel</guimenu><guimenuitem>Main Menu</guimenuitem></menuchoice>.
You can add as many <guimenu>Main Menu</guimenu> objects to your panels as
you want. By default, the <guimenu>Main Menu</guimenu> is represented on panels
by a stylized footprint icon, as follows:</para>
        <screenshot>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/footprint_icon.png" format="PNG"/>
            </imageobject>
            <textobject>
              <phrase>Main Menu icon.</phrase>
            </textobject>
          </mediaobject>
        </screenshot>
      </listitem>
      <listitem>
        <para><application>Menu Bar</application>: You can access almost
all of the standard applications, commands, and configuration options from
the menus in the <application>Menu Bar</application>. The <application>Menu
Bar</application> contains the <guimenu>Applications</guimenu> menu and the <guimenu>Actions</guimenu> menu. To add a <application>Menu Bar</application> to a
panel, right-click on any vacant space on the panel, then choose <menuchoice><guimenu>Add to Panel</guimenu><guimenuitem>Menu Bar</guimenuitem></menuchoice>. You can add as many <application>Menu Bar</application> objects
to your panels as you want. </para>
      </listitem>
      <listitem>
        <para>System menus: System menus contain the standard applications
and tools that you can use in your desktop environment. The <guimenu>Applications</guimenu> menu and <guimenu>Actions</guimenu> menu are system menus. To add
a system menu to a panel, right-click on a launcher in the menu, then choose <menuchoice><guimenu>Entire menu</guimenu><guimenuitem>Add this as menu to panel</guimenuitem></menuchoice>. </para>
      </listitem>
    </itemizedlist>
    <para>Menus that you add to your panels are represented by an icon with an
arrow. The arrow indicates that the icon represents a menu or drawer. <xref linkend="gospanel-FIG-68"/> shows how menus typically appear on panels. </para>
    <figure id="gospanel-FIG-68">
      <title>Typical Menu Objects on a Panel</title>
      <screenshot>
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/typical_menu.png" format="PNG"/>
          </imageobject>
          <textobject>
            <phrase>Typical menu objects on panel.</phrase>
          </textobject>
        </mediaobject>
      </screenshot>
    </figure>
  </sect1>
  <sect1 id="gospanel-18">
    <title>Drawers</title>
    <indexterm>
      <primary>panel objects</primary>
      <secondary>drawers</secondary>
      <see>drawers</see>
    </indexterm>
    <para>A drawer is an extension of a panel. You
can open and close a drawer in the same way that you can show and hide a panel.
A drawer can contain all panel objects, including launchers, menus, applets,
other panel objects, and other drawers. When you open a drawer, you can use
the objects in the same way that you use objects on a panel. </para>
    <para>The following figure shows an open drawer that contains two panel objects. </para>
    <screenshot>
      <mediaobject>
        <imageobject>
          <imagedata fileref="figures/open_drawer.png" format="PNG"/>
        </imageobject>
        <textobject>
          <phrase>Open drawer. The context describes the graphic.</phrase>
        </textobject>
      </mediaobject>
    </screenshot>
    <para>The arrow on the drawer icon indicates that the icon represents a drawer
or menu.</para>
    <para>You can add, move, and remove objects from drawers in the same way that
you add, move, and remove objects from panels. </para>
    <sect2 id="gospanel-42">
      <title>To Open and Close a Drawer</title>
      <indexterm>
        <primary>drawers</primary>
        <secondary>opening</secondary>
      </indexterm>
      <indexterm>
        <primary>drawers</primary>
        <secondary>closing</secondary>
      </indexterm>
      <para>To open a drawer, click on the drawer object in a panel. You can close
a drawer in the following ways: </para>
      <itemizedlist>
        <listitem>
          <para>Click on the drawer.</para>
        </listitem>
        <listitem>
          <para>Click on the drawer hide button.</para>
        </listitem>
      </itemizedlist>
    </sect2>
    <sect2 id="gospanel-420">
      <title>To Add a Drawer to a Panel</title>
      <indexterm>
        <primary>drawers</primary>
        <secondary>adding to panel</secondary>
      </indexterm>
      <para>You can add a drawer to a panel in the following ways: </para>
      <itemizedlist>
        <listitem>
          <para>From the panel popup menu</para>
          <para>Right-click on any vacant space on the panel, then choose <menuchoice><guimenu>Add to Panel</guimenu><guimenuitem>Drawer</guimenuitem></menuchoice>. </para>
        </listitem>
        <listitem>
          <para>From any menu</para>
          <para>You can add a menu as a drawer object to a panel.</para>
          <para>To add a menu as a drawer to a panel, open the menu from the panel.
Right-click on any launcher in the menu, then choose <menuchoice><guimenu>Entire menu</guimenu><guimenuitem>Add this as drawer to panel</guimenuitem></menuchoice>.</para>
        </listitem>
      </itemizedlist>
    </sect2>
    <sect2 id="gospanel-54">
      <title>To Add an Object to a Drawer</title>
      <indexterm>
        <primary>drawers</primary>
        <secondary>adding objects to</secondary>
      </indexterm>
      <para>You add an object to a drawer in the same way that you add
objects to panels. For more information, see <xref linkend="gospanel-15"/>.</para>
    </sect2>
    <sect2 id="gospanel-550">
      <title>To Modify Drawer Properties</title>
      <indexterm>
        <primary>drawers</primary>
        <secondary>modifying properties</secondary>
      </indexterm>
      <para>To modify preferences for all panels and drawers, use the <application>Panel</application> preference tool. For example, you can select various options
related to the appearance and behavior of objects on panels and drawers. You
can also select options that relate to drawers only. For example, you can
select an option to close your drawers when you click on a launcher in the
drawer.</para>
      <para>You can also modify other properties for each individual drawer. You
can change features for each drawer, such as the visual appearance of the
drawer and whether the drawer has hide buttons.</para>
      <para>To modify properties for a drawer perform the following steps: </para>
      <orderedlist>
        <listitem>
          <para>Right-click on the drawer, then choose <guimenuitem>Properties</guimenuitem> to display the <guilabel>Panel Properties</guilabel> dialog.
The dialog displays the <guilabel>General</guilabel> tabbed section.</para>
        </listitem>
        <listitem>
          <para>Select the properties for the drawer in the dialog. The following
table describes the elements on the <guilabel>General</guilabel> tabbed section:</para>
          <informaltable frame="topbot">
            <tgroup cols="2" colsep="0" rowsep="0">
              <colspec colname="colspec0" colwidth="28.57*"/>
              <colspec colname="colspec1" colwidth="71.43*"/>
              <thead>
                <row rowsep="1">
                  <entry valign="top">
                    <para>Dialog Element</para>
                  </entry>
                  <entry valign="top">
                    <para>Description </para>
                  </entry>
                </row>
              </thead>
              <tbody>
                <row>
                  <entry colname="colspec0">
                    <para>
                      <guilabel>Name</guilabel>
                    </para>
                  </entry>
                  <entry colname="colspec1">
                    <para>Type a name for the panel. When you use shortcut
keys to switch between your panels and the desktop, this panel name is displayed.</para>
                  </entry>
                </row>
                <row>
                  <entry valign="top">
                    <para>
                      <guilabel>Size</guilabel>
                    </para>
                  </entry>
                  <entry valign="top">
                    <para>Select the size of the panel.</para>
                  </entry>
                </row>
                <row>
                  <entry colname="colspec0">
                    <para>
                      <guilabel>Icon</guilabel>
                    </para>
                  </entry>
                  <entry colname="colspec1">
                    <para>Choose an icon to represent the drawer. Click
on the <guibutton>Icon</guibutton> button to display an icon selector dialog.
Choose an icon from the dialog. Alternatively, click <guibutton>Browse</guibutton>
to choose an icon from another directory. When you choose an icon, click <guibutton>OK</guibutton>.</para>
                  </entry>
                </row>
                <row>
                  <entry valign="top">
                    <para>
                      <guilabel>Show hide buttons</guilabel>
                    </para>
                  </entry>
                  <entry valign="top">
                    <para>Select this option to display hide buttons on your
panel.</para>
                  </entry>
                </row>
                <row>
                  <entry valign="top">
                    <para>
                      <guilabel>Arrows on hide button</guilabel>
                    </para>
                  </entry>
                  <entry valign="top">
                    <para>Select this option to display arrows on the hide
buttons, if the hide button is enabled.</para>
                  </entry>
                </row>
              </tbody>
            </tgroup>
          </informaltable>
        </listitem>
        <listitem>
          <para>You can use the <guilabel>Background</guilabel> tabbed section
to set the background for the drawer. For information on how to complete the <guilabel>Background</guilabel> tabbed section, see the step on this topic in <xref linkend="gospanel-28"/>. You can also drag a color or image on to a drawer
to set the color or image as the background of the drawer. For more information,
 see <xref linkend="gospanel-61"/>.</para>
        </listitem>
        <listitem>
          <para>Click <guibutton>Close</guibutton> to close the <guilabel>Panel Properties</guilabel> dialog.</para>
        </listitem>
      </orderedlist>
    </sect2>
  </sect1>
</chapter>