<HTML
><HEAD
><TITLE
>Special Panel Objects</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.54"><LINK
REL="HOME"
TITLE="The GNOME Panel"
HREF="index.html"><LINK
REL="PREVIOUS"
TITLE="Drawers"
HREF="drawers.html"><LINK
REL="NEXT"
TITLE="Adding, Moving, and Removing Panel Objects"
HREF="appletadd.html"></HEAD
><BODY
CLASS="SECT1"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>The GNOME Panel</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="drawers.html"
>&#60;&#60;&#60; Previous</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="appletadd.html"
>Next &#62;&#62;&#62;</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="SECT1"
><H1
CLASS="SECT1"
><A
NAME="SPECIALOBJECTS"
>Special Panel Objects</A
></H1
><P
>   There are several special Panel objects which are not considered
   menus, applets, or launchers.  These special objects are described
   below.
  </P
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="LOCKBUTTON"
>The Lock Button</A
></H2
><DIV
CLASS="FIGURE"
><P
><IMG
SRC="./figures/panel_lockbut.png"></P
><P
><B
>Figure 12. The Lock Button</B
></P
></DIV
><P
>    The <B
CLASS="GUIBUTTON"
>Lock Button</B
> is a
    <SPAN
CLASS="INTERFACE"
>Panel</SPAN
> button which starts a screensaver
    which locks the screen. In order to remove the screensaver and
    access the GNOME session again, you must supply your password.
    For more information on locking the screen, see <A
HREF="panelbasics.html#LOCKSCREEN"
>the section called <I
>Locking the Screen</I
></A
>.
   </P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="LOGOUTBUTTON"
>The Logout Button</A
></H2
><DIV
CLASS="FIGURE"
><A
NAME="LOGOUTBUTTONFIG"
></A
><P
><IMG
SRC="./figures/panel_logoutbut.png"></P
><P
><B
>Figure 13. The Logout Button</B
></P
></DIV
><P
>    The <B
CLASS="GUIBUTTON"
>Logout</B
> button is used to exit the GNOME
    desktop environment.  It initiates the logout sequence, bringing
    up the <SPAN
CLASS="INTERFACE"
>Logout Dialog</SPAN
>, as described in <A
HREF="panelbasics.html#LOGGINGOUT"
>the section called <I
>Logging Out</I
></A
>.
   </P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="RUNBUTTON"
>The Run Button</A
></H2
><DIV
CLASS="FIGURE"
><A
NAME="RUNBUTTONFIG"
></A
><P
><IMG
SRC="./figures/panel_runbutton.png"></P
><P
><B
>Figure 14. The Run Button</B
></P
></DIV
><P
>    The <B
CLASS="GUIBUTTON"
>Run</B
> button opens the <SPAN
CLASS="INTERFACE"
>Run
    Program</SPAN
> dialog, shown in <A
HREF="specialobjects.html#RUNPROGRAMDIALOG-FIG"
>Figure 15</A
>.  This gives you access to the
    command line prompt. It is not a full-blown shell, so it is not a
    replacement for <TT
CLASS="APPLICATION"
>GNOME terminal</TT
>, but it
    is very convenient when you need to enter just one command
    quickly. You can also open the <SPAN
CLASS="INTERFACE"
>Run Program</SPAN
>
    dialog by using a  keyboard shortcut. The default keyboard
    shortcut is
    <B
CLASS="KEYCAP"
>Alt</B
>+<B
CLASS="KEYCAP"
>F2</B
>
    but you can change this in the <A
HREF="globalpanelprefs.html#MISCTAB"
><TT
CLASS="GUILABEL"
><B
>Miscellaneous</B
></TT
></A
> tab of
    the <SPAN
CLASS="INTERFACE"
><A
HREF="globalpanelprefs.html"
>Global Panel
    Preferences</A
> dialog</SPAN
>.
   </P
><DIV
CLASS="FIGURE"
><A
NAME="RUNPROGRAMDIALOG-FIG"
></A
><P
><IMG
SRC="./figures/panel_runprogram.png"></P
><P
><B
>Figure 15. The Run Program Dialog</B
></P
></DIV
><P
>    The command entry has a history buffer which allows you to execute
    a previously entered command by pressing the <B
CLASS="GUIICON"
>down
    arrow</B
> icon located to the right of the text field and
    selecting the command. It also has a
    <B
CLASS="GUIBUTTON"
>Browse&#8230;</B
> button, which allows you to
    choose a file &#8212; this filename will be appended to the end of
    your command. For example, you can enter
    <TT
CLASS="USERINPUT"
><B
>emacs</B
></TT
> (an extremely powerful text editor)
    on the command line and then use the
    <B
CLASS="GUIBUTTON"
>Browse&#8230;</B
> button to select the file to
    be edited.
   </P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="SWALLOWEDAPPS"
