From dadc34655c3ab961b0b0b94a10eaaba710f0b5e8 Mon Sep 17 00:00:00 2001 From: tpearson Date: Mon, 4 Jul 2011 22:38:03 +0000 Subject: Added kmymoney git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/applications/kmymoney@1239792 283d02a7-25f6-0310-bc7c-ecb5cbfe19da --- doc/en/details-widgets.docbook | 211 +++++++++++++++++++++++++++++++++++++++++ 1 file changed, 211 insertions(+) create mode 100644 doc/en/details-widgets.docbook (limited to 'doc/en/details-widgets.docbook') diff --git a/doc/en/details-widgets.docbook b/doc/en/details-widgets.docbook new file mode 100644 index 0000000..fae1595 --- /dev/null +++ b/doc/en/details-widgets.docbook @@ -0,0 +1,211 @@ + + + + + Thomas + Baumgart + +
ipwizard@users.sourceforge.net
+ + + + +Widgets + + + &kappname; has some specific widgets not found in other applications. The + usage of these widgets is explained in this chapter. + + + +Date entry widget + + + Whenever &kappname; needs information about a specific date, e.g., the posting + date of a transaction or the opening date of an account, it offers 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, separated by + the date separator characters specified by your locale settings. The button - + if pressed - opens the datepicker widget. + + + + + Tip of the Day + + + + + + Date widget + + + + + + + Within the date entry widget, the left/right cursor keys can be used to switch + between the day, the month, and the + year fields. Using the up/down cursor keys, the value of + the selected field can be incremented/decremented. The + and + - keys can be used to increment/decrement a single 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 on 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 the same 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, two on each side of 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. + + + + Beneath the buttons, the widget presents a calendar page for the selected + month. Clicking a day on the calendar selects that date, closes the + datepicker, and transfers the selected date into the day, + month, and year fields. + + + + At the bottom of the datepicker widget, there are 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 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 (e.g., +,-,/,* or %) + a little calculator will pop up and allow you to calculate the final value. + + + + Negative values can be entered by preceeding the value with a minus sign. In + case your locale is set to display negative numbers with parantheses around + the value, the value can also be enclosed in parenthesis in the value entry + widget. + + + + + 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 enter 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 you 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 want 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. + + + + Once the edit field contains characters, the list only shows those payees that + match the character sequence entered. Double-click on the arrow of the combo + box to show all payees in the list. + + + + + +Category/account entry + + + When you are requested 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 you 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 want 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. + + + + Once the edit field is filled with characters, the list only shows those + categories/accounts that match the character sequence entered. Double-click on + the arrow of the combo box to show the complete list. + + + + \ No newline at end of file -- cgit v1.2.1