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
@TCR	Table Widgets	Columns Resizable	Lets the designer control whether the user can resize the column @TCR=T (default) or @TCR=F (can be overridden at column level)
@TCS	Table Widgets	Columns Sortable	Lets the designer control whether the user can sort by the columns @TCS=T (default) or @TCS=F (can be overridden at column level)
@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.
@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
@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
@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.
@TSHB	Table Widgets	Show Header Bar (Column Labels)	Lets the designer turn on or off the display of the column heading row. @TSHB=T or F. Default is T.
@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
@TSMC	Table Widgets	Columns Movable	Lets the designer control whether the user can move the columns by mouse drag
@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
@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.
@TSTR	Table Widgets	Show Reset Button	Lets the designer show or hide the "Reset to Default" button, which allows 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
@TSTRF	Table Widgets	Show Table Refresh	Lets the designer show or hide the user option to refresh the table. @TSTRF=T (default) or @TSTRF=F.
@TSTS	Table Widgets	Show Table Search	Lets the designer show or hide the user option to search the table. @TSTS=T (default) or @TSTS=F.
@TCR	Table Columns	Column Resizable	Lets the designer control whether the user can resize the column @TCR=T (default) or @TCR=F
@TCS	Table Columns	Column Sortable	Lets the designer control whether the user can sort by the column @TCS=T (default) or @TCS=F
@TCSE	Table Columns	Column Searchable	Lets the designer control whether the user can search for values in the column @TCSE=T (default) or @TCSE=F
@TCST	Table Columns	Column Sort Type	Lets the designer control whether how the column is sorted. TCST=INT, FLOAT, DATE, or TEXT
@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)

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