<sect1 id="toolbars-start">
    <title>The Gnumeric Toolbars</title>
    
    <para>The toolbars contain many icons representative of some the more common
      operations a user may need to use. It is intended to provide fast access to these
      tools. Almost all of these functions is also available through the menu
	  system.
	  </para>
   
	<para><application>Gnumeric</application> has three toolbars, the standard toolbar, the format toolbar
	and the object toolbar. The three toolbars are shown in 
	<xRef linkend="toolbars.png">.
	</para>

    <figure id="toolbars.png">
     <title>The Three Gnumeric Toolbars</title>
     <screenshot>
      <graphic fileref="figures/toolbars.png" format="png" srccredit="The GNOME project">
      </graphic>
     </screenshot>
    </figure>
 	<para> These toolbars will be discussed separately in the subsequent
	sections of this manual. User interaction with each toolbar happens in
	essentially the same way. Similarly, the toobars can be configured in the same
	way. The next section explains the standard behavior of <application>Gnumeric</application> toolbars.</para>



	<sect2 id="toolbar-use">
		<title>General Toolbar Behavior</title>

		<para>In the same way that menus can be moved around, as was explained 
		<xref linkend="menu-bars">, toolbars can be moved around the <application>Gnumeric</application>
		window by dragging the little tag on the leftmost portion of the
		toolbar. 
		</para>
		<para>
		If the <application>Gnumeric</application> window is too small to fit all of the toolbar buttons,
		gnumeric may display a little right pointing black arrow to indicate
		that there are more options. If the user clicks on this arrow, a window
		will open with the remaining buttons.
		</para>
		<para>
		Certain toolbar options, such as the zoom box, are combinations of a
		button or text entry area and a downward pointing arrow. If the user
		clicks on the arrow, a list of avaliable options appears. It is also
		posible to "tear off" these options into a separate window in the same
		way as was explained for menus in <xref linkend="Menus-General">.
		</para>
		<para>
		The toolbars can be configured by a context-menu which opens when the
		user clicks with a particular mouse button on an empty part of the
		toolbars or on the toolbar handle. This menu is explained in 
		<xref linkend="menu-context-toolbars">.
		</para>

	</sect2>
</sect1>






<!-- ************************* THE STANDARD TOOLBAR ************** -->
<sect1 id="std-toolbar">
	<title>The Standard Toolbar</title>

	<para>The standard toolbar is shown in <xRef linkend="toolbar-standard.png">.</para>

    <figure id="toolbar-standard.png">
     <title>The <interface>Standard Toolbar</interface>.</title>
     <screenshot>
      <graphic fileref="figures/toolbar-standard.png" format="png" srccredit="The GNOME project">
      </graphic>
     </screenshot>
    </figure>
 	<para> The <interface>Standard Toolbar</interface> gives the user access to
