
<sect2 id="reference.widgets.datepicker">
<title>Date entry widget</title>
<para>
Whenever &kappname; needs information about a specific date, eg. the posting date of a transaction of the opening date of an account,
it presents the user the <emphasis>date entry widget</emphasis>. This widget consists of three fields and a button. The fields present
the <emphasis>day</emphasis>, the <emphasis>month</emphasis> and the <emphasis>year</emphasis> separated by the respective date separator
characters depending on your locale settings. The button - if pressed - opens the datepicker widget.
</para>

<para>
<screenshot>
	<screeninfo>Tip of the Day</screeninfo>
	<mediaobject>
	<imageobject>
	<imagedata fileref="date_widget.png" format="PNG" />
	</imageobject>
	<textobject>
	<phrase>Date widget</phrase>
	</textobject>
	</mediaobject>
</screenshot>
</para>

<para>
The left/right cursor keys can be used to switch between the <emphasis>day</emphasis>, the <emphasis>month</emphasis>
and the <emphasis>year</emphasis> field. Using the up/down cursor keys, the value of the selected field can be incremented/decremented.
The <keycap>+</keycap> and <keycap>-</keycap> key can be used to increment/decrement for one day.
Month and year boundaries are considered and incremented/decremented if necessary. Pressing <keycap>t</keycap> will set the date to today's
date.
</para>
<para>
The date can also be changed using the mouse. Clicking into the <emphasis>day</emphasis>, <emphasis>month</emphasis>
or <emphasis>year</emphasis> field selects the field. The value can then be incremented/decremented using the arrow buttons on
the right of the widget. They act exactly as the up/down key.
</para>
<para>
The datepicker opens when the button to the right of the arrow buttons is pressed. It shows four arrow buttons at the top which enclose
the currently selected month name and year. The leftmost buttons are used to decrement the year and the month, the buttons to the right
of the year are used to increment the month and the year. The button to the very right closes the datepicker.
</para>
<para>
Beneath the buttons, the widget presents a calendar page for the respective month. Clicking a day of the selected month selects that date,
closes the datepicker and transfers the selected date into the <emphasis>day</emphasis>, <emphasis>month</emphasis> or
<emphasis>year</emphasis> fields. 
</para>
<para>
At the bottom of the widget the users finds a button, a text edit field and a combo box. Pressing the button selects today's date
in the datepicker, the text field can be used to enter a specific date. Pressing the <keycap>RETURN</keycap> key shows that date in the datepicker widget.
The combo box allows the user to select a specific week and continue to pick a date from there.
</para>
</sect2>

<sect2 id="reference.widgets.value">
<title>Value entry</title>
<para>
The value entry widget consists of a text field (that accepts digits, thousands separators, and decimal symbols) as well as a button to
the right. Use the digits to enter the value. Separate the fractional part by entering the decimal separator for your locale. If you
click on the button to the right or press a key representing a numeric operation (eg. +,-,/,* or %) a little calculator will pop up
and allows you to calculate the final value.
</para>

<para>
<screenshot>
	<screeninfo>Tip of the Day</screeninfo>
	<mediaobject>
	<imageobject>
	<imagedata fileref="value_widget.png" format="PNG" />
	</imageobject>
	<textobject>
	<phrase>Value widget</phrase>
	</textobject>
	</mediaobject>
</screenshot>
</para>

<para>
Use the calculator widget just like a normal calculator and once done leave it by clicking on the '=' button or press the '=' key on
your keyboard.
</para>
</sect2>

<sect2 id="reference.widgets.payee">
<title>Payee/Payer entry</title>
<para>
When you are requested to select a payee/payer for a transaction, you can start entering the name by pressing keys on your keyboard.
As long as matching entries exist in the list of payees/payers maintained by &kappname; they will be presented in a box beneath or above
the text entry area. Using the mouse or the up/down keys one can select a name from that list. Using the keyboard additionally requires to
select the entry by pressing the RETURN key.
</para>

<para>
<screenshot>
	<screeninfo>Tip of the Day</screeninfo>
	<mediaobject>
	<imageobject>
	<imagedata fileref="payee_widget.png" format="PNG" />
	</imageobject>
	<textobject>
	<phrase>Payee widget</phrase>
	</textobject>
	</mediaobject>
</screenshot>
</para>

<para>
If a name is entered that is not yet known to &kappname; you will be asked if you wants to create a new payee/payer record.
If you do not wish to do so, then the field will be blanked. Otherwise, the record will be created and added to the list.
</para>
</sect2>

<sect2 id="reference.widgets.category">
<title>Category/account entry</title>
<para>
When you are request to enter the name of a category or account, you can start entering the name by pressing keys on your keyboard.
As long as matching entries exist in the list of categories/accounts known to &kappname; they will be presented in a box beneath or above
the text entry area. Using the mouse or the up/down keys one can select a name from that list. Using the keyboard additionally requires to
select the entry by pressing the RETURN key.
</para>

<para>
<screenshot>
	<screeninfo>Tip of the Day</screeninfo>
	<mediaobject>
	<imageobject>
	<imagedata fileref="category_widget.png" format="PNG" />
	</imageobject>
	<textobject>
	<phrase>Category widget</phrase>
	</textobject>
	</mediaobject>
</screenshot>
</para>

<para>
If a name is entered that is not yet known to &kappname; you will be asked if you wants to create a new category record.
If you do not wish to do so, then the field will be blanked. Otherwise, the record will be created and added to the list.
</para>
</sect2>


