[prev in list] [next in list] [prev in thread] [next in thread]
List: kde-pim
Subject: [Kde-pim] KOrg config dialog whatsthis take one
From: Carlos Leonhard Woelz <carloswoelz () imap-mail ! com>
Date: 2005-06-01 20:08:20
Message-ID: 200506011708.20946.carloswoelz () imap-mail ! com
[Download RAW message or body]
Hi,
As I promissed on IRC, here goes the patch for KOrg config dialog whatsthis.
Cheers,
Carlos Woelz
PS: The KOrg config dialog is the hardest (for a non programmer) to document
dialog I found. Not only it mixes .ui, kcfg and cpp files, but the cpp files
require a bit more work than simply adding the QWhatsThis lines (that was all
I had to do until now). Some entries on the kcfg file do not seem to change
anything, but I guess that's normal.
I was lucky that Andras (from Quanta) was staying with me at the time, so he
gave me some tips. Thanks, Andras!
["configure-whatsthis-korg.patch" (text/x-diff)]
Index: kogroupwareprefspage.ui
===================================================================
--- kogroupwareprefspage.ui (revision 420354)
+++ kogroupwareprefspage.ui (working copy)
@@ -12,6 +12,9 @@
<height>548</height>
</rect>
</property>
+ <property name="caption">
+ <string>KOGroupwarePrefsPage</string>
+ </property>
<vbox>
<property name="name">
<cstring>unnamed</cstring>
@@ -28,7 +31,7 @@
<cstring>tab</cstring>
</property>
<attribute name="title">
- <string>&Publish</string>
+ <string>P&ublish</string>
</attribute>
<vbox>
<property name="name">
@@ -52,6 +55,14 @@
<property name="text">
<string>Publish your free/&busy information \
automatically</string> </property>
+ <property name="accel">
+ <string>Alt+B</string>
+ </property>
+ <property name="whatsThis" stdset="0">
+ <string>Check this box to upload your Free/Busy \
information automatically. +It is possible to skip this option and mail or upload \
your Free/Busy information using the Schedule menu of KOrganizer. +Note: If \
KOrganizer is acting as a KDE Kolab client, this is not required, as the Kolab2 \
server taking care of publishing your Free/Busy information and manages the access to \
it from other users.</string> + </property>
</widget>
<widget class="QLayoutWidget">
<property name="name">
@@ -71,11 +82,17 @@
<property name="buddy" stdset="0">
<cstring>publishDelaySB</cstring>
</property>
+ <property name="whatsThis" stdset="0">
+ <string>Configure minimum the interval of time \
in minutes between each upload here. This configuration is only effective in case you \
choose to publish your information automatically.</string> + \
</property> </widget>
<widget class="QSpinBox">
<property name="name">
<cstring>publishDelay</cstring>
</property>
+ <property name="whatsThis" stdset="0">
+ <string>Configure minimum the interval of time \
in minutes between each upload here. This configuration is only effective in case you \
choose to publish your information automatically.</string> + \
</property> </widget>
</hbox>
</widget>
@@ -97,6 +114,9 @@
<property name="buddy" stdset="0">
<cstring>publishDaysSB</cstring>
</property>
+ <property name="whatsThis" stdset="0">
+ <string>Configure the number of calendar days \
you wish to be published and available to others here.</string> + \
</property> </widget>
<widget class="QSpinBox">
<property name="name">
@@ -111,6 +131,9 @@
<property name="value">
<number>60</number>
</property>
+ <property name="whatsThis" stdset="0">
+ <string>Configure the number of calendar days \
you wish to be published and available to others here.</string> + \
</property> </widget>
<widget class="QLabel">
<property name="name">
@@ -119,6 +142,9 @@
<property name="text">
<string>days of free/busy information</string>
</property>
+ <property name="whatsThis" stdset="0">
+ <string>Configure the number of calendar days \
you wish to be published and available to others here.</string> + \
</property> </widget>
<spacer>
<property name="name">
@@ -157,14 +183,26 @@
<property name="enabled">
<bool>true</bool>
</property>
+ <property name="whatsThis" stdset="0">
+ <string>Enter the URL for the server on which \
your Free/Busy information shall be published here. +Ask the server administrator for \
this information. +Here is a Kolab2 server URL example: \
"webdavs://kolab2.com/freebusy/joe@kolab2.com.ifb"</string> + \
</property> </widget>
<widget class="QCheckBox" row="7" column="0" rowspan="1" \
colspan="2"> <property name="name">
<cstring>publishSavePassword</cstring>
</property>
<property name="text">
- <string>Re&member password</string>
+ <string>Remember p&assword</string>
</property>
+ <property name="accel">
+ <string>Alt+A</string>
+ </property>
+ <property name="whatsThis" stdset="0">
+ <string>Check this box to make KOrganizer \
remember your password and skip asking you each time it uploads your Free/Busy \
information, by storing it in the configuration file. +For security reasons, it is \
not recommended to store your password in the configuration file.</string> + \
</property> </widget>
<widget class="QLabel" row="6" column="0">
<property name="name">
@@ -176,6 +214,9 @@
<property name="buddy" stdset="0">
<cstring>publishPasswordED</cstring>
</property>
+ <property name="whatsThis" stdset="0">
+ <string>Enter your groupware server login \
password here.</string> + </property>
</widget>
<widget class="QLineEdit" row="6" column="1">
<property name="name">
@@ -184,6 +225,9 @@
<property name="echoMode">
<enum>Password</enum>
</property>
+ <property name="whatsThis" stdset="0">
+ <string>Enter your groupware server login \
password here.</string> + </property>
</widget>
<widget class="QLineEdit" row="5" column="1">
<property name="name">
@@ -195,6 +239,11 @@
<height>0</height>
</size>
</property>
+ <property name="whatsThis" stdset="0">
+ <string>Enter the login information relative to \
your account on the server here. +
+A Kolab2 server specificity: Registered your UID (Unique IDentifier). By default \
your UID would be your email address on the Kolab2 server but it may also be \
different. In the last case enter your UID.</string> + \
</property> </widget>
<widget class="QLabel" row="5" column="0">
<property name="name">
@@ -206,6 +255,11 @@
<property name="buddy" stdset="0">
<cstring>publishUserNameED</cstring>
</property>
+ <property name="whatsThis" stdset="0">
+ <string>Enter the login information relative to \
your account on the server here. +
+A Kolab2 server specificity: Registered your UID (Unique IDentifier). By default \
your UID would be your email address on the Kolab2 server but it may also be \
different. In the last case enter your UID.</string> + \
</property> </widget>
<widget class="QFrame" row="4" column="0" rowspan="1" \
colspan="2"> <property name="name">
@@ -228,6 +282,11 @@
<property name="buddy" stdset="0">
<cstring>anyServerURLED</cstring>
</property>
+ <property name="whatsThis" stdset="0">
+ <string>Enter the URL for the server on which \
your Free/Busy information shall be published here. +Ask the server administrator for \
this information. +Here is a Kolab2 server URL example: \
"webdavs://kolab2.com/freebusy/joe@kolab2.com.ifb"</string> + \
</property> </widget>
</grid>
</widget>
@@ -277,8 +336,14 @@
<cstring>retrieveEnable</cstring>
</property>
<property name="text">
- <string>Retrieve other peoples' &free/busy \
information automatically</string> + <string>Retrieve \
other peoples' free/&busy information automatically</string> </property>
+ <property name="accel">
+ <string>Alt+B</string>
+ </property>
+ <property name="whatsThis" stdset="0">
+ <string>Check this box to retrieve other peoples' \
Free/Busy information automatically. Note that you have to fill the correct server \
information to make this possible.</string> + </property>
</widget>
<widget class="QCheckBox">
<property name="name">
@@ -288,13 +353,16 @@
<bool>true</bool>
</property>
<property name="text">
- <string>Use full email address for retrieval</string>
+ <string>Use full email &address for \
retrieval</string> </property>
+ <property name="accel">
+ <string>Alt+A</string>
+ </property>
<property name="toolTip" stdset="0">
<string>Set this to retrieve user@domain.ifb instead of \
user.ifb from the server</string> </property>
<property name="whatsThis" stdset="0">
- <string>With this setting, you can change the filename \
that will be fetched from the server. With this checked, it will download a free/busy \
file called user@domain.ifb, for example nn@kde.org.ifb. Without this set, it will \
download user.ifb, for example nn.ifb.</string> + \
<string>Check this box to download a free/busy file in the format "user@domain.ifb" \
(for example joe@company.com.ifb). Otherwise, it will download a free/busy file in \
the format user.ifb (for example joe.ifb). Ask the server Administrator if you are \
not sure about how to configure this option.</string> </property>
</widget>
<widget class="QButtonGroup">
@@ -326,6 +394,11 @@
<property name="buddy" stdset="0">
<cstring>anyServerURLED</cstring>
</property>
+ <property name="whatsThis" stdset="0">
+ <string>Enter the URL for the server on \
which the Free/Busy information is published here. +Ask the server administrator for \
this information. +Here is a Kolab2 server URL example: \
"webdavs://kolab2.com/freebusy/"</string> + \
</property> </widget>
<widget class="QLineEdit">
<property name="name">
@@ -334,6 +407,11 @@
<property name="enabled">
<bool>true</bool>
</property>
+ <property name="whatsThis" stdset="0">
+ <string>Enter the URL for the server on \
which the Free/Busy information is published here. +Ask the server administrator for \
this information. +Here is a Kolab2 server URL example: \
"webdavs://kolab2.com/freebusy/"</string> + \
</property> </widget>
</hbox>
</widget>
@@ -360,28 +438,41 @@
<property name="name">
<cstring>retrieveUser</cstring>
</property>
+ <property name="whatsThis" stdset="0">
+ <string>Enter the login information \
relative to your account on the server here. +
+A Kolab2 server specificity: Registered your UID (Unique IDentifier). By default \
your UID would be your email address on the Kolab2 server but it may also be \
different. In the last case enter your UID.</string> + \
</property> </widget>
<widget class="QLabel" row="0" column="0">
<property name="name">
<cstring>textLabel3</cstring>
</property>
<property name="text">
- <string>Us&er name:</string>
+ <string>User &name:</string>
</property>
<property name="buddy" stdset="0">
<cstring>retrieveUser</cstring>
</property>
+ <property name="whatsThis" stdset="0">
+ <string>Enter the login information \
relative to your account on the server here. +
+A Kolab2 server specificity: Registered your UID (Unique IDentifier). By default \
your UID would be your email address on the Kolab2 server but it may also be \
different. In the last case enter your UID.</string> + \
</property> </widget>
<widget class="QLabel" row="1" column="0">
<property name="name">
<cstring>textLabel4</cstring>
</property>
<property name="text">
- <string>Pass&word:</string>
+ <string>Passwor&d:</string>
</property>
<property name="buddy" stdset="0">
<cstring>retrievePassword</cstring>
</property>
+ <property name="whatsThis" stdset="0">
+ <string>Enter your groupware server \
login password here.</string> + </property>
</widget>
<widget class="QLineEdit" row="1" column="1">
<property name="name">
@@ -390,6 +481,9 @@
<property name="echoMode">
<enum>Password</enum>
</property>
+ <property name="whatsThis" stdset="0">
+ <string>Enter your groupware server \
login password here.</string> + </property>
</widget>
</grid>
</widget>
@@ -403,6 +497,13 @@
<property name="text">
<string>Re&member password</string>
</property>
+ <property name="accel">
+ <string>Alt+M</string>
+ </property>
+ <property name="whatsThis" stdset="0">
+ <string>Check this box to make KOrganizer \
remember your password and skip asking you each time it uploads your Free/Busy \
information, by storing it in the configuration file. +For security reasons, it is \
not recommended to store your password in the configuration file.</string> + \
</property> </widget>
</vbox>
</widget>
@@ -509,8 +610,8 @@
</connection>
</connections>
<includes>
+ <include location="global" impldecl="in declaration">kdepimmacros.h</include>
<include location="local" impldecl="in \
implementation">kogroupwareprefspage.ui.h</include>
- <include location="global" impldecl="in declaration">kdepimmacros.h</include>
</includes>
<signals>
<signal>changed()</signal>
Index: korganizer.kcfg
===================================================================
--- korganizer.kcfg (revision 420354)
+++ korganizer.kcfg (working copy)
@@ -8,15 +8,16 @@
<group name="General">
<entry type="Bool" key="Auto Save">
<label>Enable automatic saving of calendar</label>
- <whatsthis>WhatsThis text for AutoSave option</whatsthis>
+ <whatsthis>Check this box to save your calendar automatically when you exit \
KOrganizer without asking and periodically, as you work.</whatsthis> \
<default>true</default> </entry>
<entry type="Int" key="Auto Save Interval">
+ <whatsthis>Set the interval between automatic saving of calendar events in \
minutes here.</whatsthis> <default>10</default>
</entry>
<entry type="Bool" key="Confirm Deletes" name="Confirm">
<label>Confirm deletes</label>
- <whatsthis>Check this option when you want a confirmation when deleting \
items.</whatsthis> + <whatsthis>Check this box to display a confirmation dialog \
when deleting items.</whatsthis> <default>true</default>
</entry>
@@ -70,7 +71,7 @@
<entry type="Bool" key="Html With Save">
<label>Export to HTML with every save</label>
- <whatsthis>The calendar will be exported to a HTML-file every time you save if \
you select this option.</whatsthis> + <whatsthis>Check this box to export the \
calendar to a HTML-file every time you save it. By default, this file will be called \
calendar.html and placed in the user home folder.</whatsthis> \
<default>false</default> </entry>
<entry type="Enum" key="Destination" name="Destination">
@@ -78,9 +79,11 @@
<choices>
<choice name="standardDestination">
<label>Be added to the standard resource</label>
+ <whatsthis>Select this option to always record a new event or to-do using \
the standard resource.</whatsthis> </choice>
<choice name="askDestination">
<label>Be asked which resource to use</label>
+ <whatsthis>Select this option to choose the resource to be used to record \
a event or to-do each time you create a new one. This choice is recommended if you \
intend to use the shared folders functionality of the Kolab server or have to manage \
multiple accounts using Kontact as a KDE Kolab client. </whatsthis> </choice>
</choices>
<default>askDestination</default>
@@ -90,10 +93,12 @@
<group name="Personal Settings">
<entry type="Bool" key="Bcc">
<label>Send copy to owner when mailing events</label>
+ <whatsthis>Check this box to get a copy of all e-mail messages that KOrganizer \
sends at your request to event attendees.</whatsthis> <default>false</default>
</entry>
<entry type="Bool" key="Use Control Center Email" name="EmailControlCenter">
<label>Use email settings from Control Center</label>
+ <whatsthis>Check this box to use the KDE-wide e-mail settings, which are \
defined using the KDE Control Center "Password & User Account" Module. \
Uncheck this box to be able to specify your full name and e-mail.</whatsthis> \
<default>false</default> </entry>
<entry type="Enum" key="Mail Client">
@@ -101,10 +106,11 @@
<choices>
<choice name="MailClientKMail">
<label>KMail</label>
- <whatsthis>This is a radio button whatsthis text</whatsthis>
+ <whatsthis>Select this option to use KMail as the mail transport. The mail \
transport is used for groupware funcionality.</whatsthis> </choice>
<choice name="MailClientSendmail">
<label>Sendmail</label>
+ <whatsthis>Select this option to use sendmail as the mail transport. The \
mail transport is used for groupware functionality. Please check if you have sendmail \
installed before selecting this option.</whatsthis> </choice>
</choices>
<default>MailClientKMail</default>
@@ -113,24 +119,24 @@
<group name="Time & Date">
<entry type="String" name="TimeZoneId">
- <whatsthis>Select the timezone.</whatsthis>
+ <whatsthis>Select your timezone from the list of locations on this drop down \
box. If your city is not listed, select one which shares the same timezone. \
KOrganizer will automatically adjust for daylight savings.</whatsthis> </entry>
<entry type="String" name="Holidays">
<label>Use holiday region:</label>
- <whatsthis>Here you can select from which region you want to use the holidays. \
Defined holidays are shown as non-working days in the date navigator, the agenda \
view, etc.</whatsthis> + <whatsthis>Select from which region you want to use the \
holidays here. Defined holidays are shown as non-working days in the date navigator, \
the agenda view, etc.</whatsthis> </entry>
<entry type="DateTime" name="StartTime">
<label>Default appointment time</label>
- <whatsthis>Here you can enter the event's default time, used if you do not \
supply a start time.</whatsthis> + <whatsthis>Enter the default time for events \
here. The default is used if you do not supply a start time.</whatsthis> \
<default>QDateTime(QDate(), QTime(10,0))</default> </entry>
<entry type="DateTime" name="DefaultDuration">
<label>Default duration of new appointment (HH:MM)</label>
- <whatsthis>Here you can enter the event's default duration, used if you do not \
supply an end time.</whatsthis> + <whatsthis>Enter default duration for events \
here. The default is used if you do not supply an end time.</whatsthis> \
<default>QDateTime(QDate(), QTime(2,0))</default> </entry>
<entry type="Int" key="Default Alarm Time" name="AlarmTime">
- <whatsthis>Here you can enter an incidence's default alarmtime.</whatsthis>
+ <whatsthis>Enter the default alarm time for incidences here.</whatsthis>
<default>0</default>
</entry>
</group>
@@ -138,67 +144,73 @@
<group name="Views">
<entry type="Int" key="Hour Size">
<label>Hour size</label>
+ <whatsthis>Select on this spin box the the height of the hour rows in the \
schedule view.</whatsthis> <default>10</default>
<min>4</min>
<max>30</max>
</entry>
<entry type="Bool" key="Show Daily Recurrences" name="DailyRecur">
<label>Show events that recur daily in date navigator</label>
+ <whatsthis>Check this box to show the days containing daily recurring events \
in bold typeface in the Date Navigator, or uncheck it to give more prominence to \
other (non daily recurring) events.</whatsthis> <default>true</default>
</entry>
<entry type="Bool" key="Show Weekly Recurrences" name="WeeklyRecur">
<label>Show events that recur weekly in date navigator</label>
+ <whatsthis>Check this box to show the days containing weekly recurring events \
in bold typeface in the Date Navigator, or uncheck it to give more prominence to \
other (non weekly recurring) events.</whatsthis> <default>true</default>
</entry>
<entry type="Bool" key="Enable ToolTips">
<label>Enable tooltips displaying summary of events</label>
- <whatsthis>Enable this when you want a tooltip appearing when hovering the \
mouse above an event.</whatsthis> + <whatsthis>Check this box to display an \
event summary tooltip when hovering the mouse over an event.</whatsthis> \
<default>true</default> </entry>
<entry type="Bool" name="ShowAllDayTodo">
<label>Show to-dos in day, week and month views</label>
- <whatsthis>This option toggles the display of to-dos in the day, week, and \
month view. This comes in handy when you have a lot of (recurring) \
to-dos.</whatsthis> + <whatsthis>Check this box to display to-dos in the day, \
week, and month view. This is helpful when you have a lot of (recurring) \
to-dos.</whatsthis> <default>true</default>
</entry>
<entry type="Bool" key="Enable Month-View Scrollbars" name="EnableMonthScroll">
<label>Enable scrollbars in month view cells</label>
- <whatsthis>By checking this option, scrollbars will appear when clicking on a \
cell in the month view; they will only appear when needed though.</whatsthis> + \
<whatsthis>Check this box to display scrollbars when clicking on a cell in the month \
view; they will only appear when needed though.</whatsthis> <default>false</default>
</entry>
<entry type="Bool" name="SelectionStartsEditor">
<label>Time range selection in agenda view starts event editor</label>
- <whatsthis>If you check this option, you can drag the mouse from the start \
time to the end time of the event you are about to plan. An editor will open to an \
event with the selected time range. This works only in the daily and weekly \
view.</whatsthis> + <whatsthis>Check this box to start the event editor \
automatically when you select a time range in the daily and weekly view. To select a \
time range, drag the mouse from the start time to the end time of the event you are \
about to plan.</whatsthis> <default>false</default>
</entry>
<entry type="Bool" key="Marcus Bains shows seconds" \
name="MarcusBainsShowSeconds"> <label>Show seconds on Marcus Bains line</label>
- <whatsthis>Check this option if you want seconds in the Marcus Bains \
line.</whatsthis> + <whatsthis>Check this box if you want to show seconds on the \
current time line (Marcus Bains line).</whatsthis> <default>false</default>
</entry>
<entry type="Bool" key="Show Marcus Bains" name="MarcusBainsEnabled">
<label>Show current time (Marcus Bains line)</label>
- <whatsthis>If selected, a red line will appear in the day or week view \
indicating the current time.</whatsthis> + <whatsthis>Check this box to display \
a red line in the day or week view indicating the current time (Marcus Bains \
line).</whatsthis> <default>false</default>
</entry>
- <entry type="Bool" key="Agenda View Uses Resource Color">
+ <entry type="Bool" key="Agenda View Uses Resource Color">
<label>Agenda view uses resource colors</label>
- <whatsthis>Check this option to make the agenda view use the resource colors \
of an incidence.</whatsthis> + <whatsthis>Check this box to make the agenda view \
use the resource colors of an incidence.</whatsthis> <default>false</default>
</entry>
<entry type="DateTime" name="DayBegins">
<label>Day begins at</label>
+ <whatsthis>Enter the start time for events here. This time should be the \
earliest time that you use for events, as it will be displayed at the \
top.</whatsthis> <default>QDateTime(QDate(), QTime(7,0))</default>
</entry>
<entry type="DateTime" name="WorkingHoursStart">
<label>Daily starting hour</label>
+ <whatsthis>Enter the start time for the working hours here. The working hours \
will be marked with color by KOrganizer.</whatsthis> <default>QDateTime(QDate(), \
QTime(8,0))</default> </entry>
<entry type="DateTime" name="WorkingHoursEnd">
<label>Daily ending hour</label>
+ <whatsthis>Enter the ending time for the working hours here. The working hours \
will be marked with color by KOrganizer.</whatsthis> <default>QDateTime(QDate(), \
QTime(17,0))</default> </entry>
<entry type="Int" key="Work Week Mask" name="WorkWeekMask">
@@ -206,33 +218,37 @@
</entry>
<entry type="Bool" key="Exclude Holidays">
<label>Exclude holidays</label>
+ <whatsthis>Check this box to prevent KOrganizer from marking the working hours \
on holidays.</whatsthis> <default>true</default>
</entry>
<entry type="Bool" key="Month View Uses Category Color">
<label>Month view uses category colors</label>
- <whatsthis>Check this option to make the month view use the category colors of \
an incidence.</whatsthis> + <whatsthis>Check this box to make the month view use \
the category colors of an incidence.</whatsthis> <default>false</default>
</entry>
<entry type="Bool" key="Month View Uses Resource Color">
<label>Month view uses resource colors</label>
- <whatsthis>Check this option to make the month view use the resource colors of \
an incidence.</whatsthis> + <whatsthis>Check this box to make the month view use \
the resource colors of an incidence.</whatsthis> <default>false</default>
</entry>
<entry type="Bool" key="Full View Month">
<label>Month view uses full window</label>
+ <whatsthis>Check this box to use the full Korganizer window when displaying \
the month view. If this box is checked, you will gain some space for the monthly \
view, but other widgets, such as the date navigator, the incidence details and the \
resources list, will not be displayed.</whatsthis> <default>false</default>
</entry>
<entry type="Bool" key="Full View Todo">
<label>To-do view uses full window</label>
+ <whatsthis>Check this box to use the full Korganizer window when displaying \
the to-do view. If this box is checked, you will gain some space for the to-do view, \
but other widgets, such as the date navigator, the to-do details and the resources \
list, will not be displayed.</whatsthis> <default>true</default>
</entry>
<entry type="Bool" key="Record Todos In Journals">
<label>Record completed to-dos in journals</label>
+ <whatsthis>Check this box to record the completion of a to-do task in a new \
entry of your journal automatically.</whatsthis> <default>false</default>
</entry>
@@ -242,6 +258,7 @@
<entry type="Int" key="Next X Days">
<label>Next x days</label>
+ <whatsthis>Select on this spin box the number of "x" days to be \
displayed in the next days view. To access the the next "x" days view, \
choose the the "Next X Days" menu item from the "View" \
menu.</whatsthis> <default>3</default>
</entry>
@@ -284,6 +301,7 @@
</entry>
<entry type="Bool" key="Use Groupware Communication">
<label>Use Groupware communication</label>
+ <whatsthis>Check this box to enable automatic generation of mails when \
creating, updating or deleting events, todo or journal. You should check this box if \
you you want to use the groupware functionality (e.g Configuring Kontact as a KDE \
Kolab client).</whatsthis> <default>false</default>
</entry>
@@ -295,30 +313,37 @@
<group name="Colors">
<entry type="Color" key="Holiday Color">
<label>Holiday color</label>
+ <whatsthis>Select the holiday color here. The holiday color will be used for \
the holiday name in the month view and the holiday number in the date \
navigator.</whatsthis> <default>255, 100, 100</default>
</entry>
<entry type="Color" key="Highlight Color">
<label>Highlight color</label>
+ <whatsthis>Select the highlight color here. The highlight color will be used \
for marking the current selected area in your agenda and in the date \
navigator.</whatsthis> <default>100, 100, 255</default>
</entry>
<entry type="Color" key="AgendaBackgroundColor" name="AgendaBgColor">
<label>Agenda view background color</label>
+ <whatsthis>Select the agenda view background color here.</whatsthis>
<default>255, 255, 255</default>
</entry>
<entry type="Color" key="WorkingHoursColor">
<label>Working hours color</label>
+ <whatsthis>Select the working hour color for the agenda view here.</whatsthis>
<default>225, 225, 255</default>
</entry>
<entry type="Color" key="Todo due today Color" name="TodoDueTodayColor">
<label>To-do due today color</label>
+ <whatsthis>Select the to-do due today color here.</whatsthis>
<default>255, 200, 50</default>
</entry>
<entry type="Color" key="Todo overdue Color" name="TodoOverdueColor">
<label>To-do overdue color</label>
+ <whatsthis>Select the to-do overdue color here.</whatsthis>
<default>255, 100, 100</default>
</entry>
<entry type="Color" key="EventColor">
<label>Default event color</label>
+ <whatsthis>Select the default event color here. The default event color will \
be used for events categories in your agenda. Note that you can specify a separate \
color for each event category below.</whatsthis> <default>151, 235, 121</default>
</entry>
</group>
@@ -326,16 +351,20 @@
<group name="Fonts">
<entry type="Font" key="TimeBar Font">
<label>Time bar</label>
+ <whatsthis>Press this button configure the time bar font. The time bar is the \
widget that shows the hours in the agenda view. This button will open the \
"Select Font" dialog, allowing you to choose the hour font for the time \
bar.</whatsthis> <default code="true">QFont(QString::null, 16)</default>
</entry>
<entry type="Font" key="AgendaView Font">
<label>Agenda view</label>
+ <whatsthis>Press this button configure the agenda view font. This button will \
open the "Select Font" dialog, allowing you to choose the font for the \
events in the agenda view.</whatsthis> </entry>
<entry type="Font" key="MarcusBains Font">
<label>Marcus Bains line</label>
+ <whatsthis>Press this button configure the Marcus Bains line font. This button \
will open the "Select Font" dialog, allowing you to choose the font for the \
current time (Marcus Bains) line in the agenda view.</whatsthis> </entry>
<entry type="Font" key="MonthView Font">
<label>Month view</label>
+ <whatsthis>Press this button configure the month view font. This button will \
open the "Select Font" dialog, allowing you to choose the font for the \
items in the month view.</whatsthis> </entry>
</group>
Index: koprefsdialog.cpp
===================================================================
--- koprefsdialog.cpp (revision 420354)
+++ koprefsdialog.cpp (working copy)
@@ -96,14 +96,30 @@
SLOT( slotWidChanged() ) );
mNameLabel = new QLabel(mNameEdit, i18n("Full &name:"), topFrame);
topLayout->addWidget(mNameLabel,1,0);
- topLayout->addWidget(mNameEdit,1,1);
+ QWhatsThis::add( mNameLabel,
+ i18n( "Enter here your full name. This name will be "
+ "displayed as \"Organizer\" in tasks and "
+ "events you create." ) );
+topLayout->addWidget(mNameEdit,1,1);
+ QWhatsThis::add( mNameEdit,
+ i18n( "Enter here your full name. This name will be "
+ "displayed as \"Organizer\" in tasks and "
+ "events you create." ) );
mEmailEdit = new QLineEdit(topFrame);
connect( mEmailEdit, SIGNAL( textChanged( const QString & ) ),
SLOT( slotWidChanged() ) );
mEmailLabel = new QLabel(mEmailEdit, i18n("E&mail address:"),topFrame);
topLayout->addWidget(mEmailLabel,2,0);
+ QWhatsThis::add( mEmailLabel,
+ i18n( "Enter here your e-mail address. This e-mail address "
+ "will be used to identify the owner of the calendar, "
+ "and displayed in events and tasks you create." ) );
topLayout->addWidget(mEmailEdit,2,1);
+ QWhatsThis::add( mEmailEdit,
+ i18n( "Enter here your e-mail address. This e-mail address "
+ "will be used to identify the owner of the calendar, "
+ "and displayed in events and tasks you create." ) );
KPrefsWidBool *bcc =
addWidBool( KOPrefs::instance()->bccItem(), topFrame );
@@ -120,7 +136,14 @@
intervalBox->setSpacing( KDialog::spacingHint() );
QLabel *autoSaveIntervalLabel = new QLabel(i18n("Save &interval in \
minutes:"),intervalBox); + QWhatsThis::add( autoSaveIntervalLabel,
+ i18n( "Set on this spin box the interval in minutes between "
+ "automatic saves of calendar data." ) );
+
mAutoSaveIntervalSpin = new QSpinBox(0,500,1,intervalBox);
+ QWhatsThis::add( mAutoSaveIntervalSpin,
+ i18n( "Set on this spin box the interval in minutes between "
+ "automatic saves of calendar data." ) );
connect( mAutoSaveIntervalSpin, SIGNAL( valueChanged( int ) ),
SLOT( slotWidChanged() ) );
autoSaveIntervalLabel->setBuddy(mAutoSaveIntervalSpin);
@@ -208,8 +231,15 @@
QHBox *timeZoneBox = new QHBox( topFrame );
topLayout->addMultiCellWidget( timeZoneBox, 0, 0, 0, 1 );
- new QLabel( i18n("Timezone:"), timeZoneBox );
+ QLabel *timeZoneLabel = new QLabel( i18n("Timezone:"), timeZoneBox );
+ QWhatsThis::add( timeZoneLabel,
+ i18n( "Select your timezone from the list of locations "
+ "on this drop down box. If your city is not "
+ "listed, select one which shares the same "
+ "timezone. KOrganizer will automatically adjust "
+ "for daylight savings." ) );
mTimeZoneCombo = new QComboBox( timeZoneBox );
+
connect( mTimeZoneCombo, SIGNAL( activated( int ) ),
SLOT( slotWidChanged() ) );
@@ -289,21 +319,32 @@
}
mTimeZoneCombo->setCurrentItem(nCurrentlySet);
- QWhatsThis::add( mTimeZoneCombo, i18n( "Select the timezone." ) );
+ QWhatsThis::add( mTimeZoneCombo,
+ i18n( "Select your timezone from the list of locations "
+ "on this drop down box. If your city is not "
+ "listed, select one which shares the same "
+ "timezone. KOrganizer will automatically adjust "
+ "for daylight savings." ) );
// holiday region selection
QHBox *holidayRegBox = new QHBox( topFrame );
topLayout->addMultiCellWidget( holidayRegBox, 1, 1, 0, 1 );
- new QLabel( i18n( "Use holiday region:" ), holidayRegBox );
+ QLabel *holidayLabel = new QLabel( i18n( "Use holiday region:" ), \
holidayRegBox ); + QWhatsThis::add( holidayLabel,
+ i18n( "Select from which region you want to use the "
+ "holidays here. Defined holidays are shown as "
+ "non-working days in the date navigator, the "
+ "agenda view, etc." ) );
+
mHolidayCombo = new QComboBox( holidayRegBox );
connect( mHolidayCombo, SIGNAL( activated( int ) ),
SLOT( slotWidChanged() ) );
QWhatsThis::add( mHolidayCombo,
- i18n( "Here you can select from which region you want "
- "to use the holidays. Defined holidays are shown "
- "as non-working days in the date navigator, the "
+ i18n( "Select from which region you want to use the "
+ "holidays here. Defined holidays are shown as "
+ "non-working days in the date navigator, the "
"agenda view, etc." ) );
QString currentHolidayName;
@@ -360,9 +401,15 @@
alarmList << i18n( "1 minute" ) << i18n( "5 minutes" )
<< i18n( "10 minutes" ) << i18n( "15 minutes" )
<< i18n( "30 minutes" );
- topLayout->addWidget( new QLabel( i18n( "Default alarm time:" ),
- topFrame), 5, 0 );
+ QLabel *alarmLabel = new QLabel( i18n( "Default alarm time:" ), topFrame);
+ topLayout->addWidget( alarmLabel, 5, 0 );
+ QWhatsThis::add( alarmLabel,
+ i18n( "Enter the default alarm time for incidences "
+ "here." ) );
mAlarmTimeCombo = new QComboBox( topFrame );
+ QWhatsThis::add( mAlarmTimeCombo,
+ i18n( "Enter the default alarm time for incidences "
+ "here." ) );
connect( mAlarmTimeCombo, SIGNAL( activated( int ) ),
SLOT( slotWidChanged() ) );
mAlarmTimeCombo->insertStringList( alarmList );
@@ -385,6 +432,13 @@
}
int index = ( i + weekStart + 6 ) % 7;
mWorkDays[ index ] = new QCheckBox( weekDayName, workDaysBox );
+ QWhatsThis::add( mWorkDays[ index ],
+ i18n( "Check this box to make KOrganizer mark the "
+ "working hours for this day of the week. "
+ "If this is a work day for you, check "
+ "this box, or the working hours will not be "
+ "marked with color." ) );
+
connect( mWorkDays[ index ], SIGNAL( stateChanged( int ) ),
SLOT( slotWidChanged() ) );
}
@@ -693,9 +747,16 @@
mCategoryCombo = new QComboBox(categoryGroup);
mCategoryCombo->insertStringList(KOPrefs::instance()->mCustomCategories);
+ QWhatsThis::add( mCategoryCombo,
+ i18n( "Select here the event category you want to modify. "
+ "You can change the selected category color using "
+ "the button below." ) );
connect(mCategoryCombo,SIGNAL(activated(int)),SLOT(updateCategoryColor()));
mCategoryButton = new KColorButton(categoryGroup);
+ QWhatsThis::add( mCategoryButton,
+ i18n( "Choose here the color of the event category selected "
+ "using the combo box above." ) );
connect(mCategoryButton,SIGNAL(changed(const QColor &)),SLOT(setCategoryColor()));
updateCategoryColor();
@@ -705,10 +766,16 @@
topLayout->addMultiCellWidget(resourceGroup,8,8,0,1);
mResourceCombo = new QComboBox(resourceGroup);
-
+ QWhatsThis::add( mResourceCombo,
+ i18n( "Select here resource you want to modify. "
+ "You can change the selected resource color using "
+ "the button below." ) );
connect(mResourceCombo,SIGNAL(activated(int)),SLOT(updateResourceColor()));
mResourceButton = new KColorButton(resourceGroup);
+ QWhatsThis::add( mResourceButton,
+ i18n( "Choose here the color of the resource selected "
+ "using the combo box above." ) );
connect(mResourceButton,SIGNAL(changed(const QColor &)),SLOT(setResourceColor()));
updateResources();
@@ -844,20 +911,58 @@
topLayout->addMultiCellWidget(schedulerGroup->groupBox(),0,0,0,1);
#endif
+ QLabel *aMailsLabel = new QLabel(i18n("Additional email addresses:"),topFrame);
+ QWhatsThis::add( aMailsLabel,
+ i18n( "Add, edit or remove additional e-mails addresses "
+ "here. These email addresses are the ones you "
+ "have in addition to the one set in personal "
+ "preferences. If you are an attendee of one event, "
+ "but use another email address there, you need to list"
+ "this address here so KOrganizer can recognize "
+ "it as yours." ) );
+ topLayout->addMultiCellWidget(aMailsLabel,2,2,0,1);
+ mAMails = new QListView(topFrame);
+ QWhatsThis::add( mAMails,
+ i18n( "Add, edit or remove additional e-mails addresses "
+ "here. These email addresses are the ones you "
+ "have in addition to the one set in personal "
+ "preferences. If you are an attendee of one event, "
+ "but use another email address there, you need to list"
+ "this address here so KOrganizer can recognize "
+ "it as yours." ) );
- topLayout->addMultiCellWidget(new QLabel(i18n("Additional email \
addresses:"),topFrame),2,2,0,1);
- mAMails = new QListView(topFrame);
mAMails->addColumn(i18n("Email"),300);
topLayout->addMultiCellWidget(mAMails,3,3,0,1);
- topLayout->addWidget(new QLabel(i18n("Additional email address:"),topFrame),4,0);
+ QLabel *aEmailsEditLabel = new QLabel(i18n("Additional email address:"),topFrame);
+ QWhatsThis::add( aEmailsEditLabel,
+ i18n( "Edit additional e-mails addresses here. To edit an "
+ "address select it from the list above "
+ "or press the \"New\" button below. These email "
+ "addresses are the ones you have in addition to the "
+ "one set in personal preferences. " ) );
+ topLayout->addWidget(aEmailsEditLabel,4,0);
aEmailsEdit = new QLineEdit(topFrame);
+ QWhatsThis::add( aEmailsEdit,
+ i18n( "Edit additional e-mails addresses here. To edit an "
+ "address select it from the list above "
+ "or press the \"New\" button below. These email "
+ "addresses are the ones you have in addition to the "
+ "one set in personal preferences. " ) );
aEmailsEdit->setEnabled(false);
topLayout->addWidget(aEmailsEdit,4,1);
QPushButton *add = new QPushButton(i18n("New"),topFrame,"new");
+ QWhatsThis::add( add,
+ i18n( "Press this button to add a new entry to the "
+ "additional e-mail addresses list. Use the edit "
+ "box above to edit the new entry." ) );
topLayout->addWidget(add,5,0);
QPushButton *del = new QPushButton(i18n("Remove"),topFrame,"remove");
+ QWhatsThis::add( del,
+ i18n( "Press this button to remove the currently selected "
+ "entry from the additional e-mail addresses "
+ "list." ) );
topLayout->addWidget(del,5,1);
//topLayout->setRowStretch(2,1);
_______________________________________________
kde-pim mailing list
kde-pim@kde.org
https://mail.kde.org/mailman/listinfo/kde-pim
kde-pim home page at http://pim.kde.org/
[prev in list] [next in list] [prev in thread] [next in thread]
Configure |
About |
News |
Add a list |
Sponsored by KoreLogic