file operations, printing, movement of data blocks, the undo system, and to
some of the powerful tools like the function creator and the graphing
system.</para>




	<!-- The list of standard toolbar objects. -->
    <variablelist>
      <varlistentry>
	<term>
	  <guiicon><inlinegraphic fileref="figures/button-new.png"></inlinegraphic>
	    New File
	  </guiicon>
	</term>
	<listitem>
	  <para>Create a new file.</para>
	</listitem>
      </varlistentry>
      
      <varlistentry>
	<term>
	  <guiicon><inlinegraphic fileref="figures/button-open.png"></inlinegraphic>
	    Open
	  </guiicon>
	</term>
	<listitem>
	  <para>Open an existing file.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>
	  <guiicon><inlinegraphic fileref="figures/button-save.png"></inlinegraphic>
	    Save
	  </guiicon>
	</term>
	<listitem>
	  <para>Save the current worksheet to disk.</para>
	</listitem>
      </varlistentry>

       <varlistentry>
	<term>
	  <guiicon><inlinegraphic fileref="figures/button-print.png"></inlinegraphic>
          Print
	  </guiicon>
	</term>
	<listitem>
	  <para>Print the current worksheet to a file or a printer.</para>
	</listitem>
      </varlistentry>
     
       <varlistentry>
	<term>
	  <guiicon><inlinegraphic fileref="figures/button-preview.png"></inlinegraphic>
          Print Setup
	  </guiicon>
	</term>
	<listitem>
	  <para>Display a print preview of the current worksheet.</para>
	</listitem>
      </varlistentry>
     
      <varlistentry>
	<term>
	  <guiicon><inlinegraphic fileref="figures/button-cut.png"></inlinegraphic>
	    Cut
	  </guiicon>
	</term>
	<listitem>
	  <para>Copy the cells in the current selection to the clipboard buffer and mark them to 
	  be deleted from the current position. The cells will only be removed if
	  they are pasted into a new position.</para>
	</listitem>
      </varlistentry>

      
      <varlistentry>
	<term>
	  <guiicon><inlinegraphic fileref="figures/button-copy.png"></inlinegraphic>
	    Copy
	  </guiicon>
	</term>
	<listitem>
	  <para>Copy the cells in the current selection to the clipboard buffer.</para>
	</listitem>
      </varlistentry>

      
      <varlistentry>
	<term>
	  <guiicon><inlinegraphic fileref="figures/button-paste.png"></inlinegraphic>
	    Paste
	  </guiicon>
	</term>
	<listitem>
	  <para>Paste the contents of the clipboard buffer into the active cell.</para>
	</listitem>
      </varlistentry>

       <varlistentry>
	<term>
	  <guiicon><inlinegraphic fileref="figures/button-undo-and-history.png"></inlinegraphic>
	   Undo 
	  </guiicon>
	</term>
	<listitem>
		<para>
			Undoes the last operation undertaken.
		</para>
	</listitem>
      </varlistentry>

        <varlistentry>
	<term>
	  <guiicon><inlinegraphic fileref="figures/button-redo-and-history.png"></inlinegraphic>
	   Redo 
	  </guiicon>
	</term>
	<listitem>
	  <para>This is the reverse of the undo operation, restoring its orginal state.</para>
	</listitem>
      </varlistentry>

     <varlistentry>
	<term>
	  <guiicon><inlinegraphic fileref="figures/button-sum.png"></inlinegraphic>
	   Sum into the current cell 
	  </guiicon>
	</term>
	<listitem>
	  <para>Starts a simple sum formula in the selected cell with <application>Gnumeric</application>
	  simply waiting for a selection to be made to complete the sum. The user
	  selects the destination cell, pushes this button, enters the range to be
	  summed and pushes the confirm button (green arrow) in the data entry area
	  or types the <keycap>Return</keycap> key.
	  </para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>
	  <guiicon><inlinegraphic fileref="figures/button-fx.png"></inlinegraphic>
	   The function guru
	  </guiicon>
	</term>
	<listitem>
	  <para>This button will start a formula in the current cell using the
	  function guru.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>
	  <guiicon><inlinegraphic fileref="figures/button-sort-az.png"></inlinegraphic>
	   Sort Ascending 
	  </guiicon>
	</term>
	<listitem>
	  <para>Sorts the selected region in ascending order based on the 
          first column selected.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>
	  <guiicon><inlinegraphic fileref="figures/button-sort-za.png"></inlinegraphic>
	    Sort Descending
	  </guiicon>
	</term>
	<listitem>
	  <para>Sorts the selected region in descending order based on the 
          first column selected.</para>
	</listitem>
      </varlistentry>


      <varlistentry>
	<term>
	  <guiicon><inlinegraphic fileref="figures/button-graph.png"></inlinegraphic>
	   Graph
	  </guiicon>
	</term>
	<listitem>
	  <para>This button calls the graph guru to create a graph.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>
	  <guiicon><inlinegraphic fileref="figures/button-insert-object.png"></inlinegraphic>
	    Insert Object
		</guiicon>
	</term>
	<listitem>
	  <para>This button will insert a component object into the
	  current worksheet. Components are the way that the GNOME
	  project has chosen to enable certain programs to use others
	  within themselves. <application>Gnumeric</application> is
	  able to use the <application>Guppi</application> plotting
	  program and the <application>Dia</application> diagramming
	  program in this way.</para>
	</listitem>
      </varlistentry>


      <varlistentry>
	<term>
	  <guiicon><inlinegraphic fileref="figures/button-insert-component.png"></inlinegraphic>
	   Insert Shaped Component
	  </guiicon>
	</term>
	<listitem>
	  <para>This button allows user to insert a component into <application>Gnumeric</application> that is
	  not a simple rectangle but may have an arbitrary shape. This
	  functionality is currently not used but provided for future needs.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>
	  <guiicon><inlinegraphic fileref="figures/button-zoom.png"></inlinegraphic>
	    Zoom
		</guiicon>
	</term>
	<listitem>
	  <para>The zoom button allows the users to tradeoff the extent of the
	  worksheet which is visible against the size of the visible text and cells.
	  </para>
	</listitem>
      </varlistentry>


    </variablelist>
