1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
|
<?xml version="1.0" encoding="UTF-8"?>
<sect1 id="reference.widgets">
<sect1info>
<author>
<firstname>Thomas</firstname>
<surname>Baumgart</surname>
<affiliation>
<address><email>ipwizard@users.sourceforge.net</email></address>
</affiliation>
</author>
</sect1info>
<title>Widgets</title>
<para>
&kappname; has some specific widgets not found in other applications. The
usage of these widgets is explained in this chapter.
</para>
<sect2 id="reference.widgets.datepicker">
<title>Date entry widget</title>
<para>
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 <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 date separator characters specified by your locale settings. The button -
if pressed - opens the <emphasis>datepicker</emphasis> 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>
Within the date entry widget, the left/right cursor keys can be used to switch
between the <emphasis>day</emphasis>, the <emphasis>month</emphasis>, and the
<emphasis>year</emphasis> fields. Using the up/down cursor keys, the value of
the selected field can be incremented/decremented. The <keycap>+</keycap> and
<keycap>-</keycap> keys can be used to increment/decrement a single 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 on 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 the same 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, 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.
</para>
<para>
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 <emphasis>day</emphasis>,
<emphasis>month</emphasis>, and <emphasis>year</emphasis> fields.
</para>
<para>
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
<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 (e.g., +,-,/,* or %)
a little calculator will pop up and allow you to calculate the final value.
</para>
<para>
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.
</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 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.
</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 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.
</para>
<para>
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.
</para>
</sect2>
<sect2 id="reference.widgets.category">
<title>Category/account entry</title>
<para>
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.
</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 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.
</para>
<para>
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.
</para>
</sect2>
</sect1>
|
