diff options
author | Sander Vesik <sander@src.gnome.org> | 2002-05-27 08:07:33 +0000 |
---|---|---|
committer | Sander Vesik <sander@src.gnome.org> | 2002-05-27 08:07:33 +0000 |
commit | 48b9f6bddef342235022f813b22394891a2add12 (patch) | |
tree | c959a0f9815cf045e7e10ac92b684883fb9ba525 /gnome2-user-guide/C/gospanel.xml | |
parent | ed497aeccb0b3b64e82dcfd3a9c4fc746ecf129d (diff) | |
download | gnome-user-docs-48b9f6bddef342235022f813b22394891a2add12.tar.gz gnome-user-docs-48b9f6bddef342235022f813b22394891a2add12.tar.xz gnome-user-docs-48b9f6bddef342235022f813b22394891a2add12.zip |
INitial checkin of the gnome2 user guide
Diffstat (limited to 'gnome2-user-guide/C/gospanel.xml')
-rw-r--r-- | gnome2-user-guide/C/gospanel.xml | 2576 |
1 files changed, 2576 insertions, 0 deletions
diff --git a/gnome2-user-guide/C/gospanel.xml b/gnome2-user-guide/C/gospanel.xml new file mode 100644 index 0000000..34916a1 --- /dev/null +++ b/gnome2-user-guide/C/gospanel.xml @@ -0,0 +1,2576 @@ +<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 on your desktop from which you can run + applications and applets, and perform other tasks. When you start a session for + the first time, the desktop contains the following panels: </para> + <itemizedlist> + <listitem> + <para>GNOME Panel</para> + </listitem> + <listitem> + <para>Menu Panel</para> + </listitem> + </itemizedlist> + <para>The following sections describe these panels.</para> + <sect2 id="gospanel-3"> + <title>GNOME Panel</title> + <indexterm> + <primary>panels</primary> + <secondary>GNOME Panel</secondary> + </indexterm> + <para>The GNOME Panel is the default panel for working in a session. The + GNOME Panel stretches the full length of the bottom edge of the desktop. + </para> + <para><xref linkend="gospanel-FIG-58"/> shows a typical GNOME Panel. Your + system administrator might have set your default GNOME Panel according to your + local requirements, so you might see a slightly different GNOME Panel. </para> + <figure id="gospanel-FIG-58"> + <title>Typical GNOME Panel</title> + <screenshot> + <mediaobject> + <imageobject> + <imagedata fileref="figures/gnome_panel.png" format="PNG"/> + </imageobject> + <textobject> + <phrase>Screenshot of a typical GNOME Panel</phrase> + </textobject> + </mediaobject> + </screenshot> + </figure> + <sect3 id="gospanel-27"> + <title>Contents of the GNOME Panel</title> + <para><xref linkend="gospanel-TBL-45"/> describes the objects on the + default GNOME Panel. </para> + <table frame="topbot" id="gospanel-TBL-45"> + <title>Default GNOME Panel Objects</title> + <tgroup cols="3" colsep="0" rowsep="0"><colspec colname="COLSPEC0" + colwidth="36.50*"/> + <colspec colname="COLSPEC1" colwidth="20.83*"/><colspec + colname="COLSPEC2" colwidth="41.67*"/> + <thead> + <row rowsep="1"> + <entry> + <para>Object</para></entry> + <entry> + <para>Name</para></entry> + <entry> + <para>Description</para></entry> + </row> + </thead> + <tbody> + <row> + <entry> + <screenshot> + <mediaobject> + <imageobject> + <imagedata fileref="figures/footprint_icon.png" format="PNG"/> + </imageobject> + <textobject> + <phrase>Screenshot of Global Menu icon</phrase> + </textobject> + </mediaobject> + </screenshot></entry> + <entry> + <para> + <guimenu>Global Menu</guimenu> button</para></entry> + <entry> + <para>Click on this button to open the + <guimenu>Global Menu</guimenu>. From the + <guimenu>Global Menu </guimenu>, you can start applications + and applets, open more menus, and perform other tasks. </para></entry> + </row> + <row> + <entry> + <screenshot> + <mediaobject> + <imageobject> + <imagedata fileref="figures/logout_icon.png" format="PNG"/> + </imageobject> + <textobject> + <phrase>Screenshot of Log Out icon</phrase> + </textobject> + </mediaobject> + </screenshot></entry> + <entry> + <para> + <guibutton>Log Out</guibutton> button</para></entry> + <entry> + <para>Click on this button to log out of your GNOME + session.</para></entry> + </row> + <row> + <entry> + <screenshot> + <mediaobject> + <imageobject> + <imagedata fileref="figures/lockscreen_icon.png" format="PNG"/> + </imageobject> + <textobject> + <phrase>Screenshot of Lock Screen icon</phrase> + </textobject> + </mediaobject> + </screenshot></entry> + <entry> + <para> + <guibutton>Lock Screen</guibutton> button </para></entry> + <entry> + <para>Click on this button to lock your screen. </para></entry> + </row> + <row> + <entry> + <screenshot> + <mediaobject> + <imageobject> + <imagedata fileref="figures/help_icon.png" format="PNG"/> + </imageobject> + <textobject> + <phrase>Screenshot of GNOME Help Browser icon</phrase> + </textobject> + </mediaobject> + </screenshot> + </entry> + <entry> + <para><application>GNOME Help Browser</application> launcher + </para></entry> + <entry> + <para>Click on this button to start the <application> GNOME + Help Browser</application>. </para></entry> + </row> + <row> + <entry> + <screenshot> + <mediaobject> + <imageobject> + <imagedata fileref="figures/gnometerminal_icon.png" format="PNG"/> + </imageobject> + <textobject> + <phrase>Screenshot of GNOME Terminal icon</phrase> + </textobject> + </mediaobject> + </screenshot></entry> + <entry> + <para><application>GNOME Terminal</application> launcher + </para></entry> + <entry> + <para>Click on this button to start a <application> GNOME + Terminal</application>. <application>GNOME Terminal</application> provides + access to a UNIX command line.</para></entry> + </row> + <row> + <entry> + <screenshot> + <mediaobject> + <imageobject> + <imagedata fileref="figures/controlcenter_icon.png" format="PNG"/> + </imageobject> + <textobject> + <phrase>Screenshot of Control Center icon</phrase> + </textobject> + </mediaobject> + </screenshot></entry> + <entry> + <para><application>Control Center</application> launcher + </para></entry> + <entry> + <para> Click to configure various parts of your system. + </para></entry> + </row> + <row> + <entry> + <screenshot> + <mediaobject> + <imageobject> + <imagedata fileref="figures/netscape_icon.png" format="PNG"/> + </imageobject> + <textobject> + <phrase>Screenshot of Netscape icon</phrase> + </textobject> + </mediaobject> + </screenshot></entry> + <entry> + <para><application>Netscape</application> launcher + </para></entry> + <entry> + <para> Click on this button to start <application>Netscape + </application>. </para></entry> + </row> + <row> + <entry> + <screenshot> + <mediaobject> + <imageobject> + <imagedata fileref="figures/tasklist_applet.png" format="PNG"/> + </imageobject> + <textobject> + <phrase>Screenshot of Tasklist applet</phrase> + </textobject> + </mediaobject> + </screenshot></entry> + <entry> + <para><application>Tasklist</application> applet + </para></entry> + <entry> + <para>Displays a button for each window that is open. You can + use the tasklist buttons to minimize and restore windows.</para></entry> + </row> + <row> + <entry colname="COLSPEC0"> + <screenshot> + <mediaobject> + <imageobject> + <imagedata fileref="figures/statusdock2_button.png" format="PNG"/> + </imageobject> + <textobject> + <phrase>Screenshot of status dock</phrase> + </textobject> + </mediaobject> + </screenshot></entry> + <entry colname="COLSPEC1"> + <para>Status dock</para></entry> + <entry colname="COLSPEC2"> + <para>Displays status information for some applications and + applets.</para></entry> + </row> + </tbody> + </tgroup> + </table> + <para>You can change the behavior and appearance of your GNOME Panel to + suit your requirements. You can also add or remove objects from the GNOME + Panel. </para> + <para>You can create multiple panels, and choose different properties, + objects, and backgrounds for each panel. You can also hide panels.</para> + </sect3> + </sect2> + <sect2 id="gospanel-6"> + <title>Menu Panel</title> + <para>The desktop also includes a Menu Panel, which is different in + appearance from the GNOME Panel, but provides similar functions. The Menu Panel + stretches the full length of the top edge of your screen. The Menu Panel + includes textual rather than graphical menus.</para> + <para><xref linkend="gospanel-FIG-60"/> shows the Menu Panel. Your system + administrator might have set your default Menu Panel according to your local + requirements, so you might see a slightly different Menu Panel.</para> + <figure id="gospanel-FIG-60"> + <title>Typical Menu Panel</title> + <screenshot> + <mediaobject> + <imageobject> + <imagedata fileref="figures/menu_panel.png" format="PNG"/> + </imageobject> + <textobject> + <phrase>Screenshot of typical Menu Panel</phrase> + </textobject> + </mediaobject> + </screenshot> + </figure> + <para>The Menu Panel contains the following objects: </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> + <para>Object</para></entry> + <entry> + <para>Description </para></entry> + </row> + </thead> + <tbody> + <row> + <entry> + <para> + <guimenu>Programs</guimenu> menu</para></entry> + <entry> + <para> The + <guimenu>Programs</guimenu> menu contains the standard GNOME + applications. </para></entry> + </row> + <row> + <entry> + <para> + <guimenu>Favorites</guimenu> menu </para></entry> + <entry> + <para> You can customize the + <guimenu>Favorites</guimenu> menu to help you work more + efficiently. You can add items that you use frequently to the + <guimenu>Favorites </guimenu> menu, and organize the items + into submenus.</para></entry> + </row> + <row> + <entry> + <para> + <guimenu>Settings</guimenu> menu </para></entry> + <entry> + <para> The + <guimenu>Settings</guimenu> menu contains menu items to + configure and customize your desktop. </para></entry> + </row> + <row> + <entry> + <para> + <guimenu>Desktop</guimenu> menu</para></entry> + <entry> + <para> The + <guimenu>Desktop</guimenu> menu provides menu items that + relate to the current status of your desktop. </para></entry> + </row> + <row> + <entry colname="COLSPEC3"> + <para><application>Desk Guide</application> + applet</para></entry> + <entry colname="COLSPEC4"> + <para>The <application>Desk Guide</application> applet enables + you to navigate between your workspaces and viewports.</para></entry> + </row> + <row> + <entry colname="COLSPEC3"> + <para><application>Mailcheck</application> + applet</para></entry> + <entry colname="COLSPEC4"> + <para>The <application>Mailcheck </application> applet shows + whether you have new email messages.</para></entry> + </row> + <row> + <entry> + <para>Calendar icon</para></entry> + <entry> + <para>The calendar icon normally shows the current time. Click + on the time readout to display a menu of calendar commands. You can also use + this menu to change the format of the time readout. </para></entry> + </row> + <row> + <entry colname="COLSPEC3"> + <para>Window list icon</para></entry> + <entry colname="COLSPEC4"> + <para>The window list is a list of all open windows on the + desktop. To give focus to a window click on the icon at the extreme right of + the Menu Panel then choose the window.</para></entry> + </row> + </tbody> + </tgroup> + </informaltable> + <para>Unlike other types of panel, you can only have one Menu Panel at a + time on your desktop.</para> + </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 Create a Panel</title> + <para>You can create different types of panels to customize your desktop. + <xref linkend="gospanel-TBL-47"/> lists the types of panel that you can create, + and their characteristics. </para> + <table frame="topbot" id="gospanel-TBL-47"> + <title>Types of Panel</title> + <tgroup cols="3" colsep="0" rowsep="0"><colspec colname="COLSPEC0" + colwidth="32.86*"/> + <colspec colname="COLSPEC1" colwidth="32.96*"/><colspec + colname="COLSPEC2" colwidth="33.17*"/> + <thead> + <row rowsep="1"> + <entry> + <para>Panel Type</para></entry> + <entry> + <para>Snap Behavior </para></entry> + <entry> + <para>Size</para></entry> + </row> + </thead> + <tbody> + <row> + <entry colname="COLSPEC0"> + <para>Aligned panel</para></entry> + <entry colname="COLSPEC1"> + <para> Snaps to one of the edges of the screen, but can only snap + to the center or the corner of the edge. </para></entry> + <entry colname="COLSPEC2"> + <para>Stretches as much as required to display the objects on the + panel.</para></entry> + </row> + <row> + <entry> + <para>Edge panel</para></entry> + <entry> + <para>Snaps to one of the edges of the screen. The GNOME Panel is + an example of an edge panel. </para></entry> + <entry> + <para>Stretches the full length of the edge that the panel snaps + to. </para></entry> + </row> + <row> + <entry> + <para>Floating panel</para></entry> + <entry> + <para>Does not snap to anything. You can place a floating panel + anywhere on your desktop.</para></entry> + <entry> + <para>Stretches as much as required to display the objects on the + panel. </para></entry> + </row> + <row> + <entry> + <para>Menu Panel</para></entry> + <entry> + <para>Snaps to the top edge of the screen. You can not move the + Menu Panel.</para></entry> + <entry> + <para> Stretches the full length of the top edge of the screen. + You can only have one Menu Panel on your desktop.</para></entry> + </row> + <row> + <entry> + <para>Sliding panel</para></entry> + <entry> + <para>Snaps to one of the edges of the screen, can snap to any + point on the edge.</para></entry> + <entry> + <para>Stretches as much as required to display the objects on the + panel. </para></entry> + </row> + </tbody> + </tgroup> + </table> + <para>To create a panel perform the following steps:</para> + <orderedlist> + <listitem> + <para>Right-click on any part of a panel to open the + <guimenu>Global Menu</guimenu>.</para> + </listitem> + <listitem> + <para>Choose + <menuchoice> + <guimenu>Panel</guimenu> + <guimenuitem> Create panel</guimenuitem> + </menuchoice>.</para> + </listitem> + <listitem> + <para>Choose the type of panel that you want to create. The new panel + is added to the desktop. The new panel contains no objects. </para> + <para>You can customize the new panel to suit your + preferences.</para> + </listitem> + </orderedlist> + </sect2> + <sect2 id="gospanel-11"> + <title>Interacting With a Panel</title> + <para>To interact with a panel, you must left-click, middle-click, or + right-click on a vacant space on the panel. If there is no vacant space on the + panel, you can middle-click or right-click on one of the hide buttons to select + the panel.</para> + <para>You use the mouse buttons to interact with a panel in the following + ways:</para> + <informaltable frame="topbot"> + <tgroup cols="2" colsep="0" rowsep="0"><colspec colname="COLSPEC0" + colwidth="30.65*"/> + <colspec colname="COLSPEC1" colwidth="69.35*"/> + <tbody> + <row> + <entry> + <para>Middle-click</para></entry> + <entry> + <para>Enables you to grab a panel, then drag the panel to a new + location.</para></entry> + </row> + <row> + <entry> + <para>Right-click</para></entry> + <entry> + <para>Opens the + <guimenu> Global Menu</guimenu>.</para></entry> + </row> + </tbody> + </tgroup> + </informaltable> + </sect2> + <sect2 id="gospanel-12"> + <title>To Move a Panel</title> + <para>You can move panels to different locations on your desktop. To move + a panel, middle-click and hold on any vacant space on the panel, then drag the + panel to the new location.</para> + <para>When you drag a floating panel, the panel follows the mouse + pointer. The panel does not snap to any part of the desktop. When you drag an + edge panel, an aligned panel, or a sliding panel, the panel snaps to the edge + of the screen.</para> + <note> + <para>You can not move the Menu Panel.</para> + </note> + </sect2> + <sect2 id="gospanel-7"> + <title>To Hide a Panel</title> + <para>You can hide or show a panel on your desktop, except for the Menu + Panel. Each panel has hide buttons at either end. The hide buttons contain an + arrow icon. The following illustration shows hide buttons. </para> + <screenshot> + <mediaobject> + <imageobject> + <imagedata fileref="figures/four_hide_button.png" format="PNG"/> + </imageobject> + <textobject> + <phrase>Screenshot of 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 modify the properties of a panel so that the hide buttons + are not visible. You can also specify that the arrows on hide buttons are not + 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> + <note> + <para>On an aligned panel, the behavior of the hide buttons is slightly + different. If the panel is aligned with one of the corners of the screen, you + can use the hide buttons as follows:</para> + <itemizedlist> + <listitem> + <para>To hide the panel, click the hide button that is closest to + the edge of the screen, as normal.</para> + </listitem> + <listitem> + <para>To move the panel to the opposite corner of the screen, click + the hide button that is farthest from the edge of the screen.</para> + </listitem> + </itemizedlist> + </note> + </sect2> + <sect2 id="gospanel-28"> + <title>To Modify the Properties of a Panel</title> + <para>You can configure global preferences for all panels in the + <application> Control Center</application>. 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> + <note> + <para>You cannot modify properties for the Menu Panel.</para> + </note> + <para>The following sections describe how to modify the properties of a + panel. </para> + + <sect3 id="gospanel-29"> + <title>To Modify a Panel With the Panel Properties Menu</title> + <para>You can use the panel properties menu to configure the properties + of a panel. To modify the properties of a panel perform the following steps: + </para> + <orderedlist> + <listitem> + <para>Right-click on any part of the panel to open the + <guimenu> Global Menu</guimenu>.</para> + </listitem> + <listitem> + <para>Choose + <menuchoice> + <guimenu>Panel</guimenu> + <guimenuitem> Properties</guimenuitem> + </menuchoice> to open the panel properties menu. The following + table describes the menu items on the panel properties menu: </para> + <informaltable frame="topbot"> + <tgroup cols="2" colsep="0" rowsep="0"><colspec + colname="COLSPEC0" colwidth="31.82*"/> + <colspec colname="COLSPEC1" colwidth="68.18*"/> + <thead> + <row rowsep="1"> + <entry> + <para>Menu Item</para></entry> + <entry> + <para>Description </para></entry> + </row> + </thead> + <tbody> + <row> + <entry> + <para>All properties</para></entry> + <entry> + <para>For more information see + <xref linkend="gospanel-30"/>.</para></entry> + </row> + <row> + <entry> + <para>Type</para></entry> + <entry> + <para>Choose the type of the panel you want. Choose from + the following types of panel: </para> + <itemizedlist> + <listitem> + <para> + <guilabel>Edge panel</guilabel></para> + </listitem> + <listitem> + <para> + <guilabel>Aligned panel</guilabel></para> + </listitem> + <listitem> + <para> + <guilabel>Sliding panel</guilabel></para> + </listitem> + <listitem> + <para> + <guilabel>Floating panel</guilabel></para> + </listitem> + </itemizedlist></entry> + </row> + <row> + <entry> + <para>Hiding policy</para></entry> + <entry> + <para>Select whether to enable autohide. Select from the + following options:</para> + <itemizedlist> + <listitem> + <para> + <guilabel>Explicit hide</guilabel>: Select this + option if you want to use the hide buttons to hide the panel.</para> + </listitem> + <listitem> + <para> + <guilabel>Auto hide</guilabel>: Select this option + if you want to enable autohide <emphasis>and</emphasis> use the hide buttons to + hide the panel.</para> + </listitem> + </itemizedlist></entry> + </row> + <row> + <entry> + <para>Hide buttons</para></entry> + <entry> + <para>Select how to display the hide buttons. Select from + the following options: </para> + <itemizedlist> + <listitem> + <para> + <guilabel>With pixmap arrows</guilabel>: Select + this option to display arrow icons on the hide buttons.</para> + </listitem> + <listitem> + <para> + <guilabel>Without pixmap</guilabel>: Select this + option to display no arrow icons on the hide buttons.</para> + </listitem> + <listitem> + <para> + <guilabel>None</guilabel>: Select this option if + you do not want to display the hide buttons.</para> + </listitem> + </itemizedlist></entry> + </row> + <row> + <entry> + <para>Size</para></entry> + <entry> + <para>Select the size of the panel. </para></entry> + </row> + <row> + <entry colname="COLSPEC0"> + <para>Orientation</para></entry> + <entry colname="COLSPEC1"> + <para> Floating panel only. Select whether to display the + panel horizontally or vertically. </para></entry> + </row> + <row> + <entry> + <para>Background type</para></entry> + <entry> + <para>Select the type of background for the panel. You + can choose a standard background, a color background, or an image background. + Use the + <guilabel>Panel Properties</guilabel> dialog to specify + the color and image. For more information see <xref linkend="gospanel-30"/>. + </para></entry> + </row> + <row> + <entry colname="COLSPEC0"> + <para>Level</para></entry> + <entry colname="COLSPEC1"> + <para> Select the level at which you want the panel to + appear. Select from one of the following options:</para> + <itemizedlist> + <listitem> + <para> + <guilabel>Default</guilabel>: Select this option to + use the default setting that is specified in the + <application>Panel</application> capplet.</para> + </listitem> + <listitem> + <para> + <guilabel>Below</guilabel>: Select this option if + you want the panel to appear below windows. </para> + </listitem> + <listitem> + <para> + <guilabel>Normal</guilabel>: Select this option if + you want the panel to appear at the same level as windows. </para> + </listitem> + <listitem> + <para> + <guilabel>Above</guilabel>: Select this option if + you want the panel to appear above windows.</para> + </listitem> + </itemizedlist></entry> + </row> + <row> + <entry colname="COLSPEC0"> + <para>Maximize mode</para></entry> + <entry colname="COLSPEC1"> + <para> Select whether you want maximized windows to avoid + the panel or cover the panel.</para> + <itemizedlist> + <listitem> + <para> + <guilabel>Avoid on maximize</guilabel>: Select this + option if you do not want to overlap the panel when you maximize + windows.</para> + </listitem> + <listitem> + <para> + <guilabel>Don't avoid on maximize</guilabel>: + Select this option if you want to overlap the panel when you maximize windows. + </para> + </listitem> + </itemizedlist></entry> + </row> + </tbody> + </tgroup> + </informaltable> + </listitem> + </orderedlist> + </sect3> + <sect3 id="gospanel-30"> + <title>To Modify a Panel With the Panel Properties Dialog</title> + <para>You can use the + <guilabel>Panel Properties</guilabel> dialog to modify panel + properties. To modify the properties of a panel perform the following steps: + </para> + <orderedlist> + <listitem> + <para>Right-click on any part of the panel to open the + <guimenu> Global Menu</guimenu>.</para> + </listitem> + <listitem> + <para>Choose + <menuchoice> + <guimenu>Panel</guimenu> + <guisubmenu> Properties</guisubmenu> + <guimenuitem>All properties</guimenuitem> + </menuchoice> to display the + <guilabel>Panel Properties</guilabel> dialog. The following + figure shows the + <guilabel>Panel Properties</guilabel> dialog for the GNOME Panel. + The GNOME Panel is an edge panel that resides at the bottom edge of your + desktop. </para> + <screenshot> + <mediaobject> + <imageobject> + <imagedata fileref="figures/panelprop_dialog.png" format="PNG"/> + </imageobject> + <textobject> + <phrase>Screenshot of Panel Properties dialog</phrase> + </textobject> + </mediaobject> + </screenshot> + <para>The + <guilabel>Panel Properties</guilabel> dialog contains the + following tabbed sections: </para> + <itemizedlist> + <listitem> + <para> + <guilabel>Panel</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>Panel</guilabel> tab. The + <guilabel>Panel</guilabel> tabbed section contains the following + options: </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> + <para>Option</para></entry> + <entry> + <para>Description </para></entry> + </row> + </thead> + <tbody> + <row> + <entry> + <para> + <guilabel>Panel size</guilabel></para></entry> + <entry> + <para> Choose the size of the panel.</para></entry> + </row> + <row> + <entry> + <para> + <guilabel>Panel position</guilabel></para></entry> + <entry> + <para> Choose the position of the panel on your desktop. + Click on the required position for the panel. </para></entry> + </row> + <row> + <entry colname="COLSPEC0"> + <para> + <guilabel>Panel window level</guilabel></para></entry> + <entry colname="COLSPEC1"> + <para>Select the level or layer at which you want the + panel to appear. Select from one of the following options:</para> + <itemizedlist> + <listitem> + <para> + <guilabel>Default (from global preferences) + </guilabel>: Select this option to use the default setting that is specified in + the <application> Panel</application> capplet.</para> + </listitem> + <listitem> + <para> + <guilabel>Below other windows</guilabel>: Select + this option if you want the panel to appear below windows.</para> + </listitem> + <listitem> + <para> + <guilabel>Normal</guilabel>: Select this option if + you want the panel to appear at the same level as windows.</para> + </listitem> + <listitem> + <para> + <guilabel>Above other windows</guilabel>: Select + this option if you want the panel to appear above windows.</para> + </listitem> + </itemizedlist></entry> + </row> + <row> + <entry> + <para> + <guilabel>Orient panel + horizontally</guilabel></para></entry> + <entry> + <para>Floating panel only. Select this option to display + the panel horizontally. </para></entry> + </row> + <row> + <entry> + <para> + <guilabel>Orient panel + vertically</guilabel></para></entry> + <entry> + <para>Floating panel only. Select this option to display + the panel vertically.</para></entry> + </row> + <row> + <entry> + <para> + <guilabel>Top left corner's + position</guilabel></para></entry> + <entry> + <para>Floating panel only. Use the + <guilabel>X</guilabel> and + <guilabel> Y</guilabel> spin boxes to specify the + coordinates for the top-left corner of the panel. </para></entry> + </row> + <row> + <entry> + <para> + <guilabel>Offset from screen + edge</guilabel></para></entry> + <entry> + <para>Sliding panel only. Use this spin box to specify + the distance between your panel and the edge of the screen, in pixels. + </para></entry> + </row> + <row> + <entry> + <para> + <guilabel>Enable Auto-hide</guilabel></para></entry> + <entry> + <para> Select this option to enable autohide. + </para></entry> + </row> + <row> + <entry> + <para> + <guilabel>Show hide buttons</guilabel></para></entry> + <entry> + <para> Select this option to display hide buttons on your + panel.</para></entry> + </row> + <row> + <entry> + <para> + <guilabel>Show arrows on hide button + </guilabel></para></entry> + <entry> + <para>Select this option to display arrows on the hide + buttons, if the hide button is enabled.</para></entry> + </row> + <row> + <entry colname="COLSPEC0"> + <para> + <guilabel>Avoid this panel when maximizing + windows</guilabel></para></entry> + <entry colname="COLSPEC1"> + <para>Select this option if you do not want to overlap + the panel when you maximize windows. </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> + <informaltable frame="topbot"> + <tgroup cols="3" colsep="0" rowsep="0"><colspec + colwidth="27.00*"/><colspec colname="COLSPEC5" colwidth="29.14*"/><colspec + colname="COLSPEC6" colwidth="42.86*"/> + <thead> + <row rowsep="1"> + <entry> + <para>Dialog Element</para></entry> + <entry namest="COLSPEC5" nameend="COLSPEC6"> + <para>Description</para></entry> + </row> + </thead> + <tbody> + <row> + <entry> + <para> + <guilabel>Background Type</guilabel></para></entry> + <entry namest="COLSPEC5" nameend="COLSPEC6"> + <para>Choose the type of background for the panel. The + choices are as follows:</para> + <itemizedlist> + <listitem> + <para> + <guilabel>Standard</guilabel>: The standard + background type. The standard background depends on the settings in the + <application>Theme Selector</application> capplet. </para> + </listitem> + <listitem> + <para> + <guilabel>Color</guilabel>: Enables you to choose a + color for the panel background.</para> + </listitem> + <listitem> + <para> + <guilabel>Pixmap</guilabel>: Enables you to choose + an image for the panel background. </para> + </listitem> + </itemizedlist></entry> + </row> + <row> + <entry> + <para> + <guilabel>Color</guilabel></para></entry> + <entry namest="COLSPEC5" nameend="COLSPEC6"> + <para>If + <guilabel>Background Type</guilabel> is + <guilabel> Color</guilabel>, click on the + <guibutton>Color to use</guibutton> button to display + the color selector dialog. Choose the color you require from the color selector + dialog. </para></entry> + </row> + <row> + <entry morerows="4"> + <para> + <guilabel>Image</guilabel></para></entry> + <entry namest="COLSPEC5" nameend="COLSPEC6"> + <para>If + <guilabel>Background Type</guilabel> is + <guilabel>Pixmap</guilabel>, choose the image to use on + the background of the panel. Specify the following settings for the image + background:</para></entry> + </row> + <row> + <entry> + <para> + <guilabel>Don't scale image to + fit</guilabel></para></entry> + <entry> + <para>Select this option to tile the background image to + fit the panel background.</para></entry> + </row> + <row> + <entry> + <para> + <guilabel>Scale image</guilabel></para></entry> + <entry> + <para> Select this option to scale the background image + to fit the panel background. The width-to-height ratio of the image is + retained. </para></entry> + </row> + <row> + <entry> + <para> + <guilabel>Stretch image</guilabel></para></entry> + <entry> + <para> Select this option to stretch the background image + to fit the panel background. The width-to-height ratio of the image is not + retained. </para></entry> + </row> + <row> + <entry> + <para> + <guilabel>Rotate image for vertical panels + </guilabel></para></entry> + <entry> + <para>Select this option to rotate the background image + on a vertical panel.</para></entry> + </row> + </tbody> + </tgroup> + </informaltable> + </listitem> + <listitem> + <para>Click + <guibutton>OK</guibutton> to apply the changes and close the + <guilabel>Panel Properties</guilabel> dialog.</para> + </listitem> + </orderedlist> + </sect3> + <sect3 id="gospanel-61"> + <title>To Drag a Color or Image to the Background of a Panel</title> + <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>Color + Browser</application> application 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 from a file manager to a panel to set the + image as the background of the panel. You can also drag colors and pattern + images from the <application>Nautilus</application> file manager application to + set the background of the panel.</para> + </sect3> + </sect2> + <sect2 id="gospanel-31"> + <title>To Delete a Panel</title> + <para>To delete a panel perform the following steps:</para> + <orderedlist> + <listitem> + <para>Right-click on the panel you want to delete. </para> + </listitem> + <listitem> + <para>Choose + <menuchoice> + <guimenu>Panel</guimenu> + <guimenuitem> Remove this panel</guimenuitem> + </menuchoice> to remove the panel from the desktop. </para> + </listitem> + </orderedlist> + <note> + <para>You must always have at least one panel on your desktop. If you + have only one panel on your desktop, you can not delete that panel.</para> + </note> + </sect2> + </sect1> + <sect1 id="gospanel-8"> + <title>Panel Objects</title> + <indexterm> + <primary>panels</primary> + <secondary>panel objects</secondary> + </indexterm> + <para>You can add the following types of object to a panel: </para> + <itemizedlist> + <listitem> + <para>Launchers</para> + </listitem> + <listitem> + <para>Menus</para> + </listitem> + <listitem> + <para>Applets</para> + </listitem> + <listitem> + <para>Drawers</para> + </listitem> + <listitem> + <para>Special Objects </para> + </listitem> + </itemizedlist> + <para>This section describes the objects that you can use on your panels.</para> + + <sect2 id="gospanel-100"> + <title>Interacting With Panel Objects</title> + <para>You use the mouse buttons to interact with a panel object in the + following ways:</para> + <informaltable frame="topbot"> + <tgroup cols="2" colsep="0" rowsep="0"><colspec colname="COLSPEC0" + colwidth="30.65*"/> + <colspec colname="COLSPEC1" colwidth="69.35*"/> + <tbody> + <row> + <entry colname="COLSPEC0"> + <para>Left-click</para></entry> + <entry colname="COLSPEC1"> + <para> Launches the panel object.</para></entry> + </row> + <row> + <entry> + <para>Middle-click</para></entry> + <entry> + <para>Enables you to grab an object, then drag the object to a + new location.</para></entry> + </row> + <row> + <entry> + <para>Right-click</para></entry> + <entry> + <para>Opens the panel object popup menu.</para></entry> + </row> + </tbody> + </tgroup> + </informaltable> + <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> + <para>You can add an object to a panel in several ways, as follows: + </para> + <itemizedlist> + <listitem> + <para>From the + <guimenu>Global Menu</guimenu></para> + <para>The + <guimenu>Global Menu</guimenu> contains a + <guimenu>Panel</guimenu> menu. The + <guimenu>Panel</guimenu> 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>Launchers</para> + </listitem> + <listitem> + <para>Menus</para> + </listitem> + <listitem> + <para>Applets</para> + </listitem> + <listitem> + <para>Drawers</para> + </listitem> + <listitem> + <para>Special objects</para> + </listitem> + </itemizedlist></para> + </listitem> + <listitem> + <para>From any menu</para> + <para>When you right-click on the title of an item in a menu, the + popup menu for the menu, launcher, or applet opens. You can use this popup menu + to add the menu, launcher, or applet 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 and applet corresponds to a + <filename>.desktop</filename> file. You can drag the + <filename>.desktop</filename> file on to your panels to add the launcher or + applet to the panel. </para> + <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.</para> + </listitem> + </itemizedlist> + </sect2> + <sect2 id="gospanel-9"> + <title>To Modify the Properties of an Object</title> + <para>Some panel objects 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> + <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>Screenshot of panel object popup menu</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> + <para>You can move panel objects within a panel, and from one panel to + another. 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 to open the panel object popup menu. + </para> + </listitem> + <listitem> + <para>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 on your desktop. </para> + </listitem> + </orderedlist> + <para>Movement of a panel object affects the position of other objects on + the panel. The movement behavior of the object is determined by the default + movement mode for the panel. You can specify the default movement mode in the + <application>Panel</application> capplet.</para> + <para>To override the default 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 colwidth="30.00*"/><colspec colname="COLSPEC3" + colwidth="54.00*"/> + <thead> + <row rowsep="1"> + <entry colname="COLSPEC2"> + <para>Key</para></entry> + <entry> + <para> Movement Mode</para></entry> + <entry colname="COLSPEC3"> + <para>Description</para></entry> + </row> + </thead> + <tbody> + <row> + <entry colname="COLSPEC2"> + <para> + <keycap>Alt</keycap> key</para></entry> + <entry> + <para>Free movement</para></entry> + <entry colname="COLSPEC3"> + <para> The object jumps over other panel objects into the next + vacant space on the panel.</para></entry> + </row> + <row> + <entry colname="COLSPEC2"> + <para> + <keycap>Shift</keycap> key </para></entry> + <entry> + <para>Push movement</para></entry> + <entry colname="COLSPEC3"> + <para> The object pushes other panel objects further along the + panel. </para></entry> + </row> + <row> + <entry colname="COLSPEC2"> + <para> + <keycap>Ctrl</keycap> key</para></entry> + <entry> + <para>Switched movement</para></entry> + <entry colname="COLSPEC3"> + <para> The object swaps places with other panel + objects.</para></entry> + </row> + </tbody> + </tgroup> + </informaltable> + </sect2> + <sect2 id="gospanel-33"> + <title>To Remove a Panel Object</title> + <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-16"> + <title>Launchers</title> + <indexterm> + <primary>panels</primary> + <secondary>launchers</secondary> + </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>Start a particular applet.</para> + </listitem> + <listitem> + <para>Open an Internet browser at a particular URL.</para> + </listitem> + </itemizedlist> + <para>You can find launchers in the following places on the desktop:</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 with an + icon.</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> + <para>You can add a launcher to a panel in one of the following + ways:</para> + <itemizedlist> + <listitem> + <para>From the + <guimenu>Global Menu</guimenu></para> + <para>To create a new launcher, right-click on any vacant space on + the panel to open the + <guimenu>Global Menu</guimenu>. Choose + <menuchoice> + <guimenu>Panel</guimenu> + <guisubmenu>Add to panel</guisubmenu> + <guimenuitem>Launcher </guimenuitem> + </menuchoice>. A + <guilabel>Launcher Properties</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>Panel</guimenu> + <guisubmenu>Add to panel</guisubmenu> + <guimenuitem>Launcher from menu</guimenuitem> + </menuchoice>. 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>From the panel where you want the launcher to reside, + open the menu that contains the launcher. Right-click on the title of the + launcher. Choose + <guimenuitem>Add this launcher to panel</guimenuitem>. + </para> + </listitem> + <listitem> + <para>Open a menu that contains the launcher. Drag the launcher + on to the panel. </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 Launcher Properties Dialog</title> + <para>To create a launcher with the + <guilabel>Launcher Properties</guilabel> dialog perform the following + steps: </para> + <orderedlist> + <listitem> + <para>Display the + <guilabel>Launcher Properties</guilabel> dialog. You can display + the + <guilabel>Launcher Properties</guilabel> dialog in one of the + following ways: + <itemizedlist> + <listitem> + <para>To add the launcher to a panel: Right-click on any part + of a panel to open the + <guimenu>Global Menu</guimenu>. Choose + <menuchoice> + <guimenu> Panel</guimenu> + <guisubmenu>Add to panel</guisubmenu> + <guimenuitem> Launcher</guimenuitem> + </menuchoice>. </para> + </listitem> + <listitem> + <para>To add the launcher to a menu: Start the + <application>Menu Editor</application>. In the menu tree, select the menu to + which you want to add the item. Choose + <menuchoice> + <guimenu>File</guimenu> + <guimenuitem> New Item</guimenuitem> + </menuchoice>. The + <guilabel>Launcher Properties</guilabel> dialog is + displayed in the dialog pane.</para> + </listitem> + </itemizedlist></para> + <para>The dialog displays the + <guilabel>Basic</guilabel> tabbed section, as shown in the + following figure:</para> + <screenshot> + <mediaobject> + <imageobject> + <imagedata fileref="figures/launcherprop1_dialog.png" format="PNG"/> + </imageobject> + <textobject> + <phrase>Screenshot of Basic tabbed section on Launcher + Properties dialog</phrase> + </textobject> + </mediaobject> + </screenshot> + </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 + colwidth="26.19*"/><colspec colwidth="73.81*"/> + <thead> + <row rowsep="1"> + <entry> + <para>Dialog Element</para></entry> + <entry> + <para>Description </para></entry> + </row> + </thead> + <tbody> + <row> + <entry> + <para> + <guilabel>Name</guilabel></para></entry> + <entry> + <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> + <para> + <guilabel>Comment</guilabel></para></entry> + <entry> + <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> + <para> + <guilabel>Command</guilabel></para></entry> + <entry> + <para> Use this text box to specify a command to execute + when you click on the launcher. </para> + <para>If the launcher type is + <guilabel>URL</guilabel>, use this text box to specify + a URL to access when you choose the launcher. </para></entry> + </row> + <row> + <entry> + <para> + <guilabel>Type</guilabel></para></entry> + <entry> + <para>Use this drop-down combination box to specify the + type of launcher. Choose from the following: </para> + <itemizedlist> + <listitem> + <para> + <guilabel>Application</guilabel>: Choose this list + item to create a launcher that starts an application.</para> + </listitem> + <listitem> + <para> + <guilabel>PanelApplet</guilabel>: Choose this list + item to create a launcher that starts an applet.</para> + </listitem> + <listitem> + <para> + <guilabel>URL</guilabel>: Choose this list item to + create a launcher that opens an Internet browser at a particular URL.</para> + </listitem> + </itemizedlist></entry> + </row> + <row> + <entry> + <para> + <guilabel>Icon</guilabel></para></entry> + <entry> + <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> + <para> + <guilabel>Run in Terminal</guilabel></para></entry> + <entry> + <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, as shown in the + following figure.</para> + <screenshot> + <mediaobject> + <imageobject> + <imagedata fileref="figures/launcherprop2_dialog.png" format="PNG"/> + </imageobject> + <textobject> + <phrase>Screenshot of Advanced tabbed section on Launcher + Properties dialog</phrase> + </textobject> + </mediaobject> + </screenshot> + </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> + <para>Dialog Element</para></entry> + <entry> + <para>Description </para></entry> + </row> + </thead> + <tbody> + <row> + <entry> + <para> + <guilabel>Try this before + using</guilabel></para></entry> + <entry> + <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> + <para> + <guilabel>Documentation</guilabel></para></entry> + <entry> + <para> This field is not currently in use. + </para></entry> + </row> + </tbody> + </tgroup> + </informaltable> + </listitem> + <listitem> + <para>You can also add a translation of the + <guilabel>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 + colwidth="20.78*"/><colspec colwidth="79.22*"/> + <thead> + <row rowsep="1"> + <entry> + <para>Field</para></entry> + <entry> + <para>Description </para></entry> + </row> + </thead> + <tbody> + <row> + <entry> + <para>First field</para></entry> + <entry> + <para>Enter the two-letter code for the language for + which you want to add a translation.</para></entry> + </row> + <row> + <entry> + <para>Second field</para></entry> + <entry> + <para>Enter the translation of the + <guilabel>Name</guilabel> of the + launcher.</para></entry> + </row> + <row> + <entry> + <para>Third field</para></entry> + <entry> + <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> + </sect2> + <sect2 id="gospanel-36"> + <title>To Modify the Properties of a Launcher</title> + <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>OK</guibutton> to apply the changes you made and close + the + <guilabel>Launcher Properties</guilabel> dialog.</para> + </listitem> + </orderedlist> + </sect2> + </sect1> + <sect1 id="gospanel-37"> + <title>Menus</title> + <indexterm> + <primary>panels</primary> + <secondary>menus</secondary> + </indexterm> + <para>You can add the following types of menu to your panels: </para> + <itemizedlist> + <listitem> + <para> + <guimenu>Global Menu</guimenu>: The + <guimenu>Global Menu</guimenu> is your primary menu. You can access + almost all of the applications, commands, and configuration options on your + desktop from the + <guimenu>Global Menu</guimenu>. You can customize the + <guimenu>Global Menu</guimenu> to help you work more efficiently. You + can modify what menus are displayed on the + <guimenu>Global Menu</guimenu>, and how the menus are displayed on + the + <guimenu>Global Menu </guimenu>. You can add as many + <guimenu>Global Menu</guimenu> objects to your panels as you want. By + default, the + <guimenu>Global 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>Screenshot of Global Menu icon</phrase> + </textobject> + </mediaobject> + </screenshot> + </listitem> + <listitem> + <para> + <guimenu>Main Menu</guimenu>: The + <guimenu>Main Menu</guimenu> provides the same menus and functions as + the + <guimenu>Global Menu</guimenu>. You can add as many + <guimenu>Main Menu</guimenu> objects as you want to your panels. You + can modify the properties of each + <guimenu>Main Menu</guimenu>. On each + <guimenu>Main Menu</guimenu>, you can perform the following actions: + <itemizedlist> + <listitem> + <para>Select what menus are on the + <guimenu>Main Menu</guimenu>. </para> + </listitem> + <listitem> + <para>Specify whether the menus are in a submenu on the + <guimenu> Main Menu</guimenu>.</para> + </listitem> + <listitem> + <para>Choose the icon that represents each + <guimenu>Main Menu</guimenu>. </para> + </listitem> + </itemizedlist>By default, the + <guimenu>Main Menu</guimenu> is represented on panels as a stylized + footprint icon.</para> + </listitem> + <listitem> + <para>System menu: System menus contain the standard applications and + standard applets that you can use on your desktop. The + <guimenu>Programs </guimenu> menu and + <guimenu>Applets</guimenu> menus are system menus.</para> + </listitem> + <listitem> + <para> + <guimenu>Favorites</guimenu> menu: You can use your + <guimenu> Favorites</guimenu> menu to help you work more efficiently. + You can add items that you frequently use to your + <guimenu>Favorites</guimenu> menu, and organize the items into + submenus. You can add items that you frequently use to your + <guimenu> Favorites</guimenu> menu, and organize the items into + submenus.</para> + </listitem> + <listitem> + <para>Custom menu: A custom menu is a menu that you create.</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>Screenshot of typical menu objects on a panel</phrase> + </textobject> + </mediaobject> + </screenshot> + </figure> + <para>For information on adding menus to panels, see + <xref linkend="gospanel-38"/>. For more information on menus, see Working with + Menus.</para> + <sect2 id="gospanel-38"> + <title>To Add a Menu to a Panel</title> + <para>You can add a menu to a panel in the following ways: </para> + <itemizedlist> + <listitem> + <para>From the + <guimenu>Global Menu</guimenu> </para> + <para>Right-click on any vacant space on the panel to open the + <guimenu>Global Menu</guimenu>. Choose + <menuchoice> + <guimenu>Panel</guimenu> + <guisubmenu> Add to panel</guisubmenu> + <guimenuitem>Menu</guimenuitem> + </menuchoice>. Choose the menu that you want to add to the panel. + You can add a + <guimenu> Global Menu</guimenu>, + <guimenu>Main Menu</guimenu>, + <guimenu>Programs</guimenu> menu, or + <guimenu>Favorites</guimenu> menu to the panel. </para> + </listitem> + <listitem> + <para>From any menu</para> + <para>Open the + <guimenu>Global Menu</guimenu> from the panel where you want the + new menu launcher to reside, then perform one of the following steps: + <itemizedlist> + <listitem> + <para>Right-click on the title of the menu, then choose + <guimenuitem> Add this as menu to panel</guimenuitem>. + </para> + </listitem> + <listitem> + <para>Click-and-hold on the menu title and drag the menu to the + panel. Note that you do not need to open the menu from any particular panel + before you drag a menu on to a panel.</para> + </listitem> + </itemizedlist></para> + </listitem> + </itemizedlist> + </sect2> + </sect1> + <sect1 id="gospanel-17"> + <title>Applets</title> + <indexterm> + <primary>panels</primary> + <secondary>applets</secondary> + </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>Tasklist</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>Screen-Shooter</application>: Enables you to take + screenshots of desktop areas.</para> + </listitem> + </itemizedlist> + <screenshot> + <mediaobject> + <imageobject> + <imagedata fileref="figures/sample_applet.png" format="PNG"/> + </imageobject> + <textobject> + <phrase>Screenshot of sample applets</phrase> + </textobject> + </mediaobject> + </screenshot> + <sect2 id="gospanel-40"> + <title>To Add an Applet to a Panel</title> + <para>You can add an applet to a panel in the following ways: </para> + <itemizedlist> + <listitem> + <para>From the + <guimenu>Global Menu</guimenu> </para> + <para>Right-click on any vacant space on the panel to open the + <guimenu>Global Menu</guimenu>. Perform one of the following steps: + <itemizedlist> + <listitem> + <para>Choose + <guimenu>Applets</guimenu>, then choose the applet that you + want to add from the + <guimenu>Applets</guimenu> menu.</para> + </listitem> + <listitem> + <para>Choose + <menuchoice> + <guimenu>Panel</guimenu> + <guisubmenu> Add to panel</guisubmenu> + <guimenuitem>Applet</guimenuitem> + </menuchoice>. Choose the applet that you want to add from + the + <guimenu>Applets</guimenu> menu. </para> + </listitem> + </itemizedlist></para> + </listitem> + <listitem> + <para>From any menu</para> + <para>Perform one of the following steps: + <itemizedlist> + <listitem> + <para>From the panel to which you want to add the applet, open + the menu that contains the applet. Click on the applet to add the applet to the + panel. </para> + </listitem> + <listitem> + <para>Open a menu that contains the applet, then drag the + applet on to the panel. </para> + </listitem> + </itemizedlist></para> + </listitem> + </itemizedlist> + </sect2> + <sect2 id="gospanel-55"> + <title>To Add an Applet as a Launcher to a Panel</title> + <para>You can add an applet to a panel as a launcher. When you add an + applet to a panel as a launcher, a launcher object is added to the panel. When + you click on the launcher for the applet, the user interface for the applet is + added to the panel.</para> + <para>You can add an applet to a panel as a launcher in the following + ways: </para> + <itemizedlist> + <listitem> + <para>From any menu</para> + <para>To add an applet as a launcher to a panel, open the menu that + contains the applet from the panel. Right-click on the title of the applet, + then choose + <guimenuitem> Add this applet as a launcher to + panel</guimenuitem>.</para> + </listitem> + <listitem> + <para>From the file manager</para> + <para>To add an applet as a launcher to a panel from the file + manager, find the <filename>.desktop</filename> file for the applet in your + file system. Drag the <filename>.desktop</filename> file to the panel to add + the applet to the panel. </para> + </listitem> + </itemizedlist> + </sect2> + <sect2 id="gospanel-39"> + <title>To Select an Applet</title> + <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. 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>Tasklist</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>Tasklist</application> applet, you + must right-click on the handle. If you right-click on a button on the right + side, a task menu opens.</para> + </listitem> + <listitem> + <para>Some applets have areas that you cannot use to select the + applet. For example, the <application>Mini-Commander</application> applet has a + field in which you enter commands. You can not 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 the Properties of an Applet</title> + <para>To modify the properties of an applet perform the following steps: + </para> + <orderedlist> + <listitem> + <para>Right-click on the applet to open the panel object popup menu. + </para> + </listitem> + <listitem> + <para>Choose + <guimenuitem>Properties</guimenuitem>. Use the + <guilabel> Properties</guilabel> dialog to modify the properties as + required. The properties for panel applets vary depending on the applet.</para> + </listitem> + <listitem> + <para>Click + <guibutton>OK</guibutton> to apply the changes you made and close + the + <guilabel>Properties</guilabel> dialog.</para> + </listitem> + </orderedlist> + </sect2> + </sect1> + <sect1 id="gospanel-18"> + <title>Drawers</title> + <indexterm> + <primary>panels</primary> + <secondary>drawers</secondary> + </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, special objects, and other + drawers. When you open a drawer, you can use the objects in exactly 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>Screenshot of an open drawer</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 exactly 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> + <para>To open a drawer, click on the drawer object in a panel. You can + close a drawer in the following ways: + <itemizedlist> + <listitem> + <para>Click on the drawer.</para> + </listitem> + <listitem> + <para>Click on the drawer hide button.</para> + </listitem> + </itemizedlist></para> + </sect2> + <sect2 id="gospanel-420"> + <title>To Add a Drawer to a Panel</title> + <para>You can add a drawer to a panel in the following ways: </para> + <itemizedlist> + <listitem> + <para>From the + <guimenu>Global Menu</guimenu></para> + <para>Right-click on any vacant space on the panel to open the + <guimenu>Global Menu</guimenu>. Choose + <menuchoice> + <guimenu>Panel</guimenu> + <guisubmenu> Add to panel</guisubmenu> + <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 the title of the menu, then choose + <guimenuitem>Add this as drawer to panel</guimenuitem>.</para> + </listitem> + </itemizedlist> + </sect2> + <sect2 id="gospanel-54"> + <title>To Add an Object to a Drawer</title> + <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 the Properties of a Drawer</title> + <para>You can choose global preferences for all panels and drawers in the + <application> Panel</application> capplet. 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> + + <sect3 id="gospanel-58"> + <title>To Modify a Drawer With the Panel Properties Menu</title> + <para>You can use the panel properties menu to modify the properties of + a panel. For more information see <xref linkend="gospanel-29"/>.</para> + </sect3> + <sect3 id="gospanel-59"> + <title>To Modify a Drawer With the Panel Properties Dialog</title> + <para>You can use the + <guilabel>Panel Properties</guilabel> dialog to modify the properties + of a drawer. To modify the properties of a panel perform the following steps: + </para> + <orderedlist> + <listitem> + <para>Right-click on the drawer to open the panel object popup + menu. </para> + </listitem> + <listitem> + <para>Choose + <guimenuitem>Properties</guimenuitem> to display the + <guilabel> Panel Properties</guilabel> dialog. The dialog + displays the + <guilabel>Drawer </guilabel> tabbed section, as shown in the + following figure.</para> + <screenshot> + <mediaobject> + <imageobject> + <imagedata fileref="figures/drawerprop_dialog.png" format="PNG"/> + </imageobject> + <textobject> + <phrase>Screenshot of Panel Properties dialog</phrase> + </textobject> + </mediaobject> + </screenshot> + </listitem> + <listitem> + <para>Enter the properties of the drawer in the dialog. The + following table describes the elements on the + <guilabel>Drawer</guilabel> tabbed section: </para> + <informaltable frame="topbot"> + <tgroup cols="2" colsep="0" rowsep="0"><colspec + colname="COLSPEC2" colwidth="29.44*"/> + <colspec colname="COLSPEC3" colwidth="70.56*"/> + <thead> + <row rowsep="1"> + <entry> + <para>Dialog Element</para></entry> + <entry> + <para>Description </para></entry> + </row> + </thead> + <tbody> + <row> + <entry colname="COLSPEC2"> + <para> + <guilabel>Panel size</guilabel></para></entry> + <entry colname="COLSPEC3"> + <para>Select the size of the drawer.</para></entry> + </row> + <row> + <entry colname="COLSPEC2"> + <para> + <guilabel>Panel window level</guilabel></para></entry> + <entry colname="COLSPEC3"> + <para>Select the level or layer at which you want the + drawer to appear. Select from one of the following options:</para> + <itemizedlist> + <listitem> + <para> + <guilabel>Default (from global + preferences)</guilabel>: Select this option to use the default setting that is + specified in the <application> Panel</application> capplet.</para> + </listitem> + <listitem> + <para> + <guilabel>Below other windows</guilabel>: Select + this option if you want the panel to appear below windows.</para> + </listitem> + <listitem> + <para> + <guilabel>Normal</guilabel>: Select this option if + you want the panel to appear at the same level as windows.</para> + </listitem> + <listitem> + <para> + <guilabel>Above other windows</guilabel>: Select + this option if you want the panel to appear above windows.</para> + </listitem> + </itemizedlist></entry> + </row> + <row> + <entry> + <para> + <guilabel>Tooltip/Name</guilabel></para></entry> + <entry> + <para> Use this text box to specify a name for the + drawer. The name appears as a tooltip when you point at the drawer on the + panel.</para></entry> + </row> + <row> + <entry> + <para> + <guilabel>Icon</guilabel></para></entry> + <entry> + <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> + <para> + <guilabel>Enable hide button</guilabel></para></entry> + <entry> + <para> Select this option to display a hide button when + the drawer opens. </para></entry> + </row> + <row> + <entry> + <para> + <guilabel>Enable hide button + arrow</guilabel></para></entry> + <entry> + <para>Select this option to display an arrow on the hide + button if the hide button is enabled.</para></entry> + </row> + </tbody> + </tgroup> + </informaltable> + </listitem> + <listitem> + <para>You can also 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-30"/>.</para> + </listitem> + <listitem> + <para>Click + <guibutton>OK</guibutton> to apply the changes you made and close + the + <guilabel>Panel Properties</guilabel> dialog.</para> + </listitem> + </orderedlist> + </sect3> + <sect3 id="gospanel-60"> + <title>To Drag a Color or Image to the Background of a Drawer</title> + <para>You can 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> + </sect3> + </sect2> + </sect1> + <sect1 id="gospanel-19"> + <title>Special Panel Objects</title> + <indexterm> + <primary>panels</primary> + <secondary>special panel objects</secondary> + </indexterm> + <para>The GNOME Panel includes a number of special panel objects that you + can use to perform special tasks.</para> + <para>You can add special panel objects to your panels from the + <guimenu> Global Menu</guimenu>. To add a special panel object to a panel + perform the following steps: </para> + <orderedlist> + <listitem> + <para>Right-click on any vacant space on the panel to open the + <guimenu> Global Menu</guimenu>.</para> + </listitem> + <listitem> + <para>Choose + <menuchoice> + <guimenu>Panel</guimenu> + <guimenuitem> Add to panel</guimenuitem> + </menuchoice>.</para> + </listitem> + <listitem> + <para>Choose the special panel object to add to the panel. The special + object is added to the panel.</para> + </listitem> + </orderedlist> + <para>This section describes special panel objects.</para> + + <sect2 id="gospanel-20"> + <title>Log Out Button</title> + <screenshot> + <mediaobject> + <imageobject> + <imagedata fileref="figures/logout_icon.png" format="PNG"/> + </imageobject> + <textobject> + <phrase>Screenshot of Log Out icon</phrase> + </textobject> + </mediaobject> + </screenshot> + <para>The + <guibutton>Log Out</guibutton> button begins the process to log out of + a GNOME session. </para> + <para>To log out of your session or shut down your system, click on the + <guibutton> Log Out</guibutton> button. </para> + </sect2> + <sect2 id="gospanel-21"> + <title>Lock Screen Button</title> + <screenshot> + <mediaobject> + <imageobject> + <imagedata fileref="figures/lockscreen_icon.png" format="PNG"/> + </imageobject> + <textobject> + <phrase>Screenshot of Lock Screen icon</phrase> + </textobject> + </mediaobject> + </screenshot> + <para>The + <guibutton>Lock Screen</guibutton> button starts a screensaver that + locks your screen. To access your session again, you must enter your password. + </para> + <para>You can configure your screensaver in the + <application>Screensaver</application> capplet.</para> + <note> + <para>For the + <guibutton>Lock Screen</guibutton> button to work correctly, you must + have a screensaver enabled.</para> + </note> + </sect2> + <sect2 id="gospanel-22"> + <title>Status Dock</title> + <para>A status dock is a panel object that displays status information. + This information is contained in status docklets. A status docklet is a small + window where an application can display status information. The following + figure shows a status dock with a CD player status docklet. The status docklet + indicates that a CD is currently playing.</para> + <screenshot> + <mediaobject> + <imageobject> + <imagedata fileref="figures/statusdock_button.png" format="PNG"/> + </imageobject> + <textobject> + <phrase>Screenshot of status docklet</phrase> + </textobject> + </mediaobject> + </screenshot> + <para>You can also use some status docklets to control applications. In + this respect, status docklets are similar to applets.</para> + <para>You can only have one status dock on your desktop. That is, you can + only have one status dock on one panel. </para> + </sect2> + <sect2 id="gospanel-23"> + <title>Run Button</title> + <screenshot> + <mediaobject> + <imageobject> + <imagedata fileref="figures/runprogram_icon.png" format="PNG"/> + </imageobject> + <textobject> + <phrase>Screenshot of Run icon</phrase> + </textobject> + </mediaobject> + </screenshot> + <para>The + <guibutton>Run</guibutton> button opens the + <guilabel>Run Program </guilabel> dialog.</para> + <para>The + <guilabel>Run Program</guilabel> dialog gives you access to the command + line. You can run a command from the command line. When you run a command in + the + <guilabel>Run Program</guilabel> dialog, you cannot receive output from + the command.</para> + <para>To run a command from the command line perform the following steps: + </para> + <orderedlist> + <listitem> + <para>Display the + <guilabel>Run Program</guilabel> dialog. You can display the + <guilabel>Run Program</guilabel> dialog in any of the following + ways: + <itemizedlist> + <listitem> + <para>From a panel: If the + <guibutton>Run</guibutton> button is present on a panel, + click on the + <guibutton>Run</guibutton> button.</para> + </listitem> + <listitem> + <para>From the + <guimenu>Global Menu</guimenu>: Right-click on any vacant + space on the panel to open the + <guimenu>Global Menu</guimenu>. Choose + <guimenuitem> Run</guimenuitem>. </para> + </listitem> + <listitem> + <para>Use a shortcut key: The default shortcut key to display + the + <guilabel> Run Program</guilabel> dialog is + <keycombo><keycap>Modifier</keycap><keycap>F2</keycap></keycombo>. The default modifier key is the meta + key. You can change the shortcut key that displays the + <guilabel>Run Program</guilabel> dialog in the <application> + Panel</application> capplet.</para> + </listitem> + </itemizedlist></para> + <para>The + <guilabel>Run Program</guilabel> dialog is displayed as follows: + </para> + <screenshot> + <mediaobject> + <imageobject> + <imagedata fileref="figures/runprogram_dialog.png" format="PNG"/> + </imageobject> + <textobject> + <phrase>Screenshot of Run Program dialog</phrase> + </textobject> + </mediaobject> + </screenshot> + </listitem> + <listitem> + <para>Enter the command that you want to run in the blank field. + Alternatively, to choose a command that you ran previously, click the down + arrow button, then choose the command to run.</para> + <para>You can use the + <guibutton>Browse</guibutton> button to choose a command to run. + You can also use the + <guibutton>Browse</guibutton> button to choose a file to append to + the command line. For example, you can enter <application> emacs</application> + on the command line, then choose a file to edit.</para> + <para>Select the + <guilabel>Run in terminal</guilabel> 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> + </listitem> + <listitem> + <para>Click on the + <guibutton>Run</guibutton> button on the + <guilabel> Run Program</guilabel> dialog. </para> + </listitem> + </orderedlist> + </sect2> + <sect2 id="gospanel-24"> + <title>Swallowed Applications</title> + <para>A swallowed application is an application that is not a panel + applet, but runs inside a panel. </para> + <para>Applications must be small enough so that they can fit on the + panel. You can specify to shrink the application to fit into the panel. In most + cases, if the application does not fit in the panel, the panel expands to + accommodate the application. </para> + <para>You must know the title of the application window before you can + add the application as a swallowed application. </para> + <para>The following figure shows a swallowed <application>CD + Player</application> application.</para> + <screenshot> + <mediaobject> + <imageobject> + <imagedata fileref="figures/swallow_applet.png" format="PNG"/> + </imageobject> + <textobject> + <phrase>Screenshot of swallowed application</phrase> + </textobject> + </mediaobject> + </screenshot> + <sect3 id="gospanel-43"> + <title>To Add a Swallowed Application to a Panel</title> + <para>To add a swallowed application to a panel perform the following + steps: </para> + <orderedlist> + <listitem> + <para>Right-click on any part of a panel to open the + <guimenu>Global Menu</guimenu>. </para> + </listitem> + <listitem> + <para>Choose + <menuchoice> + <guimenu>Panel</guimenu> + <guisubmenu> Add to Panel</guisubmenu> + <guimenuitem>Swallowed app</guimenuitem> + </menuchoice> to display the + <guilabel>Create Swallow Applet</guilabel> dialog. The following + figure shows the + <guilabel>Create Swallow Applet</guilabel> dialog.</para> + <screenshot> + <mediaobject> + <imageobject> + <imagedata fileref="figures/swallapp_dialog.png" format="PNG"/> + </imageobject> + <textobject> + <phrase>Screenshot of Create Swallow Applet dialog</phrase> + </textobject> + </mediaobject> + </screenshot> + </listitem> + <listitem> + <para>Enter the properties of the swallowed application in the + dialog. The following table describes the elements on the + <guilabel>Create Swallow Applet</guilabel> dialog:</para> + <informaltable frame="topbot"> + <tgroup cols="2" colsep="0" rowsep="0"><colspec + colwidth="30.30*"/><colspec colwidth="69.70*"/> + <thead> + <row rowsep="1"> + <entry> + <para> Dialog Element </para></entry> + <entry> + <para> Description</para></entry> + </row> + </thead> + <tbody> + <row> + <entry> + <para> + <guilabel>Title of application to + swallow</guilabel></para></entry> + <entry> + <para>Enter the title on the window of the application + window that you want the panel to swallow.</para></entry> + </row> + <row> + <entry> + <para> + <guilabel>Command</guilabel></para></entry> + <entry> + <para> If you leave this field blank, an empty window + appears in the panel. When you start an application whose title matches the + title entered in the + <guilabel> Title of application to swallow</guilabel> + field, the panel swallows the application. </para> + <para>If you enter a command in this field, the command + executes before the panel attempts to swallow the application. The command also + executes when GNOME starts and displays the panel on your desktop. You can use + this feature to start an application that you want the panel to + swallow.</para></entry> + </row> + <row> + <entry> + <para> + <guilabel>Width</guilabel></para></entry> + <entry> + <para>Specify the width of the swallowed application + window in the panel, in pixels. </para></entry> + </row> + <row> + <entry> + <para> + <guilabel>Height</guilabel></para></entry> + <entry> + <para> Specify the height of the swallowed application + window in the panel, in pixels. </para></entry> + </row> + </tbody> + </tgroup> + </informaltable> + </listitem> + <listitem> + <para>Click + <guibutton>OK</guibutton> to add the swallowed application to the + panel. </para> + </listitem> + </orderedlist> + </sect3> + </sect2> + </sect1> +</chapter>
\ No newline at end of file |