File:  [mozdev] / calendarhelp / www / clockpick.html
Revision 1.2: download - view: text, annotated - select for diffs - revision graph
Sat Jan 21 18:17:51 2006 UTC (11 years, 10 months ago) by whiteley
Branches: MAIN
CVS tags: HEAD
version 0.2

<h2>
<img src="clockpick-small.png" style="border:none; vertical-align:middle; margin-right:10px;" width="48" height="48">
Clock Picker
</h2>

<p>
<b>Clock Picker</b> is an extension for future versions of Mozilla Calendar, Sunbird and Lightning.
</p>

<p>
It provides time pickers in the form of circular clock faces.
You can drag the hands with your mouse to set the time.
</p>

<img src="./cpick0.png" style="margin-left:2em;">

<p>
<span style="border:1px solid #f00; margin-left:-4px; padding:4px;">
The current version of Clock Picker is a prototype for Sunbird 0.3a1 and Lightning test builds only.
</span>
</p>

<p>
For installation instructions, see the <a href="#install">bottom</a> of this page.
</p>

<p>
The <b>Clock Picker</b> project is a subproject of <b>Calendar Help</b>.
</p>


<h3>Why use Clock Picker?</h3>
<p>
Use Clock Picker if you prefer a visual representation of times
on a conventional clock face.
</p>


<h3>How to use Clock Picker</h3>
<p>
To use Clock Picker, open a time picker in the normal way.
</p>

<p>
To change the minute, select anywhere on the outer edge of the clock face.
Drag the minute hand to where you want it.
Dragging it around the top of the clock changes the hour.
</p>

<img src="./cpick1.png" style="margin-left:2em;">

<p>
To change the hour, select anywhere in the middle of the clock face
(but not right at the center).
Drag the hour hand to where you want it.
Dragging it around the top of the clock changes between AM and PM.
</p>

<img src="./cpick2.png" style="margin-left:2em;">

<p>
To close the picker, click anywhere outside it.
</p>


<h3>Clearing the time</h3>
<p>
To clear the time, click the Clear button at the bottom right of the picker.
Select AM or PM, then drag the hour hand to where you want it.
</p>

<img src="./cpick3.png" style="margin-left:2em;">

<p>
Set the minute and close the picker as described above.
</p>


<h3>Setting an exact minute</h3>
<p>
To set an exact minute, release the Resolution button at the bottom left of the picker.
When the button is released, you can move the minute hand to an exact minute.
</p>

<img src="./cpick4.png" style="margin-left:2em;">

<p>
When the Resolution button is pressed, you can only move the minute hand to
a multiple of 5 minutes.
</p>



<h3 id="install">Installing Clock Picker</h3>
<p>
To use the Clock Picker prototype, you must have Sunbird 0.3a1,
or a later version of Sunbird, or a test build of Lightning installed in Thunderbird.
</p>

<p>
To install Clock Picker, choose Tools &ndash; Extensions... from Sunbird's or Thunderbird's menu bar.
Drag the link below and drop it in the Extensions window:
</p>

<p><a href="http://downloads.mozdev.org/calendarhelp/clockpick-0.2-en-US.xpi">clockpick-0.2-en-US.xpi</a></p>

<p><b>Note: &nbsp;</b>
Clock Picker version numbers have no relationship to Sunbird or Lightning version numbers.
</p>

<p>
Wait for the download, and allow the installation to proceed.
</p>

<p>
Restart Sunbird or Thunderbird.
</p>

<h4>Uninstalling Clock Picker</h4>
<p>
To uninstall, return to the Extensions window.
Select Clock Picker and press the Uninstall button.
Close and restart Sunbird or Thunderbird.
</p>

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>