# Date entry widget

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 date entry widget. This widget consists of three fields and a button. The fields present the day, the month and the year seperated by the respective date separator characters depending on your locale settings. The button - if pressed - opens the datepicker widget.

Tip of the Day Date widget

The left/right cursor keys can be used to switch between the day, the month and the year field. Using the up/down cursor keys, the value of the selected field can be incremented/decremented. The + and - key can be used to increment/decrement for one day. Month and year boundaries are considered and incremented/decremented if necessary. Pressing t will set the date to today's date.

The date can also be changed using the mouse. Clicking into the day, month or year 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.

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 monthname 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.

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 day, month or year fields.

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 RETURN 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.

# Value entry

The value entry widget consits out of a text field that accepts digits, thousand seperators 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.

Tip of the Day Value widget

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.

# Payee/Payer entry

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.

Tip of the Day Payee widget

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.

# Category/account entry

When you are request to enter the name of a category or acocunt, 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.

Tip of the Day Category widget

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.