Difference between revisions of "emWin Widgets"
m (Florian moved page Widgets to emWin Widgets) |
(→Available widgets) |
||
(3 intermediate revisions by the same user not shown) | |||
Line 30: | Line 30: | ||
| [[File: Framewin.gif|center]] |
| [[File: Framewin.gif|center]] |
||
| Frame window. Creates the typical GUI look. |
| Frame window. Creates the typical GUI look. |
||
+ | |- |
||
+ | | [[GAUGE]] |
||
+ | | [[File:GAUGE.png|center]] |
||
+ | | Gauge widget, basically a radial progress bar. |
||
|- |
|- |
||
| [[GRAPH]] |
| [[GRAPH]] |
||
Line 47: | Line 51: | ||
| Image widget. Displays several image formats automatically. |
| Image widget. Displays several image formats automatically. |
||
|- |
|- |
||
− | | [[ |
+ | | [[KEYBOARD]] |
− | | [[File: |
+ | | [[File: KEYBOARD.png|300px|center]] |
− | | |
+ | | Keyboard widget which can be used as a screen keyboard for user input to EDIT/MULTIEDIT widgets. |
|- |
|- |
||
| [[LISTBOX]] |
| [[LISTBOX]] |
||
Line 58: | Line 62: | ||
| [[File: Listview.gif|center]] |
| [[File: Listview.gif|center]] |
||
| Listview widgets are used to creates tables. |
| Listview widgets are used to creates tables. |
||
− | |- |
||
− | | [[LISTWHEEL]] |
||
− | | [[File: Listwheel.png|200px|center]] |
||
− | | Listwheel widget. The data can be moved and accelerated via pointer input device. |
||
|- |
|- |
||
| [[MENU]] |
| [[MENU]] |
||
Line 78: | Line 78: | ||
| [[File: Progbar.gif|center]] |
| [[File: Progbar.gif|center]] |
||
| Progress bar used for visualization. |
| Progress bar used for visualization. |
||
+ | |- |
||
+ | | [[QRCODE]] |
||
+ | | [[File:QRCodeWidget.gif|center]] |
||
+ | | QR code. |
||
|- |
|- |
||
| [[RADIO]] |
| [[RADIO]] |
||
Line 87: | Line 91: | ||
| Rotary widget which can be rotated to return uncountable values. |
| Rotary widget which can be rotated to return uncountable values. |
||
|- |
|- |
||
− | | [[ |
+ | | [[SCROLLER]] |
− | | [[File: |
+ | | [[File: SCROLLER.png|center]] |
− | | |
+ | | Smartphone-like scrollbar widget which may be horizontal or vertical. |
|- |
|- |
||
| [[SLIDER]] |
| [[SLIDER]] |
||
− | | [[File: Slider.gif|center]] |
+ | | [[File: Slider.gif|120px|center]] |
| Slider bar used for changing values. |
| Slider bar used for changing values. |
||
|- |
|- |
||
| [[SPINBOX]] |
| [[SPINBOX]] |
||
− | | [[File: SPINBOX.png|center]] |
+ | | [[File: SPINBOX.png|100px|center]] |
| Spinning box to display and adjust a specific value. |
| Spinning box to display and adjust a specific value. |
||
|- |
|- |
||
Line 108: | Line 112: | ||
|- |
|- |
||
| [[TEXT]] |
| [[TEXT]] |
||
− | | [[File: Text.gif|center]] |
+ | | [[File: Text.gif|60px|center]] |
| Static text typically used in dialogs. |
| Static text typically used in dialogs. |
||
|- |
|- |
||
Line 114: | Line 118: | ||
| [[File: Treeview.gif|center]] |
| [[File: Treeview.gif|center]] |
||
| Treeview widget for managing hierarchical lists. |
| Treeview widget for managing hierarchical lists. |
||
+ | |- |
||
+ | | [[WHEEL]] |
||
+ | | [[File: WHEEL.png|center]] |
||
+ | | Scrollable rotating wheel that displays lists of texts and/or bitmaps. |
||
|- |
|- |
||
| [[WINDOW]] |
| [[WINDOW]] |
||
| |
| |
||
| Simple window. |
| Simple window. |
||
+ | |} |
||
+ | |||
+ | === Obsolete widgets === |
||
+ | |||
+ | The following widgets are obsolete but are still included in emWin for compatibility reasons. |
||
+ | The widgets have been replaced with newer versions which are also listed below. |
||
+ | |||
+ | {| class="wikitable" style="width: 80%;" |
||
+ | |- |
||
+ | ! Widget name !! Screenshot !! Replaced by !! Description |
||
+ | |- |
||
+ | | [[KNOB]] |
||
+ | | [[File: Knob.png|200px|center]] |
||
+ | | [[ROTARY]] |
||
+ | | Knob widget which can be used to adjust uncountable values. |
||
+ | |- |
||
+ | | [[LISTWHEEL]] |
||
+ | | [[File: Listwheel.png|200px|center]] |
||
+ | | [[WHEEL]] |
||
+ | | Listwheel widget. The data can be moved and accelerated via pointer input device. |
||
+ | |- |
||
+ | | [[SCROLLBAR]] |
||
+ | | [[File: Scrollbar.gif|center]] |
||
+ | | [[SCROLLER]] |
||
+ | | PC-style scrollbar which may be horizontal or vertical. |
||
|} |
|} |
Latest revision as of 11:37, 14 June 2022
emWin Widgets are windows with object-like properties. They are used to make up elements of a user interface and react automatically to certain events (e.g. a click of a BUTTON).
Widgets require the Window Manager. Once a widget is created, it is treated just like any other window. Like windows, widgets are also referred to by handles.
Available widgets
emWin offers many widgets that can be used in an application. The following table gives an overview of all of the widgets that are available.
Widget name | Screenshot | Description |
---|---|---|
BUTTON | Button which can be pressed. Text or bitmaps may be displayed on a button. | |
CHECKBOX | Check box which may be checked or unchecked. | |
DROPDOWN | Dropdown listbox, opens a listbox when pressed. | |
EDIT | Single-line edit field which prompts the user to type a number or text. | |
FRAMEWIN | Frame window. Creates the typical GUI look. | |
GAUGE | Gauge widget, basically a radial progress bar. | |
GRAPH | Graph widget, used to show curves or measured values. | |
HEADER | Header control, used to manage columns. | |
ICONVIEW | Icon view widget. Useful for icon based platforms as found in common hand held devices. | |
IMAGE | Image widget. Displays several image formats automatically. | |
KEYBOARD | Keyboard widget which can be used as a screen keyboard for user input to EDIT/MULTIEDIT widgets. | |
LISTBOX | Listbox which highlights items as they are selected by the user. | |
LISTVIEW | Listview widgets are used to creates tables. | |
MENU | Menu widgets are used to create horizontal and vertical menus. | |
MULTIEDIT | Multiedit widgets are used to edit multiple lines of text. | |
MULTIPAGE | Multipage widgets are used to create dialogs with multiple pages. | |
PROGBAR | Progress bar used for visualization. | |
QRCODE | QR code. | |
RADIO | Radio button which may be selected. Only one button may be selected at a time. | |
ROTARY | Rotary widget which can be rotated to return uncountable values. | |
SCROLLER | Smartphone-like scrollbar widget which may be horizontal or vertical. | |
SLIDER | Slider bar used for changing values. | |
SPINBOX | Spinning box to display and adjust a specific value. | |
SWIPELIST | Swipelist widgets are used for creating swipeable lists which could be moved by swiping the finger (or any other PID) over the touch screen. | |
SWITCH | Switch widget which can be toggled. | |
TEXT | Static text typically used in dialogs. | |
TREEVIEW | Treeview widget for managing hierarchical lists. | |
WHEEL | Scrollable rotating wheel that displays lists of texts and/or bitmaps. | |
WINDOW | Simple window. |
Obsolete widgets
The following widgets are obsolete but are still included in emWin for compatibility reasons. The widgets have been replaced with newer versions which are also listed below.
Widget name | Screenshot | Replaced by | Description |
---|---|---|---|
KNOB | ROTARY | Knob widget which can be used to adjust uncountable values. | |
LISTWHEEL | WHEEL | Listwheel widget. The data can be moved and accelerated via pointer input device. | |
SCROLLBAR | SCROLLER | PC-style scrollbar which may be horizontal or vertical. |