<HTML
><HEAD
><TITLE
>Launchers</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="Menus"
HREF="menus.html"><LINK
REL="NEXT"
TITLE="Applets"
HREF="applets.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="menus.html"
>&#60;&#60;&#60; Previous</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="applets.html"
>Next &#62;&#62;&#62;</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="SECT1"
><H1
CLASS="SECT1"
><A
NAME="LAUNCHERS"
>Launchers</A
></H1
><P
>   Launchers are buttons which reside in your
   <SPAN
CLASS="INTERFACE"
>Panel</SPAN
> and start an application or execute a
   command when clicked.  A launcher can use any icon and has a
   customized tooltip to display a message when the cursor is passed
   over the launcher.
  </P
><P
>   You can change a launcher's properties, such as the icon it uses
   and its name, by right-clicking on the launcher and selecting
   <B
CLASS="GUIMENUITEM"
>Properties...</B
> from the pop-up menu. This
   brings up the <SPAN
CLASS="INTERFACE"
>Launcher properties</SPAN
> dialog,
   shown in <A
HREF="launchers.html#LAUNCHERPROPSFIG"
>Figure 7</A
>. A similar dialog is
   used when you create a new launcher (see <A
HREF="appletadd.html#ADD"
>the section called <I
>Adding objects to the panel</I
></A
>). Note that internally GNOME makes no distinction
   between menu items and launchers: these are just different
   representations of the same thing. You can place any menu item on a
   <SPAN
CLASS="INTERFACE"
>Panel</SPAN
>, and it will appear as a
   launcher. Therefore, all the information below applies equally to
   launchers and menu items.
  </P
><DIV
CLASS="FIGURE"
><A
NAME="LAUNCHERPROPSFIG"
></A
><P
><IMG
SRC="./figures/launcher_properties_basic.png"></P
><P
><B
>Figure 7. Create Launcher/Launcher Properties Dialog</B
></P
></DIV
><P
>   The <SPAN
CLASS="INTERFACE"
>Laucher Properties</SPAN
> dialog has two tabs:
   <TT
CLASS="GUILABEL"
><B
>Basic</B
></TT
> and <TT
CLASS="GUILABEL"
><B
>Advanced</B
></TT
>. In
   the <TT
CLASS="GUILABEL"
><B
>Basic</B
></TT
> tab, you can set:
  </P
><P
></P
><UL
><LI
><P
>	  <TT
CLASS="GUILABEL"
><B
>Name</B
></TT
> &#8212; this is the application
	  name, for example, <TT
CLASS="USERINPUT"
><B
>GNOME
	  terminal</B
></TT
>. This name will be used if you later
	  put this launcher in a menu.
	</P
></LI
><LI
><P
>	  <TT
CLASS="GUILABEL"
><B
>Comment</B
></TT
> &#8212; this is a brief
	  explanation of what this application does, for example,
	  <TT
CLASS="USERINPUT"
><B
>Terminal emulation program</B
></TT
>. This will
	  be used for tooltips.
	</P
></LI
><LI
><P
>	  <TT
CLASS="GUILABEL"
><B
>Command</B
></TT
> &#8212; the actual command that
	  runs the application, for example,
	  <TT
CLASS="USERINPUT"
><B
>gnome-terminal</B
></TT
>.
	</P
></LI
><LI
><P
>	  <TT
CLASS="GUILABEL"
><B
>Type</B
></TT
> &#8212; should be
	  <TT
CLASS="GUILABEL"
><B
>Application</B
></TT
>; do not change it unless
	  you want to create something other than an application
	  launcher.
	</P
></LI
><LI
><P
>	  <TT
CLASS="GUILABEL"
><B
>Icon</B
></TT
> &#8212; this is the icon which
	  will be used to represent the launcher in the
	  <SPAN
CLASS="INTERFACE"
>Panel</SPAN
>. If no icon is specified, a
	  default icon will be used. To change the icon, just click on
	  it to launch the icon browser.
	</P
></LI
><LI
><P
>	  <TT
CLASS="GUILABEL"
><B
>Run in Terminal</B
></TT
> &#8212; this specifies
	  whether the application should be run inside a terminal.  If
	  the application doesn't create any windows on its own, check
	  this button. If you are unsure, leave it unchecked.
	</P
></LI
></UL
><P
>      The <TT
CLASS="GUILABEL"
><B
>Advanced</B
></TT
> properties tab is shown
      below. It is intended for advanced users; most of the time, you
      will not need to change any of these settings.
    </P