</sect1>





<!-- ************************* THE FORMAT TOOLBAR ************** -->
<sect1 id="fmt-toolbar">
	<title>The Format Toolbar</title>

	<para> The <interface>Format Toolbar</interface> ...</para>

	<figure id="toolbar-format.png">
     <title>The <interface>Format Toolbar</interface></title>
     <screenshot>
      <graphic fileref="figures/toolbar-format.png" format="png" srccredit="The GNOME project">
      </graphic>
     </screenshot>
    </figure>

 	<para> The <interface>Format Toolbar</interface>. </para>



    <variablelist>

      <varlistentry>
	<term>
	  <guiicon><inlinegraphic fileref="figures/button-font-type.png"></inlinegraphic>
	    Font Chooser
	  </guiicon>
	</term>
	<listitem>
	  <para>The user can change the font of a selection either by typing the
name of a new font in the text area of this box or by clicking on the little
arrow to the right of the text area. This will cause a menu to appear from
which a font can be chosen.</para>
	</listitem>
      </varlistentry>


      <varlistentry>
	<term>
	  <guiicon><inlinegraphic fileref="figures/button-font-size.png"></inlinegraphic>
	    Font size
	  </guiicon>
	</term>
	<listitem>
	  <para>The user can change the font size of a selection by typing the
