Difference between revisions of "emWin Widgets"
(→Available widgets) |
|||
Line 1: | Line 1: | ||
− | + | '''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. |
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. |
||
Line 7: | Line 7: | ||
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. |
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. |
||
− | {| class="wikitable" |
+ | {| class="wikitable" style="width: 80%;" |
|- |
|- |
||
! Widget name !! Screenshot !! Description |
! Widget name !! Screenshot !! Description |
||
|- |
|- |
||
+ | | [[BUTTON]] |
||
− | | [[BUTTON]] || [[File: Button.gif|center]] || Button which can be pressed. Text or bitmaps may be displayed on a button. |
||
+ | | [[File: Button.gif|center]] |
||
+ | | Button which can be pressed. Text or bitmaps may be displayed on a button. |
||
|- |
|- |
||
+ | | [[CHECKBOX]] |
||
− | | [[CHECKBOX]] || [[File: Checkbox.gif|center]] || Check box which may be checked or unchecked. |
||
+ | | [[File: Checkbox.gif|center]] |
||
+ | | Check box which may be checked or unchecked. |
||
|- |
|- |
||
+ | | [[DROPDOWN]] |
||
− | | [[DROPDOWN]] || [[File: Dropdown.gif|center]] || Dropdown listbox, opens a listbox when pressed. |
||
+ | | [[File: Dropdown.gif|center]] |
||
+ | | Dropdown listbox, opens a listbox when pressed. |
||
|- |
|- |
||
+ | | [[EDIT]] |
||
− | | [[EDIT]] || [[File: Edit.gif|center]] || Single-line edit field which prompts the user to type a number or text. |
||
+ | | [[File: Edit.gif|center]] |
||
+ | | Single-line edit field which prompts the user to type a number or text. |
||
|- |
|- |
||
+ | | [[FRAMEWIN]] |
||
− | | [[FRAMEWIN]] || [[File: Framewin.gif|center]] || Frame window. Creates the typical GUI look. |
||
+ | | [[File: Framewin.gif|center]] |
||
+ | | Frame window. Creates the typical GUI look. |
||
|- |
|- |
||
+ | | [[GRAPH]] |
||
− | | [[GRAPH]] || [[File: GRAPH.gif|200px|center]] || Graph widget, used to show curves or measured values. |
||
+ | | [[File: GRAPH.gif|200px|center]] |
||
+ | | Graph widget, used to show curves or measured values. |
||
|- |
|- |
||
+ | | [[HEADER]] |
||
− | | [[HEADER]] || [[File: Header.gif|center]] || Header control, used to manage columns. |
||
+ | | [[File: Header.gif|center]] |
||
+ | | Header control, used to manage columns. |
||
|- |
|- |
||
+ | | [[ICONVIEW]] |
||
− | | [[ICONVIEW]] || [[File: Iconview.png|200px|center]] || Icon view widget. Useful for icon based platforms as found in common hand held devices. |
||
+ | | [[File: Iconview.png|200px|center]] |
||
+ | | Icon view widget. Useful for icon based platforms as found in common hand held devices. |
||
|- |
|- |
||
+ | | [[IMAGE]] |
||
− | | [[IMAGE]] || [[File: Image.png|center]] || Image widget. Displays several image formats automatically. |
||
+ | | [[File: Image.png|center]] |
||
+ | | Image widget. Displays several image formats automatically. |
||
|- |
|- |
||
+ | | [[KNOB]] (deprecated) |
||
− | | [[KNOB]] (deprecated) || [[File: Knob.png|200px|center]] || Knob widget which can be used to adjust uncountable values. |
||
+ | | [[File: Knob.png|200px|center]] |
||
+ | | Knob widget which can be used to adjust uncountable values. |
||
|- |
|- |
||
+ | | [[LISTBOX]] |
||
− | | [[LISTBOX]] || [[File: Listbox.gif|center]] || Listbox which highlights items as they are selected by the user. |
||
+ | | [[File: Listbox.gif|center]] |
||
+ | | Listbox which highlights items as they are selected by the user. |
||
|- |
|- |
||
+ | | [[LISTVIEW]] |
||
− | | [[LISTVIEW]] || [[File: Listview.gif|center]] || Listview widgets are used to creates tables. |
||
+ | | [[File: Listview.gif|center]] |
||
+ | | Listview widgets are used to creates tables. |
||
|- |
|- |
||
+ | | [[LISTWHEEL]] |
||
− | | [[LISTWHEEL]] || [[File: Listwheel.png|200px|center]] || Listwheel widget. The data can be moved and accelerated via pointer input device. |
||
+ | | [[File: Listwheel.png|200px|center]] |
||
+ | | Listwheel widget. The data can be moved and accelerated via pointer input device. |
||
|- |
|- |
||
+ | | [[MENU]] |
||
− | | [[MENU]] || [[File: Menu.png|center]] || Menu widgets are used to create horizontal and vertical menus. |
||
+ | | [[File: Menu.png|center]] |
||
+ | | Menu widgets are used to create horizontal and vertical menus. |
||
|- |
|- |
||
+ | | [[MULTIEDIT]] |
||
− | | [[MULTIEDIT]] || [[File: MULTIEDIT.gif|center]] || Multiedit widgets are used to edit multiple lines of text. |
||
+ | | [[File: MULTIEDIT.gif|center]] |
||
+ | | Multiedit widgets are used to edit multiple lines of text. |
||
|- |
|- |
||
+ | | [[MULTIPAGE]] |
||
− | | [[MULTIPAGE]] || [[File: MULTIPAGE.png|center]] || Multipage widgets are used to create dialogs with multiple pages. |
||
+ | | [[File: MULTIPAGE.png|center]] |
||
+ | | Multipage widgets are used to create dialogs with multiple pages. |
||
|- |
|- |
||
+ | | [[PROGBAR]] |
||
− | | [[PROGBAR]] || [[File: Progbar.gif|center]] || Progress bar used for visualization. |
||
+ | | [[File: Progbar.gif|center]] |
||
+ | | Progress bar used for visualization. |
||
|- |
|- |
||
+ | | [[RADIO]] |
||
− | | [[RADIO]] || [[File: Radio.gif|center]] || Radio button which may be selected. Only one button may be selected at a time. |
||
+ | | [[File: Radio.gif|center]] |
||
+ | | Radio button which may be selected. Only one button may be selected at a time. |
||
|- |
|- |
||
+ | | [[ROTARY]] |
||
− | | [[ROTARY]] || [[File: ROTARY.png|center]] || Rotary widget which can be rotated to return uncountable values. |
||
+ | | [[File: ROTARY.png|center]] |
||
+ | | Rotary widget which can be rotated to return uncountable values. |
||
|- |
|- |
||
+ | | [[SCROLLBAR]] |
||
− | | [[SCROLLBAR]] || [[File: Scrollbar.gif|center]] || Scrollbar which may be horizontal or vertical. |
||
+ | | [[File: Scrollbar.gif|center]] |
||
+ | | Scrollbar which may be horizontal or vertical. |
||
|- |
|- |
||
+ | | [[SLIDER]] |
||
− | | [[SLIDER]] || [[File: Slider.gif|center]] || Slider bar used for changing values. |
||
+ | | [[File: Slider.gif|center]] |
||
+ | | Slider bar used for changing values. |
||
|- |
|- |
||
+ | | [[SPINBOX]] |
||
− | | [[SPINBOX]] || [[File: SPINBOX.png|center]] || Spinning box to display and adjust a specific value. |
||
+ | | [[File: SPINBOX.png|center]] |
||
+ | | Spinning box to display and adjust a specific value. |
||
|- |
|- |
||
+ | | [[SWIPELIST]] |
||
− | | [[SWIPELIST]] || [[File: SWIPELIST.png|200px|center]] || Swipelist widgets are used for creating swipeable lists which could be moved by swiping the finger (or any other PID) over the touch screen. |
||
+ | | [[File: SWIPELIST.png|200px|center]] |
||
+ | | 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]] || [[File: SWITCH.png|center]] || Switch widget which can be toggled. |
||
+ | | [[File: SWITCH.png|center]] |
||
+ | | Switch widget which can be toggled. |
||
|- |
|- |
||
+ | | [[TEXT]] |
||
− | | [[TEXT]] || [[File: Text.gif|center]] || Static text typically used in dialogs. |
||
+ | | [[File: Text.gif|center]] |
||
+ | | Static text typically used in dialogs. |
||
|- |
|- |
||
+ | | [[TREEVIEW]] |
||
− | | [[TREEVIEW]] || [[File: Treeview.gif|center]] || Treeview widget for managing hierarchical lists. |
||
+ | | [[File: Treeview.gif|center]] |
||
+ | | Treeview widget for managing hierarchical lists. |
||
|- |
|- |
||
− | | [[WINDOW]] |
+ | | [[WINDOW]] |
+ | | |
||
+ | | Simple window. |
||
|} |
|} |
Revision as of 09:35, 24 April 2020
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. | |
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. | |
KNOB (deprecated) | Knob widget which can be used to adjust uncountable values. | |
LISTBOX | Listbox which highlights items as they are selected by the user. | |
LISTVIEW | Listview widgets are used to creates tables. | |
LISTWHEEL | Listwheel widget. The data can be moved and accelerated via pointer input device. | |
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. | |
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. | |
SCROLLBAR | Scrollbar 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. | |
WINDOW | Simple window. |