<HTML
><HEAD
><TITLE
>Special Panel Objects</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.54"><LINK
REL="HOME"
TITLE="GNOME User's Guide"
HREF="index.html"><LINK
REL="UP"
TITLE="Panel"
HREF="panel-chap.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"
>GNOME User's Guide</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"
>Panel</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="./figs/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  begins 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="./figs/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="./figs/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 Alt-F2, but you
	  can change this in the <A
HREF="globalpanelprefs.html#MISCTAB"
><TT
CLASS="GUILABEL"
><B
>Miscellaneous</B
></TT
></A
> tab of
	  <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="./figs/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
>	The GNOME <SPAN
CLASS="INTERFACE"
>Panel</SPAN
> allows you to run 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 panel 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
>.
      </P
><DIV
CLASS="FIGURE"
><A
NAME="SWALLAPPFIG"
></A
><P
><IMG
SRC="./figs/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 width
	and height determine the size of the swallowed application in the
	panel 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 adding the swallowing window
	to the <SPAN
CLASS="INTERFACE"
>Panel</SPAN
> (and each time the panel 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 Status Dock 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="./figs/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"
><A
HREF="panel-chap.html"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Adding, Moving, and Removing Panel Objects</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>