number of a different font size or by clicking on the little arrow to the right
of the entry box and selecting the perferred size.</para>
	</listitem>
      </varlistentry>



      <varlistentry>
	<term>
	  <guiicon><inlinegraphic fileref="figures/button-bold.png"></inlinegraphic>
	    Bold
	  </guiicon>
	</term>
	<listitem>
	  <para>Change the style of the current cell to be bold, or un bold it if it is already bold.</para>
	</listitem>
      </varlistentry>


      <varlistentry>
	<term>
	  <guiicon><inlinegraphic fileref="figures/button-italic.png"></inlinegraphic>
	    Italic
	  </guiicon>
	</term>
	<listitem>
	  <para>Change the style of the current cell to be italicized  .</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>
	  <guiicon><inlinegraphic fileref="figures/button-underline.png"></inlinegraphic>
	   Underline
	  </guiicon>
	</term>
	<listitem>
	  <para>Change the style of the current cell to be underlined.</para>
	</listitem>
      </varlistentry>





      <varlistentry>
	<term>
	  <guiicon><inlinegraphic fileref="figures/button-align-left.png"></inlinegraphic>
	    Left Justify
	  </guiicon>
	</term>
	<listitem>
	  <para>Justify the contents of the cell to the left of the cell.</para>
	</listitem>
      </varlistentry>


      <varlistentry>
	<term>
	  <guiicon><inlinegraphic fileref="figures/button-align-center.png"></inlinegraphic>
	    Center
	  </guiicon>
	</term>
	<listitem>
	  <para>Center the content of the cells.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>
	  <guiicon><inlinegraphic fileref="figures/button-align-right.png"></inlinegraphic>
	    Right Justify
	  </guiicon>
	</term>
	<listitem>
	  <para>Justify the content of the cells to the right side of the cells</para>
	</listitem>
      </varlistentry>



      
      <varlistentry>
	<term>
	  <guiicon><inlinegraphic fileref="figures/button-center-across-selection.png"></inlinegraphic>
	    Center Across Selection
	  </guiicon>
	</term>
	<listitem>
	  <para>
	    Centers the cell's contents so the middle of each line is
	    aligned with the middle of other lines.  This only works
	    with multiple cells.
	  </para>
	</listitem>
      </varlistentry>




      <varlistentry>
	<term>
	  <guiicon><inlinegraphic fileref="figures/button-merge.png"></inlinegraphic>
	    Merge selected cells
	  </guiicon>
	</term>
	<listitem>
	<para>
	  Create a single cell out of the selected region.
	  A contiguous region must be selected.
	  The merged cell will hold
	  the contents of the top left cell in the region.
	</para>
	</listitem>
      </varlistentry>


      <varlistentry>
	<term>
	  <guiicon><inlinegraphic fileref="figures/button-split.png"></inlinegraphic>
	    Split merged cells
	  </guiicon>
	</term>
	<listitem>
	<para>
	  Split a merged cells back into
	  their component cells.
	  The selected cell(s)
	  must previously have been merged.
	</para>
	</listitem>
      </varlistentry>

      


       <varlistentry>
	<term>
	  <guiicon><inlinegraphic fileref="figures/button-money.png"></inlinegraphic>
	    Money
	  </guiicon>
	</term>
	<listitem>
	  <para>Sets the format of the selected cells to be monetary.</para>
	</listitem>
      </varlistentry>
      
        <varlistentry>
	<term>
	  <guiicon><inlinegraphic fileref="figures/button-percent.png"></inlinegraphic>
	    Percentage
	  </guiicon>
	</term>
	<listitem>
	  <para>Sets the format of the selected cells to be a percentage.</para>
	</listitem>
      </varlistentry>
      
         <varlistentry>
	<term>
	  <guiicon><inlinegraphic fileref="figures/button-thousands.png"></inlinegraphic>
	    Thousands separator
	  </guiicon>
	</term>
	<listitem>
	  <para>Sets the format of the selected cells to use  thousands separator.</para>
	</listitem>
      </varlistentry>
      
      <varlistentry>
	<term>
	  <guiicon><inlinegraphic fileref="figures/button-increase-precision.png"></inlinegraphic>
	    Increase the displayed precision
	  </guiicon>
	</term>
	<listitem>
	  <para>Increases the number of decimals shown in the currently selected cell.</para>
	</listitem>
      </varlistentry>
      
      <varlistentry>
	<term>
	  <guiicon><inlinegraphic fileref="figures/button-decrease-precision.png"></inlinegraphic>
          Decrease the displayed precision
	  </guiicon>
	</term>
	<listitem>
	  <para>Decreases the number of decimals in the currently selected cell.</para>
	</listitem>
      </varlistentry>


      <varlistentry>
	<term>
	  <guiicon><inlinegraphic fileref="figures/button-decrease-indent.png"></inlinegraphic>
          Decrease the displayed indentation
	  </guiicon>
	</term>
	<listitem>
	  <para>This button decreases the indentation of selected elements.</para>
	</listitem>
      </varlistentry>


      <varlistentry>
	<term>
	  <guiicon><inlinegraphic fileref="figures/button-increase-indent.png"></inlinegraphic>
          Increase the displayed indentation
	  </guiicon>
	</term>
	<listitem>
	  <para>This button increases the indentation of selected elements.</para>
	</listitem>
      </varlistentry>


      
      <varlistentry>
	<term>
	  <guiicon><inlinegraphic fileref="figures/button-borders.png"></inlinegraphic>
          Change the display borders
	  </guiicon>
	</term>
	<listitem>
	  <para>This button and drop down menu can be used to set the
