Tags:
Widget Macros1Add my vote for this tag create new tag
view all tags

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

Edit | Attach | Watch | Print version | History: r18 < r17 < r16 < r15 < r14 | Backlinks | Raw View | Raw edit | More topic actions
Topic revision: r18 - 2020-07-06 - BrianRyan
 
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