>Swallowed Applications</A
></H2
><P
>    You can run many applications which are not applets inside the
    <SPAN
CLASS="INTERFACE"
>Panel</SPAN
> as if they were applets.
    Applications which you pull into the <SPAN
CLASS="INTERFACE"
>Panel</SPAN
>,
    even though they are not GNOME applets, are called "swallowed
    applications".  Applications do not have to be GNOME-compliant to
    be swallowed.  In general, the only constraints for swallowing an
    application are that the application must be small enough to fit
    in your <SPAN
CLASS="INTERFACE"
>Panel</SPAN
> and you must know the  title
    of the window you would like to swallow.  In many cases, the
    application can be automatically shrank to fit in the
    <SPAN
CLASS="INTERFACE"
>Panel</SPAN
>,  as specified in the
    <SPAN
CLASS="INTERFACE"
>Create Swallowed Application Dialog</SPAN
>.  If
    the application is not small enough to fit in the
    <SPAN
CLASS="INTERFACE"
>Panel</SPAN
>, the <SPAN
CLASS="INTERFACE"
>Panel</SPAN
>
    will generally grow to allow the application to fit.
   </P
><DIV
CLASS="FIGURE"
><A
NAME="SWALLAPPFIG"
></A
><P
><IMG
SRC="./figures/panel_swallow.png"></P
><P
><B
>Figure 16. Create Swallowed Application Dialog</B
></P
></DIV
><P
>    The <TT
CLASS="GUILABEL"
><B
>Title of application to swallow</B
></TT
> is the
    window title, typically displayed on the top left edge of the
    window. (Note that the window title is case sensitive.) The
    <TT
CLASS="GUILABEL"
><B
>Width</B
></TT
> and <TT
CLASS="GUILABEL"
><B
>Height</B
></TT
>
    determine the size of the swallowed application in the
    <SPAN
CLASS="INTERFACE"
>Panel</SPAN
> in pixels.
   </P
><P
>    If you leave the <TT
CLASS="GUILABEL"
><B
>Command</B
></TT
> field empty, this
    dialog will create an empty window of given size on the panel
    which will sit there waiting for a window with the given title to
    appear on your desktop. As soon such a window appears (for
    example, when you choose appropriate item in the menu), it will be
    swallowed.
   </P
><P
>    You can also enter any command in the <TT
CLASS="GUILABEL"
><B
>Command</B
></TT
>
    field; this command will be executed before trying to swallowing
    the window to the <SPAN
CLASS="INTERFACE"
>Panel</SPAN
> (and  each time the
    <SPAN
CLASS="INTERFACE"
>Panel</SPAN
> is restarted afterwards). This is
    normally used to start an application which you want the
    <SPAN
CLASS="INTERFACE"
>Panel</SPAN
> to swallow.
   </P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="STATUSDOCK"
>Status Dock</A
></H2
><P
>    The <SPAN
CLASS="INTERFACE"
>status dock</SPAN
> is a
    <SPAN
CLASS="INTERFACE"
>Panel</SPAN
> object which can hold status docklets
    &#8212; small windows which applications place in the
    <SPAN
CLASS="INTERFACE"
>status dock</SPAN
> to provide status information.
    Status docklets can also be used to control the
    application. Essentially, docklets are small (both in size and in
    complexity) applets.   GNOME currently does not have many
    applications which place status docklets in the <SPAN
CLASS="INTERFACE"
>status
    dock</SPAN
>.  However, GNOME's <SPAN
CLASS="INTERFACE"
>status
    dock</SPAN
> is compatible with that of the K Desktop
    Environment (KDE), so KDE applications, such as
    <TT
CLASS="APPLICATION"
>kscd</TT
>, may place status docklets in
    GNOME's <SPAN
CLASS="INTERFACE"
>status dock</SPAN
>.  Future versions of
    GNOME applications will make use of this recently added
    <SPAN
CLASS="INTERFACE"
>Panel</SPAN
> object.
   </P
><DIV
CLASS="FIGURE"
><A
NAME="STATUSDOCKFIG"
></A
><P
><IMG
SRC="./figures/status_dock.png"></P
><P
><B
>Figure 17. Example Status Dock With Docklet</B
></P
></DIV
><P
>    The above example shows the <SPAN
CLASS="INTERFACE"
>status dock</SPAN
>
    with a status docklet from  the <TT
CLASS="APPLICATION"
>kscd</TT
> CD
    player program.  This particular docklet is used to open and close
    the main <TT
CLASS="APPLICATION"
>kscd</TT
> window without ending the
    program.
   </P
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="drawers.html"
>&#60;&#60;&#60; Previous</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="appletadd.html"
>Next &#62;&#62;&#62;</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>Drawers</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
>&nbsp;</TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Adding, Moving, and Removing Panel Objects</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>