EarthLCD ezLED-3 Series User Manual
                                                                                   | |
Contents
| 
12.0 WidgetsA widget is a reusable screen object of a graphical user interface that displays an informationarrangement and provides standardized data manipulation. Widgets allow you to create an interactiveuser interface that is small, fast and easy!There are user input widgets and output widgets. Input widgets takes the user input and outputs a resultto the command port. These include the button and slider widget. Most of the input widgets requiretouch screen input to be useful and may have limited use for ezLCD-3xx displays with no touchscreen.Output widgets send out status events when changed to the command port. They usually have anelement that can take a separate input from a widget value command to update just the part of thewidget that shows the value like the needle on the AMETER widget. Control widgets like checkbox,radio button, and slider will send out status events when changed to the command port. This provides afaster and more dynamic user interface.You could program your ezLCD with a startup macro that draws a meter widget in one line and thenyour host would only need to send 6 bytes to update the needle position! Button and checkbox widgetssend 3 bytes when a button is pressed/released or checkbox is checked/unchecked. The ezLCD-3xx hasvarious widgets that simplify the creation of objects on the screen. The CLS command clears all currentwidget references. Widgets are powerful in that they can be drawn typically by just issuing thecommand followed by the parameters and this can take as little as 11 bytes! Widgets use preset (butcustomizable) themes. Widgets that have values like progress bar and meters can be updated by sendingthe appropriate widget value command. Every widget has a unique ID and this value should bedifferent for every widget you use in an application regardless of the type. The current widgets areAnalog Meter, Button, Check Box, Choice, Dial, Digital Meter, Group Box, Progress Bar, RadioButton, Slider and Static Text.Your ezLCD-3xx has the ability to display custom-themed buttons. There are 8 preset widget themesinstalled that can be used for various button shapes. See Section 11.0 for more information aboutwidget themes.IMPORTANT WIDGET NOTES & ERRATA:1. You must be sure that the [Width] and [Height] parameter values fit on your screen or the widgetwill not be drawn!2. Widgets do not support internal fonts at this time.3. Redraw function not supported so use CLS to clear widgets.4. Your ezLCD contains documented examples of all the widgets in the \EZSYS\MACROS directory ofits flash drive. The file will have the same name as the command such as DIAL.EZM andAMETER.EZM.5. Widget Ids must be a number [1-99] and unique from other widgets.6. Some of the widgets require touch screen input to be useful and may have limited use for ezLCD-3xxdisplays with no touchscreen.7. If you decide to modify or create a theme remember you need to send the Fontw command beforesending the theme!32 |
This manual is suitable for:
manualsdatabase
Your AI-powered manual search engine