애아빠 데이터 개발자 블로거 Cardia

• 0 = no animation for switching Views.
• 1 = (default) left slide in animation.
• 2 = right slide in animation.
• 3 = top down slide in animation.
• 4 = bottom up slide in animation.
• 5 = left page flip animation
• 6 = right page flip animation
• 9 = left in cube
• 10 = right in cube
• 14 = zoom in
• 15 = zoom in with left leave
• 16 = zoom in with right leave
• 20 = alpha blend in
• 21 = alpha blend in with left leave
• 22 = alpha blend in with right leave

• missing attribute = the theme-background (watermark) is used for drawing the background.
• 0xFF000000 = use background of default todayscreen for drawing the background.
• BGR-Color = Filled rectangle with color in BGR-Colorformat

animatebg=”0″ -> black color is used (0×000000): BGR -> Black = 00, Green = 00, Red = 00
animatebg=”0xFFFFFF” -> white color is used: BGR -> Black = FF, Green = FF, Red = FF (whereas 0xFF is hexadecimal and is 255 in decimal).

0: (default) By default each Row is selected en bloc.
1: Each contained Item can be selected using navigation-keys.
2: Keep selected state even if Row is not visible.
3: Execute Action as soon as Item gets selected.


Use negative values for preventing the action of rightmost item to be executed if dpad-right is pressed, e.g. itemselect=”-1″

-x: Item will be moved to lower-right by x-pixel.
0: (default) No selection-effect but drawing background.
x: Item will be streched by x-pixels.

0: (default) No repositioning
1: Reposition the containing Views if required.

-x: Item will be moved to lower-right by x-pixel.
0: (default) No selection-effect but drawing background.
x: Item will be streched by x-pixels.

Note: Don’t extend a View if it’s not needed, because it could reduce render performance.

2. If a height is given, then it will be used for the current View.
2.1 Furthermore it will be used for any subsequent View of the enclosing Row too (unless a new height is given).

0: (default) View shall be handled as 1 line.
1: Contained Items shall be handled as multiple lines

0: dont adpat the View to width.
1: (default) adapt width of last item to fit new width

-x: Item will be moved to lower-right by x-pixel.
0: (default) No selection-effect but drawing background.
x: Item will be streched by x-pixels.

0: (default) no sliding of that View.
1: slide the View

100%

195 MHz

1%

25 MB

25 MB

4.0 GB

30 C

64 mA

500 mW

90%

T: 00:00:00, M: 00:00:00, SMS 200

T: 00:00:00, M: 00:00:00, SMS 200

T: 00:00:00, M: 00:00:00, SMS 200

T: 00:00:00, M: 00:00:00

T: 00:00:00, M: 00:00:00

T: 00:00:00, M: 00:00:00

T: 00:00:00

T: 00:00:00

T: 00:00:00

T: 00:00:00

T: 00:00:00

T: 00:00:00

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!!

M: 800MB

Note: This class needs at least one of the calltimes-class active, as it is structued in the options!!

M: 800MB

Note: This class needs at least one of the calltimes-class active, as it is structued in the options!!

M: 800MB

Note: This class needs at least one of the calltimes-class active, as it is structued in the options!!

D: 100MB

Note: This class needs at least one of the calltimes-class active, as it is structued in the options!!

D: 100MB

Note: This class needs at least one of the calltimes-class active, as it is structued in the options!!

D: 100MB

Note: This class needs at least one of the calltimes-class active, as it is structued in the options!!

Remain: 10MB, 2%

Note: This class needs at least one of the calltimes-class active, as it is structued in the options!!

C: 198

Note: This class needs at least one of the calltimes-class active, as it is structued in the options!!

M: 34:23.12

Note: This class needs at least one of the calltimes-class active, as it is structued in the options!!

D: 01:23.12

Note: This class needs at least one of the calltimes-class active, as it is structued in the options!!

SMS 450

SMS 450

SMS 450

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

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

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.

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.

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!

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>

• The name of the plugin must be given in title-attribute.
• (Optional) Position can be specified with label-tag (left/top/height/width), if height-attribute or width-attribute is 0 then they will be handled automatically
• (Optional) using left/right-gesture for view-switching can be specified with gesture-attribute in Item-tag.
• (Optional) unload plugin if the surrounding View is not visible: Use unload-attribute in Item-tag.
  unload=”1″ (unload plugin), unload=”0″ (default, don’t unload plugin )
• (Optional) caching of background-image / watermark for plugin: Use cachebg-attribute in Item-tag. Use cachebg-attribute in Item-tag.
  cachebg=”1″ (default, cache background-image for plugins / reduces system load for drawing background-image), cachebg=”0″ (don’t cache background-image)

  e.g. placing PocketMSN-Plugin in one Row:

  <Row>
    <View>
      <Item class="tPlug" title="Pocket MSN" >
        <label left="-28" />
      </Item>
    </View>
  </Row>

  e.g. placing PocketMSN and Messaging-Plugin in one Row:

  <Row>
    <View>
      <Item class="tPlug" title="Pocket MSN" gesture="1" >
        <label top="0" left="-28" width="120" />
      </Item>
      <Item class="tPlug" title="&quot;Messaging&quot;"
               gesture="1" unload="1">
        <label height="32" width="120" />
      </Item>
    </View>
  </Row>

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”

e.g. if you want to open the inbox of a particular email-account use
ontap=”StartApp”

and
path=”\Windows\tmail.exe ::-service Name_of_Email_Account -open inbox”

e.g. if you want make a call to 123456 use
path=”\Windows\cprog.exe ::-url tel: 123456″

e.g. if you want to open tasks use
path=”\Windows\tasks.exe”

Note: you must use xml-entities within quotes, e.g. use ” instead of ” !!!

These indexes specify which tab of system-settings-panel to open. The action opens ctlpnl.cpl with the given indexes.
e.g. to open time-settings ontap=”CtlPnl” index=”16″

Search for ctlpnl.cpl or cplmain.exe for lists of available tabs.
e.g. pocketpcdn.com, xs4all.nl, asusmobile.ru

• param: path-attribute (the windows’ class name)
• param: title-attribute (the windows’ title (Optional))
• param: msg-attribute (the numeric window message)
• param: index-attribute (the numeric wParam)
• param: subindex-attribute (the numeric lParam (Optional))

e.g.

• ontap=”Message” path=”HHTaskBar” msg=”1156″ index=”2″ (Send msg=1156 to Taskbar-Window with wParam=2 - Set Vibra Mode)
• ontap=”Message” path=”HHTaskBar” msg=”1156″ index=”0″ (Set Normal Sound Mode)
• ontap=”Message” path=”HHTaskBar” msg=”1156″ index=”3″ (Set Silent Mode)

• index/subindex for the first Row/View
• index_1/subindex_1 for the second Row/View
• index_2/subindex_2 for the third Row/View
• index_3/subindex_3 for the third Row/View
• index_4/subindex_4 for the third Row/View

If switching several Views, then the Row-number for index to index_2 must be ascending order.

1
2
3
4
5

<Item ... ontap="View" index="0" subindex="1"
 index_1="2" subindex_1="1"
 index_2="3" subindex_2="1" >
   ...
<Item />

class date: formatstring for date according to msdn

When using this attribute, the given image should be a png/jpeg/gif.
If you are using a bmp, then the color will be used for transparent-color as well.

If the multi-attribute of the surrounding View is 1 (multi=”1″), then the default height of a label is 16. If your label is larger than 16 pixel, then you must adapt this attribute to the desired height in pixel.

If the multi-attribute of the surrounding View is 0 (multi=”0″), then the height of the label is the same as the height of the surrounding View.