emWin Widgets

From SEGGER Wiki
(Redirected from Widgets)
Jump to navigation Jump to search

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.gif
Button which can be pressed. Text or bitmaps may be displayed on a button.
CHECKBOX
Checkbox.gif
Check box which may be checked or unchecked.
DROPDOWN
Dropdown.gif
Dropdown listbox, opens a listbox when pressed.
EDIT
Edit.gif
Single-line edit field which prompts the user to type a number or text.
FRAMEWIN
Framewin.gif
Frame window. Creates the typical GUI look.
GAUGE
GAUGE.png
Gauge widget, basically a radial progress bar.
GRAPH
GRAPH.gif
Graph widget, used to show curves or measured values.
HEADER
Header.gif
Header control, used to manage columns.
ICONVIEW
Iconview.png
Icon view widget. Useful for icon based platforms as found in common hand held devices.
IMAGE
Image.png
Image widget. Displays several image formats automatically.
KEYBOARD
KEYBOARD.png
Keyboard widget which can be used as a screen keyboard for user input to EDIT/MULTIEDIT widgets.
LISTBOX
Listbox.gif
Listbox which highlights items as they are selected by the user.
LISTVIEW
Listview.gif
Listview widgets are used to creates tables.
MENU
Menu.png
Menu widgets are used to create horizontal and vertical menus.
MULTIEDIT
MULTIEDIT.gif
Multiedit widgets are used to edit multiple lines of text.
MULTIPAGE
MULTIPAGE.png
Multipage widgets are used to create dialogs with multiple pages.
PROGBAR
Progbar.gif
Progress bar used for visualization.
QRCODE
QRCodeWidget.gif
QR code.
RADIO
Radio.gif
Radio button which may be selected. Only one button may be selected at a time.
ROTARY
ROTARY.png
Rotary widget which can be rotated to return uncountable values.
SCROLLER
SCROLLER.png
Smartphone-like scrollbar widget which may be horizontal or vertical.
SLIDER
Slider.gif
Slider bar used for changing values.
SPINBOX
SPINBOX.png
Spinning box to display and adjust a specific value.
SWIPELIST
SWIPELIST.png
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.png
Switch widget which can be toggled.
TEXT
Text.gif
Static text typically used in dialogs.
TREEVIEW
Treeview.gif
Treeview widget for managing hierarchical lists.
WHEEL
WHEEL.png
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
Knob.png
ROTARY Knob widget which can be used to adjust uncountable values.
LISTWHEEL
Listwheel.png
WHEEL Listwheel widget. The data can be moved and accelerated via pointer input device.
SCROLLBAR
Scrollbar.gif
SCROLLER PC-style scrollbar which may be horizontal or vertical.