><DIV
CLASS="FIGURE"
><A
NAME="LAUNCHERADVPROPSFIG"
></A
><P
><IMG
SRC="./figures/launcher_properties_advanced.png"></P
><P
><B
>Figure 8. Launcher Advanced Properties Dialog</B
></P
></DIV
><P
>     In the <TT
CLASS="GUILABEL"
><B
>Advanced</B
></TT
> tab, you can set:
    </P
><P
></P
><UL
><LI
><P
>	  <TT
CLASS="GUILABEL"
><B
>Try this before using</B
></TT
> &#8212; you can
	  enter a command here, and GNOME will check if this command
	  can be executed. If the command cannot be successfully
	  executed, the launcher (or menu item) will not be shown even
	  if you added it to a <SPAN
CLASS="INTERFACE"
>Panel</SPAN
> or
	  menu. It is mostly used by people preparing GNOME
	  distributions. For example, the default GNOME <B
CLASS="GUIMENU"
>Main
	  Menu</B
> contains an item for the
	  <TT
CLASS="APPLICATION"
>TkRat</TT
> e-mail program, but you
	  will only see this item if you have
	  <TT
CLASS="APPLICATION"
>TkRat</TT
> installed on your system.
	</P
></LI
><LI
><P
>	  <TT
CLASS="GUILABEL"
><B
>Documentation</B
></TT
> &#8212; currently not
	  used.
	</P
></LI
><LI
><P
>	  <TT
CLASS="GUILABEL"
><B
>Name/Comment translations</B
></TT
> &#8212; here
	  you can set translations of the <TT
CLASS="GUILABEL"
><B
>Name</B
></TT
>
	  and <TT
CLASS="GUILABEL"
><B
>Comment</B
></TT
> to other languages. For
	  example, for <TT
CLASS="APPLICATION"
>GNOME Terminal</TT
>, the
	  translations to Spanish (es) are name:  <TT
CLASS="USERINPUT"
><B
>Terminal
	  UNIX de GNOME</B
></TT
> and comment: <TT
CLASS="USERINPUT"
><B
>Emulador
	  de terminal GNOME</B
></TT
>. This means that if a user
	  sets his language to Spanish during login (this can be done
	  by selecting the desired language from
	  <B
CLASS="GUIMENU"
>Languages</B
> menu of the <TT
CLASS="APPLICATION"
>GNOME
	  Display Manager</TT
> when logging in) he will see
	  <B
CLASS="GUIMENUITEM"
>Terminal UNIX de  GNOME</B
> in the
	  menu and <TT
CLASS="GUILABEL"
><B
>Emulador de terminal GNOME</B
></TT
> as
	  the tooltip. The actual command that runs the terminal is
	  unchanged.
	</P
><P
>	  To add a new translation, enter the language 2-letter code
	  and translations of <TT
CLASS="GUILABEL"
><B
>Name</B
></TT
> and
	  <TT
CLASS="GUILABEL"
><B
>Comment</B
></TT
> fields in the empty fields
	  under the list of current translations, and press the
	  <B
CLASS="GUIBUTTON"
>Add/Set</B
> button.  To change one of
	  existing translations, select the row from the list, edit
	  the fields you want to change, and press the
	  <B
CLASS="GUIBUTTON"
>Add/Set</B
> button. To remove one of
	  existing translations, select it in the list and press the
	  <B
CLASS="GUIBUTTON"
>Remove</B
> button.
	</P
><P
>          You can find the list of all languages supported by GNOME
	  along with their 2-letter codes  in  <A
HREF="http://www.gnome.org/gnomefaq/html/x867.html"
TARGET="_top"
>GNOME
	  Frequently Asked Questions</A
>.
	</P
></LI
></UL
><P
>      All of the changes you make in the <SPAN
CLASS="INTERFACE"
>Launcher
      Properties</SPAN
> dialog will take effect when you press
      <B
CLASS="GUIBUTTON"
>Apply</B
> or
      <B
CLASS="GUIBUTTON"
>OK</B
>. Pressing <B
CLASS="GUIBUTTON"
>OK</B
>
      closes the dialog; pressing <B
CLASS="GUIBUTTON"
>Apply</B
> will
      allow you to continue editing.
    </P
></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="menus.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="applets.html"
>Next &#62;&#62;&#62;</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>Menus</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
>&nbsp;</TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Applets</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>