home *** CD-ROM | disk | FTP | other *** search
/ Freelog 65 / Freelog065.iso / BAS / Bureautique / Gnumeric / gnumeric-1.3.92-rc1.exe / gui-other-elements.xml < prev    next >
Text File  |  2004-11-01  |  14KB  |  414 lines
  1. <sect1 id="data-entry">
  2.   <title>Data Entry Area</title>
  3.  
  4.   <para>Immediately above the grid of cells is the data entry
  5.     area as shown in <xref linkend="worksheet-data-1" />.</para>
  6.   <figure id="worksheet-data-1">
  7.     <title>The Data Entry area.</title>
  8.     <screenshot>
  9.         <mediaobject>
  10.             <imageobject>
  11.               <imagedata fileref="figures/worksheet-data-1.png" format="PNG" />
  12.             </imageobject>
  13.             <textobject>
  14.               <phrase>An image of the data entry area.</phrase>
  15.             </textobject>
  16.            </mediaobject>
  17.     </screenshot>
  18.   </figure>
  19.   <para>This is a small area, which contains a current cell
  20.     indicator, a <guibutton>cancel</guibutton> button, a 
  21.     <guibutton>confirm</guibutton> button, an
  22.     <guibutton>entry</guibutton> button, and an entry area for
  23.     detailed editing of the cell contents. These elements are explained
  24.     individually below.
  25.   </para>
  26.   
  27. <!-- TODO: change through whole file current cell to selection. -->
  28.     <sect2>
  29.       <title>Current Cell Indicator</title>
  30.       
  31.       <para>
  32.         On the far left of the Data Entry area is the current cell
  33.         indicator area.  This area is shown in <xref
  34.         linkend="worksheet-data-2" />
  35.       </para>
  36.  
  37. <!-- TODO: change the screenshot to drop the other two buttons. -->
  38.  
  39.       <figure id="worksheet-data-2">
  40.     <title>The Current Cell Indicator.</title>
  41.     <screenshot>
  42.           <mediaobject>
  43.             <imageobject>
  44.               <imagedata fileref="figures/worksheet-data-2.png" format="PNG" />
  45.             </imageobject>
  46.             <textobject>
  47.               <phrase>An image of the current cell indicator.</phrase>
  48.             </textobject>
  49.            </mediaobject>
  50.     </screenshot>
  51.       </figure>
  52.  
  53.       <para>
  54.         The cell indicator will show the address for the cell at the
  55.         top left of the selected region. This address is listed in the
  56.         standard column:row notation. The alphabetic part indicates
  57.         the the column of this top leftmost cell and the numeric part
  58.         indicates the row of this top left cell. For instance, the
  59.         cell which is over three columns and down two rows is
  60.         designated:</para> <blockquote><para>C2</para></blockquote>
  61.         <para>This designation matches the column and row headers for
  62.         this cell.
  63.       </para>
  64.  
  65.       <para>
  66.         While a region is being selected, the current cell indicator
  67.         will change to show the size of the region which is being
  68.         selected. This information is presented in a row number by
  69.         column number format. For instance, this designation:
  70.       
  71.         <blockquote><para>15R x 6C</para></blockquote>
  72.       
  73.         would indicate a selection area 15 rows high by 6 columns
  74.         wide. Once the mouse is released at the end of the selection,
  75.         the current cell indicator goes back to giving the address of
  76.         the single top leftmost cell.
  77.       </para>
  78.       
  79.     </sect2>
  80.     
  81.     <sect2>
  82.       <title>The <guibutton>Cancel</guibutton> Button</title>
  83.       
  84.     <para>
  85.       The Cancel button 
  86.       <guibutton>
  87.     <inlinemediaobject>
  88.             <imageobject>
  89.               <imagedata fileref="figures/worksheet-data-4.png" format="PNG"/>
  90.             </imageobject>
  91.             <textobject>
  92.               <phrase>An image of the cancel button.</phrase>
  93.             </textobject>
  94.            </inlinemediaobject>
  95.       </guibutton>
  96.       can be used to cancel the current edit and to restore the cell
  97.       contents to the previous state. If a user decides in the middle
  98.       of an edit that the data being entered into a cell is not what
  99.       they want, the user can push this cancel button to cancel the
  100.       current data and return the cell to the state it was at before.
  101.     </para>
  102.       
  103.     <para>
  104.       The most common use of this button is when overwriting the contents
  105.       of a cell with new data. If the user decided to revert the change
  106.       before confirming it, the cancel button is the answer. Note that this 
  107.       button works just like typing the escape key on the keyboard.
  108.     </para>
  109.   </sect2>
  110.   
  111.     
  112.     <sect2>
  113.       <title>The <guibutton>Confirm</guibutton> Button</title>
  114.       
  115.       <para>The confirm button
  116.       <guibutton>
  117.     <inlinemediaobject>
  118.             <imageobject>
  119.               <imagedata fileref="figures/worksheet-data-3.png" format="PNG" />
  120.             </imageobject>
  121.             <textobject>
  122.               <phrase>An image of the enter button.</phrase>
  123.             </textobject>
  124.            </inlinemediaobject>
  125.        </guibutton>.  can be used to finish the edit of a cell and
  126.        enter the edit into the workbook. Note that this button works
  127.        in the same way as the enter key.
  128.       </para>
  129.  
  130.     </sect2>
  131.     
  132.     
  133.     <sect2>
  134.       <title>The <guibutton>Equals</guibutton> Button</title>
  135.       
  136.       <para>The equals button 
  137.         <guibutton>
  138.           <inlinemediaobject>
  139.             <imageobject>
  140.               <imagedata fileref="figures/button-equals.png" format="PNG" />
  141.             </imageobject>
  142.             <textobject>
  143.               <phrase>An image of the equals button.</phrase>
  144.             </textobject>
  145.            </inlinemediaobject>
  146.         </guibutton>
  147.       can be used to start a formula in the currently selected
  148.       cell. If a user wanted to make cell D10 equal to cell B4,
  149.       the user could simply click on cell D10, click this equals
  150.       button, click on cell B4 and type the enter key. Note that
  151.       this button works the same way as the equals key.
  152.       </para>
  153.       
  154.     </sect2>
  155.  
  156. <!--TODO: Add <sect2> with discussion of the formula entry field. -->
  157.  
  158.  
  159. </sect1>
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.   
  167. <sect1 id="cell-grid">
  168.     <title>The Cell Grid</title>
  169.       
  170.     <para>Most of the work done on a spreadsheet is done to the main
  171.     Cell area, the large grid like part of the worksheet. This is
  172.     where all the formulas and data are entered, and is the center of
  173.     activity for the spreadsheet.</para>
  174.  
  175. <!-- TODO: change screenshot to fit in 510pixels. -->
  176.     <figure id="cell-grid.png">
  177.       <title>The Cell Grid area, with cells of different sizes.</title>
  178.       <screenshot>
  179.          <mediaobject>
  180.             <imageobject>
  181.               <imagedata fileref="figures/cell-grid.png" format="PNG" />
  182.             </imageobject>
  183.             <textobject>
  184.               <phrase>An image of the cell grid area.</phrase>
  185.             </textobject>
  186.           </mediaobject>
  187.       </screenshot>
  188.     </figure>
  189.  
  190.      <para><xref linkend="cell-grid.png" /> shows the the cell grid
  191.      area, the column and row headers on the top and left, the
  192.      scrollbars on the right and bottom and the tab list at the
  193.      very bottom.
  194.     </para>
  195.     
  196.     <para> The figure has a few and shows that cell B3 as being 
  197.     selected. In this figure, the columns and rows have been 
  198.     resized and therefore look uneven. </para>
  199.     
  200.     <para>Each cell in this area is delimited by a light grey line
  201.     by default.  The current selection is indicated by a
  202.     rectangular box with a little box on the lower right, this
  203.     case cell J12. The view in this figure shows the middle
  204.     portion of a worksheet which is evident in two ways. Firstly,
  205.     the column and row headers do not start at column A and row
  206.     1. Secondly, the scroll thumbs are not at the top and
  207.     left. The thumbs are the boxes within the scroll bars that are
  208.     used to scroll. Note also that cell D19 has a comment within
  209.     it which is shown by the little red triangle at the top right
  210.     corner.</para>
  211.     
  212.     <para>The size of a cell is determined by the width of the
  213.     column and height of the row that the cell is in. The columns
  214.     and rows can be resized by acting on the header relevant to
  215.     the cell. The user must move the mouse pointer to the edge of
  216.     the header which is either to the right or below the cell.
  217.     With the mouse pointer in this position, the pointer will
  218.     change to a set of opposite pointing arrows. The user must
  219.     then drag this edge away from the top left corner. This takes
  220.     a little practice.</para>
  221.     
  222.     
  223.     <para>The cell area is the core of Gnumeric. Therefore the
  224.     manual explains the use of cells in much greater detail in a
  225.     separate section. Interested users should read <xref
  226.     linkend="chapter-data" />.</para>
  227.  
  228.     
  229.  
  230.   <sect2 id="col-row-headers">
  231.     <title>The Column and Row Headers</title>
  232.  
  233.     <para>
  234.       The sheet is bordered by column headers on the top and row
  235.       headers to the left.  Columns are labeled alphabetically running
  236.       horizontally across the top of the sheet as shown in <xref
  237.       linkend="worksheet-cols-1" />.
  238.  
  239.     <figure id="worksheet-cols-1">
  240.       <title>The column labels at the top of the worksheet.</title>
  241.       <screenshot>
  242.          <mediaobject>
  243.             <imageobject>
  244.               <imagedata fileref="figures/worksheet-cols-1.png" format="PNG" />
  245.             </imageobject>
  246.             <textobject>
  247.               <phrase>An image of the column labels.</phrase>
  248.             </textobject>
  249.            </mediaobject>
  250.       </screenshot>
  251.     </figure>
  252.  
  253.     Rows are labeled along the left side of the worksheet. Each label
  254.     is a different integer increasing downward. This is shown in
  255.     <xref linkend="worksheet-rows-1" />.
  256.     
  257.     <figure id="worksheet-rows-1">
  258.       <title>The row labels at the left side of the worksheet.</title>
  259.       <screenshot>
  260.          <mediaobject>
  261.             <imageobject>
  262.               <imagedata fileref="figures/worksheet-rows-1.png" format="PNG" />
  263.             </imageobject>
  264.             <textobject>
  265.               <phrase>An image of the row labels.</phrase>
  266.             </textobject>
  267.            </mediaobject>
  268.       </screenshot>
  269.     </figure>
  270.  
  271.     </para>
  272.  
  273.     </sect2>
  274.  
  275.   <sect2>
  276.     <title>The Scrollbars</title>
  277.  
  278. <!-- TODO: add screenshot, explain the different parts: thumb, channel... -->
  279.     <para>
  280.       The cell grid area's scrollbars work like other scrollbars. In
  281.       this case they let the user work on a worksheet which is much
  282.       bigger than what could be shown at any given moment.
  283.     </para>
  284.  
  285.   </sect2>
  286.  
  287.  
  288.  
  289.  
  290.   <sect2>
  291.     <title>The Tabbed Sheet Indicator</title>
  292.  
  293. <!-- TODO: add a screenshot. Explain selction, drag. -->
  294.     <para>
  295.       At the bottom of <xref linkend="cell-grid.png" />, Gnumeric has
  296.       a tabbed sheet indicator. This is the boxes with the labels
  297.       "Guppies", "Turtles", "Mermaids", "seahorses" and so on. In
  298.       workbooks where there are more than one sheet, extra tabs are
  299.       used to indicate how many sheets are there, and also allows the
  300.       user to move to another sheet by clicking the proper tab. Each
  301.       tab is a link to a separate worksheet within Gnumeric. In this
  302.       figure, the "Turtles" tab has been selected. Gnumeric shows this
  303.       by making the "Turtles" since the tab is a little bigger and
  304.       making it overlap the two neighbouring tabs.
  305.     </para>
  306.  
  307.     <para>
  308.       On the far right, the two arrows indicate that there are more
  309.       sheets in the workbook and more tabs for those
  310.       sheets. Unfortunately, there is not enough space to show them
  311.       all so Gnumeric displays these arrows. If all the sheets are
  312.       visible, these arrows will not be displayed. These arrows can be
  313.       used to scroll the tabs and bring tabs that were hidden into
  314.       view. This may be a little difficult to understand and work with
  315.       but becomes easier quickly.
  316.     </para>
  317.  
  318.   </sect2>
  319.     
  320.  
  321.  
  322. </sect1>
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332. <sect1 id="info-area">
  333.     <title>The Information Area</title>
  334.     
  335.     <para>
  336.       The section at the very bottom of the worksheet view is the
  337.       information area as is shown in <xref linkend="info-area.png"
  338.       />.
  339.  
  340.     <figure id="info-area.png">
  341.       <title>The Information Display Area.</title>
  342.  
  343.       <screenshot>
  344.         <mediaobject>
  345.           <imageobject>
  346.             <imagedata fileref="figures/info-area.png" format="PNG" />
  347.           </imageobject>
  348.           <textobject>
  349.             <phrase>An image of the information display area.</phrase>
  350.           </textobject>
  351.         </mediaobject>
  352.       </screenshot>
  353.     </figure>
  354.  
  355.       The information area displays information depending on what is
  356.       happening in Gnumeric.
  357.     </para>
  358.     
  359.     <sect2>
  360.         <title>The Menu Hint Area</title>
  361.     
  362.     <para>
  363.     The leftmost portion of the information display area, the part
  364.     which reads: "Sort the selected cells" is a hint explaining
  365.     what a menu does. In this case, the Data menu was opened and
  366.     the pointer is hovering above the "sort" menu entry. Gnumeric
  367.     is responding by giving a quick explanation of what that menu
  368.     entry does.
  369.     </para>
  370.  
  371.     </sect2>
  372.  
  373.     <sect2>
  374.         <title>The File Status Indicator</title>
  375.  
  376.         <para>
  377.         Whenever Gnumeric opens or saves a file, the file
  378.         status indicator appears with a progress bar which
  379.         grows as Gnumeric progresses. In <xref
  380.         linkend="info-area.png" />, Gnumeric was just over
  381.         halfway done opening a file.
  382.         </para>
  383.     </sect2>
  384.  
  385.  
  386.  
  387.        <sect2>
  388.       <title>The Running Calculation Area</title>
  389.       
  390.       <para>In the bottom right hand corner, is an info area that
  391.       shows some constantly calculated values. The default set is to
  392.       show the Sum of all the currently selected cells.</para>
  393.       
  394.       <para>There is a right click option that includes a few more
  395.       options.  This can include Sum, Min, Max, Average, Count.</para>
  396.       
  397.       <figure id="worksheet-running-calc-1">
  398.     <title>The running calculation area.</title>
  399.     <screenshot>
  400.       <mediaobject>
  401.             <imageobject>
  402.               <imagedata fileref="figures/worksheet-running-calc-1.png" format="PNG" /></imageobject>
  403.             <textobject>
  404.               <phrase>An image of the running calculation area.</phrase>
  405.             </textobject>
  406.            </mediaobject>
  407.     </screenshot>
  408.       </figure>
  409.     </sect2>
  410.   </sect1>
  411.  
  412. <!--end of chapter Other graphical elements.-->
  413.  
  414.