<HTML
><HEAD
><TITLE
>Launchers</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="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"
>GNOME User's Guide</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"
>Panel</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 essentially buttons which reside in your panel 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 properties, such as the icon it uses and
      its name, by right-clicking on a launcher and selecting
      <B
CLASS="GUIMENUITEM"
>Properties</B
> from the pop-up menu. This brings up
      the <SPAN
CLASS="INTERFACE"
>Launcher properties dialog</SPAN
> shown in <A
HREF="launchers.html#LAUNCHERPROPSFIG"
>Figure 7</A
>. The same 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
>). Also, internally GNOME makes no
      distinction between menu items and launchers: these are just different
      presentations of the same thing. You can place any menu item on the panel,
      and it will show 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="./figs/launcher_properties_basic.png"></P
><P
><B
>Figure 7. Create Launcher/Launcher Properties Dialog</B
></P
></DIV
><P
> 
      This 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 application launcher.
	</P
></LI
></UL
><P
>      The <TT
CLASS="GUILABEL"
><B
>Basic</B
></TT
> tab also shows the icon to be used for the
      launcher; 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
><P
>      Finally, if the application can only run inside a terminal &#8212; that
      is, if it doesn't create any windows on its own &#8212; you should also
      check <B
CLASS="GUIBUTTON"
>Run in terminal</B
> button. If unsure, leave it
      unchecked.
    </P
><P
>      <TT
CLASS="GUILABEL"
><B
>Advanced</B
></TT
> tab is shown below. It is intended for
      advanced users; most of the time, you do not need to change any of the
      settings here.
    </P
><DIV
CLASS="FIGURE"
><A
NAME="LAUNCHERADVPROPSFIG"
></A
><P
><IMG
SRC="./figs/launcher_properties_advanced.png"></P
><P
><B
>Figure 8. Launcher Advanced Properties Dialog</B
></P
></DIV
><P
> 
      In this tab, you can set:
    </P
><P
></P
><UL
><LI
><P
>	  <TT
CLASS="GUILABEL"
><B
>Try this before using</B
></TT
> &#8212; you can enter here
	  a command, and GNOME will check if this command can be executed. If
	  not, the launcher (or menu item) will not be shown even if you added
	  it to the panel or menu. It is mostly used by people preparing GNOME
	  distributions: for example, default GNOME <B
CLASS="GUIMENU"
>Main Menu</B
>
	  contains an item for <TT
CLASS="APPLICATION"
>TkRat</TT
> e-mail program,
	  but you will not see it unless 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 translation 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 (it can be
	  done by selecting appropriate language from
	  <B
CLASS="GUIMENU"
>Languages</B
> menu of GNOME login manager (GDM)), he
	  will see <B
CLASS="GUIMENUITEM"
>Terminal UNIX de GNOME</B
> in the menu
	  and <TT
CLASS="USERINPUT"
><B
>Emulador de terminal GNOME</B
></TT
> in the
	  tooltips. Of course, 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 <B
CLASS="GUIBUTTON"
>Add/Set</B
>
	  button.  To change one of existing translations, select it in the
	  list, edit the fields you want, and press
	  <B
CLASS="GUIBUTTON"
>Add/Set</B
> button. To remove one of existing
	  translations, select it and press <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 the changes you made in <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 this
      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"
><A
HREF="panel-chap.html"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Applets</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>