doc/docbook/GuideReferenceToolbar.xml

   1 <?xml version="1.0" encoding="utf-8"?>
   2 <section id="GuideReferenceToolbar">
   3     <title>
   4       Toolbar
   5     </title>
   6     <para/><section id="AddingIconsToToolbar"><title>How to set up new toolbar icons
   7     </title>
   8     <para>This section describes how to put additional icons on the toolbar.<para/>The functions these icons may initiate are as described in <link linkend="GuideImageManagementExternalEditing">External Editors</link>.
   9     </para>
  10     <para>
  11       Edit the toolbar section of the file geeqierc.xml to include a reference to the new icon:</para>
  12     <para><programlisting>
  13     &lt;toolitem action = "new_icon_1.desktop" /&gt;
  14     </programlisting></para><para>
  15       Create a corresponding desktop file as described in <link linkend="GuideImageManagementExternalEditing">External Editors</link>.
  16     </para>
  17     <para/>
  18     <para>Within the desktop file it is recommended that two additional items are included:</para>
  19     <para><programlisting>Icon=new_icon_1.png</programlisting></para>
  20     <para>The icon displayed. If an icon is not defined, it is likely that the display of the entire toolbar will be distorted by additional text.</para>
  21     <para><programlisting>Comment=descriptive text</programlisting></para>
  22     <para>The tooltip text displayed when the mouse is hovered over the icon.</para>
  23     </section>
  24 </section>