| Name |
Value |
Description |
| class |
|
Each Item-Tag must have a class, which determines the text to show or the function it provides. If there is only a classname given, then any other values for an instance of this class (on today-screen) will get the default. |
|
battery_ac_icons |
Leftmost icons for battery/ac in first row. |
|
battery_meter |
Batterylevel, which will be drawn and percentage as text, e.g.
100% |
|
mobile_operator_homezone |
Mobile operator with homezone-icon. |
|
mobile_operator |
Mobile operator, where you can provide your network provider logo. |
|
cell_broadcast_message |
Cell broadcast messages limited to 160 characters. |
|
cpuspeed |
e.g.
195 MHz |
|
cpu_utilization |
Cpu-utilization, which will be drawn and percentage as text, e.g.
1% |
|
memory_program |
Free program memory, e.g.
25 MB |
|
memory_data |
Free data memory, e.g.
25 MB |
|
memory_sdcard |
Free memory on sd-card, e.g.
4.0 GB |
|
temperature |
Battery-temperature, e.g.
30 C |
|
powerdrain |
e.g.
64 mA 500 mW |
|
phone_signal |
e.g.
90% |
|
calltimes_out_sms |
Outgoing calltimes with outgoing sms (monthly/daily), e.g.
T: 00:00:00, M: 00:00:00, SMS 200 |
|
calltimes_in_sms |
Incoming calltimes with incoming sms (monthly/daily), e.g.
T: 00:00:00, M: 00:00:00, SMS 200 |
|
calltimes_inout_sms |
Incoming + outgoing calltimes with incoming + outgoing sms (monthly/daily), e.g.
T: 00:00:00, M: 00:00:00, SMS 200 |
|
calltimes_out |
Outgoing calltimes (monthly/daily), e.g.
T: 00:00:00, M: 00:00:00 |
|
calltimes_in |
Incoming calltimes (monthly/daily), e.g.
T: 00:00:00, M: 00:00:00 |
|
calltimes_inout |
Incoming + outgoing calltimes (monthly/daily), e.g.
T: 00:00:00, M: 00:00:00 |
|
calltimes_out_day |
Daily outgoing calltimes, e.g.
T: 00:00:00 |
|
calltimes_in_day |
Daily incoming calltimes, e.g.
T: 00:00:00 |
|
calltimes_inout_day |
Daily incoming+outgoing calltimes, e.g.
T: 00:00:00 |
|
calltimes_out_month |
Monthly outgoing calltimes, e.g.
T: 00:00:00 |
|
calltimes_in_month |
Monthly incoming calltimes, e.g.
T: 00:00:00 |
|
calltimes_inout_month |
Monthly incoming+outgoing calltimes, e.g.
T: 00:00:00 |
|
data_summed_up |
Summary of data-traffic (monthly + daily traffic, monthly online duration), e.g.
D: 200MB, M: 800MB, T:64:23.12
Note: This class needs at least one of the calltimes-class active, as it is structued in the options!! |
|
data_month |
Monthly traffic, e.g.
M: 800MB
Note: This class needs at least one of the calltimes-class active, as it is structued in the options!! |
|
data_month_sent |
Monthly traffic sent, e.g.
M: 800MB
Note: This class needs at least one of the calltimes-class active, as it is structued in the options!! |
|
data_month_received |
Monthly traffic received, e.g.
M: 800MB
Note: This class needs at least one of the calltimes-class active, as it is structued in the options!! |
|
data_day |
Daily traffic, e.g.
D: 100MB
Note: This class needs at least one of the calltimes-class active, as it is structued in the options!! |
|
data_day_sent |
Daily traffic sent, e.g.
D: 100MB
Note: This class needs at least one of the calltimes-class active, as it is structued in the options!! |
|
data_day_received |
Daily traffic received, e.g.
D: 100MB
Note: This class needs at least one of the calltimes-class active, as it is structued in the options!! |
|
data_traffic_remain |
Remaining traffic from limit, e.g.
Remain: 10MB, 2%
Note: This class needs at least one of the calltimes-class active, as it is structued in the options!! |
|
data_conn |
Number of monthly established connections, e.g.
C: 198
Note: This class needs at least one of the calltimes-class active, as it is structued in the options!! |
|
data_duration_month |
Online duration (month), e.g.
M: 34:23.12
Note: This class needs at least one of the calltimes-class active, as it is structued in the options!! |
|
data_duration_day |
Online duration (day), e.g.
D: 01:23.12
Note: This class needs at least one of the calltimes-class active, as it is structued in the options!! |
|
sms_out |
Monthly outgoing SMS, e.g.
SMS 450 |
|
sms_in |
Monthly incoming SMS, e.g.
SMS 450 |
|
sms_inout |
Monthly incoming+outgoing SMS, e.g.
SMS 450 |
|
wifi_state |
WiFi-States, AP, +WPA2, connecting MyNetwork |
|
wifi_networks |
if version=”0″ or no version given for Window, then the given height for the enclosing View will not be adopted to the row-number set in options.
if version=”1″ then the height supplied for (in enclosing View) is used for 5 available WiFi-Networks. If you change in options to show e.g. only 2 networks, then the new height will be calculated in the following manner: (givenHeight/5)*2.
if version=”1″ and no height (in eclosing View) is given, then anything will be handled automatically (recommended). -90 dBm, 6 ch, WEP, MyNetwork
-90 dBm, 6 ch, WEP, MyNetwork1
-90 dBm, 6 ch, WEP, MyNetwork2
---
--- |
|
registry_tracker |
This class allows to track registry values (DWORD/String) by means of Notification Broker. Supply a registry-path in the key_value-attribute of registry-Tag and each time the registry-value changes, it will be refreshed on todayscreen.
You can supply the registry-Tag either within label-Tag or within the Item-Tag, depending on the type you want to show on todayscreen. If you want a label to have a customizeable text, then the label-tag must have a text-attribute as follows:
<label text="%d missed" >
<registry keyvalue=
"HKCU\System\State\Phone\Missed Call Count"
mask="0xFF" />
</label>
If you want an images-only indicator then supply as follows:
<Item class="registry_tracker" >
<image src="image%d" />
<registry keyvalue=
"HKCU\System\State\Phone\Missed Call Count"
mask="0xFF" />
</Item>
where:
text must be a pattern to render the registry value. You must use %d for DWORDs and %s for Strings.
btw. you can also use c/c++ formatstrings like “0x%.8x” for hexvalue-rendering.
key_value must be a valid path in the registry where you can use both formats, that is HKLM as well as HKEY_LOCAL_MACHINE.
You can also supply a mask-attribute within registry-Tag to apply to the value before displaying. The mask is applied as an binary and-operator to the value, e.g. regsitry-value & mask. Search wikipedia for binary and-operator.
You can also supply a formatted path to the path of image (in src-attribute) to show an image depending on registry-value,
e.g. <image src=”filename%d.ext” …> for dword-value or <image src=”filename%s.ext” …> for a string-value.
if there is no image correlated to the registry-value, then filename-1.ext (dword) or filename_empty.ext (string) will be used, that is such an image MUST exist.
Note: The images have to be of same type, e.g. same bitcount.
Invalid-Characters like \,& and so on in filenames for the images will be replaced with “_”.
see sample for registry_tracker.
Head over to rotlaus.com for a list of useful registry-values. |
|
date |
shows the date formated according to a formststring given in text-attribute. The formatstring must fit msdn.
e.g. text=” MMMM dd/yyyy “ |
|
clock |
shows the time formated according to a formststring given in text-attribute. The formatstring must fit msdn.
e.g. text=” hh’:'mm’:’ss tt” |
|
clock_digit |
To customize a digit-clock you must have
four Item-tags with clock_digit
one Item-tag with clock_seperator
one Item-tag with clock_alarm
one Item-tag with clock_apm
There must be png-files for any digits, seperator, alarm and am/pm under theme-folder with following filename:
empty.png, 0.png, 1.png, 2.png, 3.png, 4.png, 5.png, 6.png, 7.png, 8.png, 9.png, alarmon.png, alarmoff.png, am.png, pm.png, seperator.png
Notice: Each of the digits 0,1,2,3,4,5,6,7,8,9,empty MUST be of same size!
Any image for digit-clock must be of same type, e.g. any image must be 32bpp for using alpha-channel!!! Otherwise they will not be drawn !!!
You can have only one digit-clock in a view, and only one clock can be painted for a window, that is you can have several views with a digit-clock, but only one should be visible at any time.
see sample for digit-clock. |
|
clock_seconds |
To customize a digit-clock with seconds you must have a basic-digit clock specified! In addition to that you need:
two Item-tags with clock_seconds
optional one Item-tag with clock_seconds_sep
If no images for seconds-digits are given, then the images from digit-clock will be used. For this case it is a good idea to make them smaller by resize them. This can be done by adding a resize-attribute to the first seconds-class.
If you want to supply images for second-digits, they must be png-files for any digits, seperator under theme-folder with following filename:
emptys.png, 0s.png, 1s.png, 2s.png, 3s.png, 4s.png, 5s.png, 6s.png, 7s.png, 8s.png, 9s.png, seperators.png
Notice: Each of the digits 0,1,2,3,4,5,6,7,8,9,empty MUST be of same size !!! Otherwise the will not be drawn !!!
see sample for digit-clock with seconds. |
|
clock_seperator |
places the seperator-png for clock_digits, e.g. 01:00 |
|
clock_alarm |
places the alarmon/alarmoff-pngs |
|
clock_apm |
places the am/pm-pngs |
|
start_app |
This class shows the application-icon of the program given in path-attribute and starts the program on tap.
Note: path is mandatory for the class start_app!
A second program can be specified with path1-attribute which opens on hold (tap and hold) on the icon.
Relative or Absolute: The path-attribute can have either an absolute path with the full pathname to the program or a relative pathname.
Absolute pathnames begin with the character ‘\’, e.g.
- \Windows\Calc.exe
- \Program Files\HomeScreen PlusPlus\tinybatch.exe
Relative pathnames are anchored to the theme-folder and addresses files within the theme-folder. Given that the name of your theme is “MyTheme” and the theme-folder is “\Program Files\HomeScreen PlusPlus\MyTheme”:
- “Calc.exe” - points to the file “\Program Files\HomeScreen PlusPlus\MyTheme\Calc.exe”
- “tinybatch.exe” - points to the file “\Program Files\HomeScreen PlusPlus\MyTheme\tinybatch.exe”
- “..\tinybatch.exe” - points to the file “\Program Files\HomeScreen PlusPlus\tinybatch.exe”
- “..\..\totalcmd\cecmd.exe” - points to the file “\Program Files\totalcmd\cecmd.exe”
A title to render for the icon can be specified with title-attribute.
A title to be displayed can be given in title-attribute.
You can add arguments for the programs to start by seperate them with double-colon, e.g.
\Program Files\MemMaid\MemMaid.exe ::-Free
see sample for start_app! |
|
space |
implements a placeholder, which can be customized with an image, label and actions. The default-type of a space is type=”icon”!
A space supports the text-attribute as follows, e.g. drawing a custom text:
<Item class="space" type="value" >
<label text="Hello World!" width="60" />
</Item> |
|
tPlug |
set a regular today-plugin.
|
형 태