TMS iCL DEVELOPERS GUIDE - TMS Software

More documents

Recommendations

Info

TMS SOFTWARE TMS iCL DEVELOPERS GUIDE If you have a special template control that needs to be accessible in an easy way, you can specify an ID to your template control. The ID property needs to be 1 or higher and is returned by the GetViewID function to identify the correct control. If you have multiple template controls of the same type and want to manage them with an easier accessibility, this is the way to identify them. Interaction The CollectionView supports a variety of template controls such as a label, imageview, progressview but also interactable controls such as a button. Adding a button is done in the same way as adding a label, can optionally and uniquely be identified and is also accessible to modify its values dynamically. The CollectionView exposes events that are triggered when clicking a button, editing text in a textview or toggling the switch,with a section and row parameter. Designtime editor Programmatically adding, modifying and positioning controls can be useful to quickly have a rough idea on how your application would possibly look like. You can then concentrate on the data structure, implement interaction, selection, database handling, etc…. and handle the visualization afterwards. It might also be sufficient if you only have a label and an image and they are positioned without indenting, under eachother with the image taking up the remaining space after substracting the label height from the item height, but this will be easier said than done in some cases. To cover the “easier said than done” part, we have created a designtime template editor that acts as a helper to create a template for the header, footer and / or item element. Under the Template property on CollectionView level you will notice three templates. Click on the three dots next to the template of choice to start the editor. The editor will display a dotted rectangle that represents the boundaries of the element depending on the chosen template. On the left you can add template controls, position them relatively inside the element rectangle. A newly created template control is accessible as a non-visual component both at designtime and at runtime. It can also be removed as easily as it has been added. Below is the template of the item element shown inside the editor, and the result after the application is started and the data is loaded. 138
TMS SOFTWARE TMS iCL DEVELOPERS GUIDE Performance The CollectionView manages a state where it checks if a property is modified, sets a flag and updates the appropriate properties on the template control in one of the OnApply*Value events, but each control that is added to the template is passed as a parameter to this event so you can manipulate the data and visual aspects. When having multiple controls that remain identical for each element during the lifetime of the CollectionView, such as image shadows, text, buttons it is unnecessary to call the OnApply*Value event for these template controls. This will affect performance in a positive way and will allow you to manage the controls that really matter for your application. When adding a new template control, you will notice a State property that is being set to csDynamic by default. In the demo you will notice by selecting the shadow item template control that the State property is being set to csStatic as the shadow is identical for each item. 139
Page 1 and 2:
TMS SOFTWARE TMS iCL DEVELOPERS GUI
Page 3 and 4:
Page 5 and 6:
Page 7 and 8:
Page 9 and 10:
Page 11 and 12:
Page 13 and 14:
Page 15 and 16:
Page 17 and 18:
Page 19 and 20:
Page 21 and 22:
Page 23 and 24:
Page 25 and 26:
Page 27 and 28:
Page 29 and 30:
Page 31 and 32:
Page 33 and 34:
Page 35 and 36:
Page 37 and 38:
Page 39 and 40:
Page 41 and 42:
Page 43 and 44:
Page 45 and 46:
Page 47 and 48:
Page 49 and 50:
Page 51 and 52:
Page 53 and 54:
Page 55 and 56:
Page 57 and 58:
Page 59 and 60:
Page 61 and 62:
Page 63 and 64:
Page 65 and 66:
Page 67 and 68:
Page 69 and 70:
Page 71 and 72:
Page 73 and 74:
Page 75 and 76:
Page 77 and 78:
Page 79 and 80:
Page 81 and 82:
Page 83 and 84:
Page 85 and 86:
Page 87 and 88: TMS SOFTWARE TMS iCL DEVELOPERS GUI
Page 137: TMS SOFTWARE TMS iCL DEVELOPERS GUI
show all

TMS iCL DEVELOPERS GUIDE - TMS Software

You also want an ePaper? Increase the reach of your titles

Delete template?

Save as template?