Advanced Canvas Control Attributes
From Lianjapedia
Revision as of 11:01, 10 February 2016 by Yvonne.milne (Talk | contribs)
Under construction
Contents
Details
Attribute | Description |
---|---|
Name | The name for this field (unique to the section) |
Meta types | A comma separated list of metatype names |
Type | The type of control: field (readonly) |
Geometry
Attribute | Description |
---|---|
Top | Top position in pixels |
Left | Left position in pixels |
Width | Width in pixels |
Height | Height in pixels |
Background widget | Lower this widget underneath as a background widget (True | False) |
Appearance
Attribute | Description |
---|---|
CSS style | CSS style (separate attributes with ; or use app:/filename.css) |
Caption position | The position of the caption (None | Above | Beside | RightToLeft) |
Caption size | The size of the caption (Small | Medium | Large | Largest) |
Caption width | The width of the caption in pixels. |
Shading | The shading to be applied to the field (None | Light | Dark) |
Transparency | The transparency type to be applied to the field (None | Light | Dark | Custom) |
Border-radius | Specify a border radius |
Caption
Attribute | Description |
---|---|
Show caption | Show the caption for the field (True | False) |
Caption | The caption for the field |
Background color | The background color for the caption |
Foreground color | The foreground color for the caption |
Font | The font for the caption |
Icon | The image for the caption (png | jpg | gif). Use app:/imagename.ext for app specific images. |
Border width | The caption border width |
Border color | The caption border color |
Transparency | Specify a transparency percentage from 0 to 100 |
Gradient colors | Render the caption color as a gradient (True | False) |
Gradient type | Specify the gradient type |
Gradient start color | Gradient start color |
Gradient end color | Gradient end color |
Data
Attribute | Description |
---|---|
Inherit dictionary rules | Inherit the data dictionary rules (True | False) |
Data source | The table and column that this field is bound to. Specify m.varname to bind to a memory variable. |
Anchor | |
Tab order | The tab order for this field. |
Search field* | This field is its Section Search field (True | False) |
Default search field* | This field is its Section default search field (True | False) |
User selectable search field* | The user can select this as the Section search field interactively by clicking on it (True | False) |
Hide search field indicator* | Hide the search field indicator (True | False) |
Search panel field* | Include this field in an auto created Section search panel (True | False) |
Relate on change* | Relate child Sections when data is changed interactively (True | False) |
Recalculate* | Recalculate readonly and calculated fields when data is changed interactively (True | False) |
Background color | The background color for the data |
Foreground color | The foreground color for the data |
Font | The font for the data |
Data size | The size of the data (Small | Medium | Large | Largest) |
Default | Default value as an expression, e.g. date(), 0.0, space(10) |
Input mask type* | The inputmask type (Custom | Currency | Date | Email Address | Number | Text | Time | Alphabetic | Upper Case | Upper Case Alphabetic) |
Input mask* | The inputmask for the field, e.g. @c2, @c4, @!, @^, 999,999.99 or ?regularexpression |
Placeholder text* | Text to display as grayed-out placeholder text when the field is empty and does not have focus |
Password input* | Echo characters input as * for entering passwords (True | False) |
Return tabs* | Treat the return key as a Tab on this field (True | False) |
Mandatory input* | Data must be entered in this field (True | False) |
Choices* | Restrict data input to a list of choices, e.g. Static list of choices: Apples,Oranges,Bananas Dynamic list of choices from a table: @tablename,expression Dynamic list of choices from a table (SQL SELECT): select expression from tablename |
Validation* | Data input validation expression. Note the use of {}, which is substituted with the current data entered, e.g. Contained in a list: inlist("{}","Apples","Oranges","Bananas") Lookup the value entered in a table: rlookup("{}",customers,"custnames") |
Error message* | The error message to display if data input validation fails |
Tooltip* | The tooltip to display |
Hyperlink* | Display as a hyperlink (True | False) |
Text alignment* | Text alignment (Left | Center | Right) |
Autosuggestions* | Autosuggest a list of values as the user types, e.g. Static list of choices: Apples,Oranges,Bananas Dynamic list of choices from a table: @tablename,expression Dynamic list of choices from a table (SQL SELECT): select expression from tablename |
Autosuggestion headers* | A comma separated list of column headers to display for the Autosuggestions |
Autosuggestion column to search* | The column to search for Autosuggestions |
Context Menu* | The context menu to popup when a user right-clicks on the field. Specify this as a comma separated list. |
Editable | The data is editable (True|False) |
Dialog button* | The control has a dialog button that can be clicked to call the DialogButtonClicked delegate (True|False) |
Dialog button delegate* | The delegate for the DialogButtonClicked event |
Get data mapping | Custom data mapping when reading data. Specify this as an expression. |
Set data mapping | Custom data mapping when writing data. Specify this as an expression. |
Help topic | The help topic to display for this field when F1 is pressed. |
Custom attributes | A semicolon separated list of custom attributes which can be used in CSS selectors, e.g. mandatory=1;border=1;hilite=red You should reference these attributes as user_xxx from any delegates or in any custom CSS theming. |
Custom Delegates
Attribute | Description | More | Desktop | Web | Tablet | Phone |
---|---|---|---|---|---|---|
Init | The delegate for the Init event | |||||
Load | The delegate for the Load event | |||||
Ready | The delegate for the Ready event | |||||
Activate | The delegate for the Activate event | |||||
Deactivate | The delegate for the Deactivate event | |||||
Got Focus | The delegate for the GotFocus event | |||||
Lost Focus | The delegate for the LostFocus event | |||||
Link Click | The delegate for the Hyperlink Click event. This is called with two arguments: functionname(controlsource,text) | |||||
Interactive Change | The delegate for the InteractiveChange event. This is called after each key is pressed. | |||||
Change | The delegate for the Changed event. This is called when the Enter key or the Tab key are pressed. | |||||
Data Changed | The delegate for the DataChanged event. This is called when navigating between records. | |||||
Hotkey | The delegate for the Hotkey event (e.g. F1-F10, Ctrl+F1). The key is passed as a parameter, e.g. 'F2'. | |||||
Context Menu | The delegate for the Context Menu event | |||||
Timer | The delegate for the Timer event | |||||
Timer interval | The timer interval in seconds that the Timer event will be called at runtime |
Permissions and Roles
Attribute | Description | More | Desktop | Web | Tablet | Phone |
---|---|---|---|---|---|---|
Read roles | A comma separated list of roles that can read (and view) the data | |||||
Update roles | A comma separated list of roles that can perform update operations on the data |
UI Presentation Rules
Attribute | Description | More | Desktop | Web | Tablet | Phone |
---|---|---|---|---|---|---|
Desktop | Include this formitem in a Desktop client (True | False) | |||||
Web | Include this formitem in a Web client (True | False) | |||||
Tablet | Include this formitem in a Tablet client (True | False) | |||||
Phone | Include this formitem in a Phone client (True | False) | |||||
UI States | UI states that affect this formitem. Specify multiple states as a comma separated list. | |||||
Initial UI state | The initial UI state for this formitem (Field or Gadget). | |||||
Readonly when | Formitem is readonly at runtime if specified expression evaluates to true. | |||||
Visible when | Formitem is visible at runtime if specified expression evaluates to true. | |||||
Display orientation | Display depending on mobile device orientation for Tablets and Phones. (Always | Portrait | Landscape) | |||||
Apply rules on change | Apply Page UI presentation rules (Visible when and Readonly when) when data is changed interactively or when navigating records (True | False) |
- Attributes marked with an asterisk are not applicable to all Advanced Canvas Controls.