APPX Widget Macros
APPX provides special functionality for various widgets via the use of macro commands that can be inserted in the Tooltip field on the Widget Properties screen or by updating the Widget file at runtime (for those widgets that do not have a tooltip field on the Widget Properties screen, Table Widgets for example). The following table lists some of the macros that can be used:
Additionally, macros can be used to specify colors where levels of opacity (or, thought of the other way, transparency) are desired. An additional pair of bytes is appended to the RGB color value, which corresponds to the COLOR NL field in the Widget file. Values of zero (hex 00) through 255 (hex FF) are valid for opacity, but 00 and 01 retain their original purpose and values - 00 makes a widget completely transparent, while 01 or FF makes it completely opaque. For example, specifying a color as #FF0000FF or #FF000001 would be solid red, while #FF000000 would be fully transparent and therefore invisible; #FF000080 would provide 50% transparency to the widget.
To use these in Widget Properties, set the appropriate macro below to the hex value desired in the Tooltip field (e.g.,
@SFC=#005872A4)
Macro |
Applies Color and Opacity To |
@SFC or @SEFC |
Enabled Foreground |
@SBC or @SEBC |
Enabled Background |
@SDFC |
Disabled Foreground |
@SDBC |
Border (Disabled Background is controlled by OS desktop settings) |
@SRFC |
Rollover Foreground |
@SRBC |
Rollover Background |
@SWBC |
Wallpaper Background |
Multiple macros can be specified for a single widget by simply appending them together. For example, to turn off both the row numbers and the footer bar on a table widget, set WIDGET TOOLTIP to
@TSRN=N@TSFB=N
--
AlKalter - 2012-07-10