borders of all the cells in the selection.</para>
	</listitem>
      </varlistentry>


      
      <varlistentry>
	<term>
	  <guiicon><inlinegraphic fileref="figures/button-fill.png"></inlinegraphic>
          Set the Background Colour
	  </guiicon>
	</term>
	<listitem>
	  <para>This button and drop down menu can be used to set the back ground
colour.</para>
	</listitem>
      </varlistentry>


      
      <varlistentry>
	<term>
	  <guiicon><inlinegraphic fileref="figures/button-text-colour.png"></inlinegraphic>
          Set the Text Colour
	  </guiicon>
	</term>
	<listitem>
	  <para>This can be used to change the colour of the text.</para>
	</listitem>
      </varlistentry>


   </variablelist>
</sect1>










<!-- ************************* THE OBJECT TOOLBAR ************** -->
<sect1 id="obj-toolbar">
	<title>The Object Toolbar</title>


	<figure id="toolbar-object.png">
     <title>The <interface>Object Toolbar</interface></title>
     <screenshot>
      <graphic fileref="figures/toolbar-object.png" format="png" srccredit="The GNOME project">
      </graphic>
     </screenshot>
    </figure>
 	<para> The <interface>Object Toolbar</interface>. </para>







   <variablelist>


      <varlistentry>
	<term>
	  <guiicon><inlinegraphic fileref="figures/button-label.png"></inlinegraphic>
          Insert a label
	  </guiicon>
	</term>
	<listitem>
	  <para>This button allows the user to insert a text label into a
worksheet.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>
	  <guiicon><inlinegraphic fileref="figures/button-frame.png"></inlinegraphic>
          Insert a Frame
	  </guiicon>
	</term>
	<listitem>
	  <para>This button allows a user to insert a frame into a worksheet.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>
	  <guiicon><inlinegraphic fileref="figures/button-checkbox.png"></inlinegraphic>
          Insert a Checkbox
	  </guiicon>
	</term>
	<listitem>
	  <para>This button allows a user to insert a check box.</para>
	</listitem>
      </varlistentry>


      
      <varlistentry>
	<term>
	  <guiicon><inlinegraphic fileref="figures/button-list.png"></inlinegraphic>
          Insert a List
	  </guiicon>
	</term>
	<listitem>
	  <para>This button allows a user to insert a list.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>
	  <guiicon><inlinegraphic fileref="figures/button-combo.png"></inlinegraphic>
          Insert a Combo Box
	  </guiicon>
	</term>
	<listitem>
	  <para>This allows a user to insert a Combo Box.</para>
	</listitem>
      </varlistentry>


      <varlistentry>
	<term>
	  <guiicon><inlinegraphic fileref="figures/button-line.png"></inlinegraphic>
	    Line
	  </guiicon>
	</term>
	<listitem>
	  <para>Draw a line on the worksheet.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>
	  <guiicon><inlinegraphic fileref="figures/button-arrow.png"></inlinegraphic>
	    Arrow
	  </guiicon>
	</term>
	<listitem>
	  <para>Draw a line with a arrow at one end. A pointer.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>
	  <guiicon><inlinegraphic fileref="figures/button-rectangle.png"></inlinegraphic>
	    Box
	  </guiicon>
	</term>
	<listitem>
	  <para>Draw a box onto the worksheet.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>
	  <guiicon><inlinegraphic fileref="figures/button-oval.png"></inlinegraphic>
	    Ellipse
	  </guiicon>
	</term>
	<listitem>
	  <para>Draw an ellipse or a circle on the worksheet.</para>
	</listitem>
      </varlistentry>
    </variablelist>
</sect1>
  <!-- end of button bar docs -->
 

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:2
sgml-indent-data:t
sgml-parent-document:nil
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->      
