2
Disclaimer
The information written in this document is assumed to be accurate without guarantee. The
information in this manual is subject to change for functional or performance improvements
without notice. SEGGER Microcontroller GmbH (SEGGER) assumes no responsibility for any errors
or omissions in this document. SEGGER disclaims any warranties or conditions, express, implied
or statutory for the fitness of the product for a particular purpose. It is your sole responsibility
to evaluate the fitness of the product for any specific use.
Copyright notice
You may not extract portions of this manual or modify the PDF file in any way without the prior
written permission of SEGGER. The software described in this document is furnished under a
license and may only be used or copied in accordance with the terms of such a license.
© 2022 SEGGER Microcontroller GmbH, Monheim am Rhein / Germany
Trademarks
Names mentioned in this manual may be trademarks of their respective companies.
Brand and product names are trademarks or registered trademarks of their respective holders.
Contact address
SEGGER Microcontroller GmbH
Ecolab-Allee 5
D-40789 Monheim am Rhein
Germany
Tel. +49 2173-99312-0
Fax. +49 2173-99312-28
E-mail:
*
Internet: www.segger.com
*
By sending us an email your (personal) data will automatically be processed. For further information please refer to our
privacy policy which is available at https://www.segger.com/legal/privacy-policy/.
emWin User Guide & Reference Manual © 2022 SEGGER Microcontroller GmbH
3
Manual versions
This manual describes the current software version. If you find an error in the manual or a
problem in the software, please inform us and we will try to assist you as soon as possible.
Contact us for further information on topics or functions that are not yet documented.
Print date: May 4, 2022
Software Revision Date By Description
6.26 0 220428 FO
Chapter The Window Manager (WM) updated.
• New function WM_GetContentRect() added.
• New function WM_GetContentRectEx() added.
• New function WM_IsUntouchable() added.
Chapter Widgets updated.
• New SCROLLER widget added: smartphone-like scroll bar widget.
• New WHEEL widget added: new and improved version of the LIST-
WHEEL widget.
• Parameters of SWIPELIST_GetOverlap() changed.
• Parameters of SWIPELIST_SetOverlap() changed.
• Parameters of SWIPELIST_GetDefaultOverlap() changed.
• Parameters of SWIPELIST_SetDefaultOverlap() changed.
6.24 0 220118 FO
Chapter Configuration updated.
• New function GUI_SetOnLogFunc() added.
• New function GUI_SetOnWarnFunc() added.
Chapter 2-D Graphic Library updated.
• New function GUI_DrawArcHREx() added.
• New function GUI_DrawFrame() added.
• New function GUI_DrawFrameEx() added.
Chapter Displaying bitmap files updated.
• Added “Limitations” sub-section to JPEG section.
Chapter Colors updated.
• Added new color conversion GUICC_666_18.
• Added new color conversion GUICC_M666_18.
Chapter Widgets updated.
• New function DROPDOWN_Clear() added.
• New function DROPDOWN_SetText() added.
• New function HEADER_GetBorderH() added.
• New function HEADER_GetBorderV() added.
• New function HEADER_SetBorderH() added.
• New function HEADER_SetBorderV() added.
• New function LISTVIEW_Clear() added.
• New function LISTVIEW_GetGridColor() added.
• New function LISTVIEW_SetGridColor() added.
Chapter Anti-aliasing updated.
• New function GUI_AA_SetBufferSize() added.
6.22 0 211116 FO
Chapter Colors updated.
• New color conversion GUICC_8888I added.
Chapter Fonts updated.
• New function GUI_BDF_EmboldenFont() added.
• New function GUI_BDF_EmboldenFontEx() added.
• New function GUI_BDF_SetLetterSpacing() added.
• New function GUI_FT_GetMeasurementChars() added.
• New function GUI_FT_SetMeasurementChars() added.
• New function GUI_TTF_EmboldenFont() added.
• New function GUI_TTF_EmboldenFontEx() added.
• New function GUI_TTF_ObliqueFont() added.
• New function GUI_TTF_ObliqueFontEx() added.
Chapter The Window Manager (WM) updated.
• Section ’Widgets with motion support’ added.
• New function WM_DeleteWindowSecure() added.
Chapter Widgets updated.
• New function DROPDOWN_EnableMotion() added.
• DROPDOWN widget now sends DROPDOWN_NOTIFICATION_COLLAPSED
and DROPDOWN_NOTIFICATION_EXPANDED notifications to its parent.
• New function LISTVIEW_GetDefaultBkColor() added.
• New function LISTVIEW_GetDefaultFont() added.
• New function LISTVIEW_GetDefaultGridColor() added.
• New function LISTVIEW_GetDefaultScrollStepH() added.
• New function LISTVIEW_GetDefaultTextColor() added.
• New function LISTVIEW_SetDefaultScrollStepH() added.
• New function LISTVIEW_SetScrollStepH() added.
• New function LISTVIEW_GetScrollStepH() added.
emWin User Guide & Reference Manual © 2022 SEGGER Microcontroller GmbH
4
Software Revision Date By Description
• New function LISTVIEW_SetScrollPos() added.
• New function MULTIEDIT_GetDefaultAlign() added.
• New function MULTIEDIT_GetDefaultBkColor() added.
• New function MULTIEDIT_GetDefaultCursorColor() added.
• New function MULTIEDIT_GetDefaultFont() added.
• New function MULTIEDIT_GetDefaultHBorder() added.
• New function MULTIEDIT_GetDefaultTextColor() added.
• New function MULTIEDIT_SetDefaultAlign() added.
• New function MULTIEDIT_SetDefaultBkColor() added.
• New function MULTIEDIT_SetDefaultCursorColor() added.
• New function MULTIEDIT_SetDefaultFont() added.
• New function MULTIEDIT_SetDefaultHBorder() added.
• New function MULTIEDIT_SetDefaultTextColor() added.
• New function SWITCH_DisableAnimation() added.
• SWIPELIST widget now sends notifications when its overlap area has
been reached or released.
Chapter emWinView updated.
• Selection position and size can now be edited from a dialog.
6.20 0 210810 FO
Chapter Displaying Text updated.
• New function GUI_GetShowMissingCharacters() added.
Chapter 2-D Graphic Library updated.
• New function GUI_DrawArcHR() added.
• New function GUI_DrawPieHR() added.
Chapter Fonts updated.
• ’Requirements’ section added.
Chapter Movies updated.
• Bitmap-based emWin movie files added.
Chapter Widgets updated.
• New function GAUGE_GetRange() added.
• Fixed mistakes in the SPINBOX configuration options table.
• New function IMAGE_SetAlign() added.
• New function IMAGE_SetOffset() added.
• New function IMAGE_SetAlpha() added.
• New function IMAGE_SetAngle() added.
• New function IMAGE_SetScale() added.
• New function IMAGE_EnableLQ() added.
Chapter VNC server updated.
• Multiple VNC connections to the same layer are now possible.
• Section for connection with a web browser added.
Chapter Anti-aliasing updated.
• New function GUI_AA_DrawPie() added.
Chapter Bitmap Converter updated.
• Bitmap-based emWin movie files added.
Chapter Display drivers updated.
• GUIDRV_SLinEPD_SSD1673 now supports SSD1680.
• GUIDRV_SLinEPD now supports UC8451.
• GUIDRV_FlexColor now supports ST7715.
Chapter Support updated.
• Fixed typo and updated FAQ.
6.18 0 210503
JE
FO
Chapter Fonts updated.
• New function GUI_BDF_CreateFont() added.
• New function GUI_BDF_DeleteFont() added.
• New function GUI_BDF_GetFamilyName() added.
• New function GUI_BDF_GetStyleName() added.
• Function GUI_TTF_DestroyCache() renamed to GUI_FT_Destroy-
Cache().
• Function GUI_TTF_Done() renamed to GUI_FT_Done().
• Function GUI_TTF_SetCacheSize() renamed to GUI_FT_Set-
CacheSize().
• New function GUI_GetFallbackFont() added.
• New function GUI_SetFallbackFont() added.
• New function GUI_SetFuncGetFallbackFont() added.
Chapter Font Converter updated.
• New command line options added added.
Chapter Simulation updated.
• New function SIM_GUI_EnableModifierKey() added.
• New function SIM_GUI_IsModifierKeyEnabled() added.
Chapter Display drivers updated.
• GUIDRV_FlexColor supports Sitronix ST7626.
Chapter Memory Devices updated.
• New function GUI_MEMDEV_GetBitsPerPixel() added.
• New function GUI_MEMDEV_GetSelMemdev() added.
emWin User Guide & Reference Manual © 2022 SEGGER Microcontroller GmbH
5
Software Revision Date By Description
Chapter 2-D Graphic Library updated.
• New function GUI_SetAfterExitHook() added.
Chapter Animations updated.
• New function GUI_ANIM_AddItemById() added.
• New function GUI_ANIM_CreateWithId() added.
• New function GUI_ANIM_DeleteById() added.
• New function GUI_ANIM_Get() added.
• New function GUI_ANIM_StartExId() added.
• New function GUI_ANIM_StopById() added.
Chapter Configuration updated.
• New function GUI_SetFuncDrawCircle() added.
• New function GUI_SetFuncDrawLine() added.
• New function GUI_SetFuncDrawRoundedRect() added.
• New function GUI_SetFuncFillCircle() added.
• New function GUI_SetFuncFillRoundedRect() added.
• Table of currently existing ready to use hardware accelerators added.
• Structure of sub chapters changed.
Chapter Widgets (window objects) updated.
• New function LISTBOX_GetVisItemIndices() added.
• New function LISTBOX_IsItemPartiallyVisible() added.
• New function KEYBOARD_SetRadius() added.
• New function KEYBOARD_SetSpace() added.
• Parameters changed of LISTBOX_EnableMotion(), LISTVIEW_Enable-
Motion() and MULTIEDIT_EnableMotion(). Calls of previous versions are
not affected by this.
• Added support of the following keys to LISTBOX: GUI_KEY_HOME,
GUI_KEY_END, GUI_KEY_PGUP, GUI_KEY_PGDOWN
Chapter ’Viewer’ renamed to emWinView.
• emWinView tool rewritten.
• Added Selection/Measure tool.
• Keyboard input gets send to emWin application.
• Transparency is shown for multi-layer configurations.
6.16 0 201120 FO
Chapter 2-D Graphic Library updated.
• New function GUI_CreateBitmapFromStreamRLE1() added.
Chapter Widgets (window objects) updated.
• New function EDIT_GetMinMax() added.
• New function SPINBOX_GetRange() added.
• New function TEXT_GetFrameColor() added.
• New function TEXT_GetDefaultFrameColor() added.
• New function TEXT_SetFrameColor() added.
• New function TEXT_SetDefaultFrameColor() added.
• PROGBAR now sends WM_NOTIFICATION_VALUE_CHANGED to parent
when its value has changed.
• New keyboard layout KEYBOARD_ARA for Arabic added.
• New function MULTIEDIT_EnableMotion() added.
• New function MULTIEDIT_SetCursorColor() added.
• New function MULTIEDIT_SetInvertCursor() added.
• New function HEADER_SetColumnsResizeable() added.
• New function BUTTON_SetToggleMode() added.
• New function BUTTON_Toggle() added.
• BUTTON_REACT_ON_LEVEL is now the default way how PID events are
handled by a BUTTON.
• New function SWIPELIST_SetOverlap() added.
• New function SWIPELIST_GetOverlap() added.
• New function SWIPELIST_SetDefaultOverlap() added.
• New function SWIPELIST_GetDefaultOverlap() added.
• New function LISTVIEW_GetVisRowIndices() added.
• New function LISTVIEW_IsRowPartiallyVisible() added.
Chapter Anti-aliasing updated.
• New function GUI_AA_DrawRoundedFrame() added.
• New function GUI_AA_DrawRoundedFrameEx() added.
Chapter Memory Devices updated.
• New function GUI_MEMDEV_SerializeExBMP() added.
• Fixed color format issue in GUI_MEMDEV_PunchOutDevice() example.
Chapter AppWizard updated.
• New function APPW_SetCustCallback() added.
Chapter Bitmap Converter updated.
• Reading of C and DTA files added.
• New bitmap format RLE1 (compressed 1bpp) added.
• Added section about memory footprint.
6.14 0 200602 FO
Structure of chapters reworked.
Chapter Introduction to emWin updated.
emWin User Guide & Reference Manual © 2022 SEGGER Microcontroller GmbH