home *** CD-ROM | disk | FTP | other *** search
/ PC Professionell 2005 June / PCpro_2005_06.ISO / files / opensource / xamp / xampp-win32.exe / xampp / expert.pkg < prev    next >
Encoding:
Text File  |  2004-03-24  |  2.8 KB  |  63 lines
  1. <refentry id="{@id}">
  2.  <refnamediv>
  3.   <refname>Expert Guide</refname>
  4.   <refpurpose>learn how to use HTML_Progress, advanced features</refpurpose>
  5.  </refnamediv>
  6.  <refsynopsisdiv>
  7.   <refsynopsisdivinfo>
  8.    <author>
  9.     by Laurent Laville
  10.     <authorblurb>{@link mailto:pear@laurent-laville.org}</authorblurb>
  11.    </author>
  12.    <copyright>November 2003, Laurent Laville</copyright>
  13.    <releaseinfo>HTML_Progress 1.0+</releaseinfo>
  14.   </refsynopsisdivinfo>
  15.  </refsynopsisdiv>
  16.  {@toc}
  17.  <refsect1 id="{@id intro}">
  18.   <title>Introduction </title>
  19.    <para>
  20.     After you see a progress bar ({@tutorial beginner.pkg#basics.using})
  21.     and a progress monitor in action ({@tutorial monitor.pkg}), {@tutorial expert.pkg#deciding}
  22.     can help you figure out which is appropriate for your application.
  23.    </para>
  24.  </refsect1>
  25.  <refsect1 id="{@id deciding}">
  26.   <title>Deciding whether to use a Progress Bar or a Progress Monitor </title>
  27.   <para>
  28.    Use a <emphasis>progress bar</emphasis> if:
  29.   </para>
  30.   <unorderedlist>
  31.    <listitem><para>You want more control over the configuration of the progress bar.
  32.     If you are working directly with a progress bar, you can set it to be indeterminate, 
  33.     make it display vertically, provide a string for it to display, register listeners on it,
  34.     and provide it with a bounded range model to control the progress bar's minimum,
  35.     maximum, increment and current values.
  36.     </para></listitem>
  37.    <listitem><para>Your program needs to display others components along with the progress bar.
  38.     </para></listitem>
  39.    <listitem><para>You need more than one progress bar. With some tasks, you need to monitor 
  40.     more than one parameter. For example, an installation program might monitor disk space
  41.     usage in addition to how many files have been successfully installed.
  42.     </para></listitem>
  43.   </unorderedlist>
  44.   <para>
  45.    Use a <emphasis>progress monitor</emphasis> if:
  46.   </para>
  47.   <unorderedlist>
  48.    <listitem><para>You want an easy way to display progress in a dialog.</para></listitem>
  49.    <listitem><para>The running task is secondary and the user might not be interested
  50.     in the progress of the task. Progress monitor provides a way for user to dismiss the dialog
  51.     while the task is still running.
  52.     </para></listitem>
  53.    <listitem><para>You want an easy way for the task to be cancelled. Progress Monitor provides
  54.     a GUI for the user to cancel the task. All you have to do is call 
  55.     {@link HTML_Progress_Monitor::isCanceled()} method to find out if the user pressed the 
  56.     <emphasis>Cancel</emphasis> button.
  57.    </para></listitem>
  58.    <listitem><para>The task might not take a long time to complete. You decide at what point 
  59.     a running task is taking long enough to warrant letting the user know about it.</para></listitem>
  60.   </unorderedlist>
  61.  </refsect1>
  62. </refentry>
  63.