APPX Widget Macros

APPX provides special functionality for various widgets via the use of macro commands that can be inserted in the Tooltip or Label 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:

Macro Applies To Description Details
@SDS All Widgets Drop Shadow http://wiki.appx.com/wiki/bin/view/Main/WidgetDropShadows
@SLN All Widgets Widget Layering http://wiki.appx.com/wiki/bin/view/Main/WidgetLayering
@CLSS All Widgets Assign CSS Class Assign a Class to a widget for display with the browser client
@SFP Button Widgets Control Focus Painting Lets the designer turn on or off the painting of the focus of buttons. @SFP=T or F. Default is T.
@SMV Button Widgets Make Button Movable http://wiki.appx.com/wiki/bin/view/Main/WidgetSetMovable
@SLL Dropdown Lists Modify List Contents http://wiki.appx.com/wiki/bin/view/Main/WidgetLocalLists
@SFF File Choosers Extension Filters http://wiki.appx.com/wiki/bin/view/Main/WidgetFileChooser
@SLUB Line Widgets Line Unit Base Setting http://wiki.appx.com/wiki/bin/view/Main/WidgetLine
@SSP Line Widgets Line Stroke Pattern http://wiki.appx.com/wiki/bin/view/Main/WidgetLine
@SSPO Line Widgets Line Stroke Pattern Offset http://wiki.appx.com/wiki/bin/view/Main/WidgetLine
@TSRN Table Widgets Show Row Numbers Lets the designer turn on or off the display of row numbers in the HTML client. @TSRN=T or F. Default is T.
@TSFB Table Widgets Show Footer Bar Lets the designer turn on or off the display of the entire table footer bar in the HTML client. @TSFB=T or F. Default is T.
@TSPO Table Widgets Show Paging Option Lets the designer show or hide the Paging Option toggle switch in the footer bar. @TSPO=T (default) or @TSPO=F
@TSCC Table Widgets Show Column Chooser Lets the designer show or hide the Column Chooser option in the footer bar. @TSCC=T (default) or @TSCC=F
@TSLS Table Widgets Show Layout Save Lets the designer show or hide the button allowing the user to save a customized table layout. @TSLS=T (default) or @TSLS=F
@TSTR Table Widgets Show Table Refresh Lets the designer show or hide the button allowing the user to refresh and restore the default layout of the table columns,
replacing the current or saved layout. @TSTR=T (default) or @TSTR=F
@TCSV Table Widgets Show CSV Export Option Lets the designer show or hide the user option to generate CSV files from the table. @TCSV=T (default) or @TCSV=F
@TCSS Table Widgets Case Sensitive Sort Turns on or off case sensitive sorting in the HTML client. @TCSS=T is case sensitive sort, F is case insensitive sort.
@FULC File upload/download Turn off Local Connector @FULC=N forces the HTML client to use the browser for uploading/downloading files. See HTML Client Installation
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)

MacroSorted ascending Applies Color and Opacity To
@SBC or @SEBC Enabled Background
@SDBC Border (Disabled Background is controlled by OS desktop settings)
@SDFC Disabled Foreground
@SFC or @SEFC Enabled Foreground
@SRBC Rollover Background
@SRFC Rollover Foreground
@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

Edit | Attach | Watch | Print version | History: r18 | r16 < r15 < r14 < r13 | Backlinks | Raw View | Raw edit | More topic actions...
Topic revision: r14 - 2018-11-15 - AlKalter
 
  • Edit
  • Attach
This site is powered by the TWiki collaboration platform Powered by PerlCopyright © 2008-2024 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback