Nuvoton / Mbed OS NuMaker-mbed-emWin-example

NuMaker emWin HMI

emWin/Include/MULTIPAGE.h@10:c8165817d92a, 6 months ago (annotated)

Committer:
csyang2
Date:
Mon Mar 04 15:47:41 2024 +0800
Revision:
10:c8165817d92a
Parent:
1:c0f972361605 
Support NuMaker-IoT-M467

Who changed what in which revision?

UserRevisionLine numberNew contents of line
csyang2 1:c0f972361605 1 /*********************************************************************
csyang2 1:c0f972361605 2 * SEGGER Software GmbH *
csyang2 1:c0f972361605 3 * Solutions for real time microcontroller applications *
csyang2 1:c0f972361605 4 **********************************************************************
csyang2 1:c0f972361605 5 * *
csyang2 1:c0f972361605 6 * (c) 1996 - 2018 SEGGER Microcontroller GmbH *
csyang2 1:c0f972361605 7 * *
csyang2 1:c0f972361605 8 * Internet: www.segger.com Support: support@segger.com *
csyang2 1:c0f972361605 9 * *
csyang2 1:c0f972361605 10 **********************************************************************
csyang2 1:c0f972361605 11
csyang2 1:c0f972361605 12 ** emWin V5.48 - Graphical user interface for embedded applications **
csyang2 1:c0f972361605 13 All Intellectual Property rights in the Software belongs to SEGGER.
csyang2 1:c0f972361605 14 emWin is protected by international copyright laws. Knowledge of the
csyang2 1:c0f972361605 15 source code may not be used to write a similar product. This file may
csyang2 1:c0f972361605 16 only be used in accordance with the following terms:
csyang2 1:c0f972361605 17
csyang2 1:c0f972361605 18 The software has been licensed by SEGGER Software GmbH to Nuvoton Technology Corporationat the address: No. 4, Creation Rd. III, Hsinchu Science Park, Taiwan
csyang2 1:c0f972361605 19 for the purposes of creating libraries for its
csyang2 1:c0f972361605 20 Arm Cortex-M and Arm9 32-bit microcontrollers, commercialized and distributed by Nuvoton Technology Corporation
csyang2 1:c0f972361605 21 under the terms and conditions of an End User
csyang2 1:c0f972361605 22 License Agreement supplied with the libraries.
csyang2 1:c0f972361605 23 Full source code is available at: www.segger.com
csyang2 1:c0f972361605 24
csyang2 1:c0f972361605 25 We appreciate your understanding and fairness.
csyang2 1:c0f972361605 26 ----------------------------------------------------------------------
csyang2 1:c0f972361605 27 Licensing information
csyang2 1:c0f972361605 28 Licensor: SEGGER Software GmbH
csyang2 1:c0f972361605 29 Licensed to: Nuvoton Technology Corporation, No. 4, Creation Rd. III, Hsinchu Science Park, 30077 Hsinchu City, Taiwan
csyang2 1:c0f972361605 30 Licensed SEGGER software: emWin
csyang2 1:c0f972361605 31 License number: GUI-00735
csyang2 1:c0f972361605 32 License model: emWin License Agreement, signed February 27, 2018
csyang2 1:c0f972361605 33 Licensed platform: Cortex-M and ARM9 32-bit series microcontroller designed and manufactured by or for Nuvoton Technology Corporation
csyang2 1:c0f972361605 34 ----------------------------------------------------------------------
csyang2 1:c0f972361605 35 Support and Update Agreement (SUA)
csyang2 1:c0f972361605 36 SUA period: 2018-03-26 - 2019-03-27
csyang2 1:c0f972361605 37 Contact to extend SUA: sales@segger.com
csyang2 1:c0f972361605 38 ----------------------------------------------------------------------
csyang2 1:c0f972361605 39 File : MULTIPAGE.h
csyang2 1:c0f972361605 40 Purpose : MULTIPAGE include
csyang2 1:c0f972361605 41 --------------------END-OF-HEADER-------------------------------------
csyang2 1:c0f972361605 42 */
csyang2 1:c0f972361605 43
csyang2 1:c0f972361605 44 #ifndef MULTIPAGE_H
csyang2 1:c0f972361605 45 #define MULTIPAGE_H
csyang2 1:c0f972361605 46
csyang2 1:c0f972361605 47 #include "WM.h"
csyang2 1:c0f972361605 48 #include "DIALOG.h" // Required for Create indirect data structure
csyang2 1:c0f972361605 49
csyang2 1:c0f972361605 50 #if GUI_WINSUPPORT
csyang2 1:c0f972361605 51
csyang2 1:c0f972361605 52 #if defined(__cplusplus)
csyang2 1:c0f972361605 53 extern "C" { // Make sure we have C-declarations in C++ programs
csyang2 1:c0f972361605 54 #endif
csyang2 1:c0f972361605 55
csyang2 1:c0f972361605 56 /*********************************************************************
csyang2 1:c0f972361605 57 *
csyang2 1:c0f972361605 58 * Defines
csyang2 1:c0f972361605 59 *
csyang2 1:c0f972361605 60 **********************************************************************
csyang2 1:c0f972361605 61 */
csyang2 1:c0f972361605 62 /*********************************************************************
csyang2 1:c0f972361605 63 *
csyang2 1:c0f972361605 64 * Create / Status flags
csyang2 1:c0f972361605 65 */
csyang2 1:c0f972361605 66 #define MULTIPAGE_ALIGN_LEFT (0 << 0)
csyang2 1:c0f972361605 67 #define MULTIPAGE_ALIGN_RIGHT (1 << 0)
csyang2 1:c0f972361605 68 #define MULTIPAGE_ALIGN_TOP (0 << 2)
csyang2 1:c0f972361605 69 #define MULTIPAGE_ALIGN_BOTTOM (1 << 2)
csyang2 1:c0f972361605 70
csyang2 1:c0f972361605 71 #define MULTIPAGE_CF_ROTATE_CW WIDGET_CF_VERTICAL
csyang2 1:c0f972361605 72
csyang2 1:c0f972361605 73 #define MULTIPAGE_CI_DISABLED 0
csyang2 1:c0f972361605 74 #define MULTIPAGE_CI_ENABLED 1
csyang2 1:c0f972361605 75
csyang2 1:c0f972361605 76 #define MULTIPAGE_SKIN_FRAME_LEFT (1 << 0)
csyang2 1:c0f972361605 77 #define MULTIPAGE_SKIN_FRAME_RIGHT (1 << 1)
csyang2 1:c0f972361605 78 #define MULTIPAGE_SKIN_FRAME_TOP (1 << 2)
csyang2 1:c0f972361605 79 #define MULTIPAGE_SKIN_FRAME_BOTTOM (1 << 3)
csyang2 1:c0f972361605 80 #define MULTIPAGE_SKIN_FRAME_ALL (MULTIPAGE_SKIN_FRAME_LEFT | MULTIPAGE_SKIN_FRAME_RIGHT | MULTIPAGE_SKIN_FRAME_TOP | MULTIPAGE_SKIN_FRAME_BOTTOM)
csyang2 1:c0f972361605 81
csyang2 1:c0f972361605 82 #define MULTIPAGE_SKINFLEX_PI_ENABLED 0
csyang2 1:c0f972361605 83 #define MULTIPAGE_SKINFLEX_PI_SELECTED 1
csyang2 1:c0f972361605 84 #define MULTIPAGE_SKINFLEX_PI_DISABLED 2
csyang2 1:c0f972361605 85
csyang2 1:c0f972361605 86 #define SCROLLBAR_SIZE 32 // Defines the space for the scrollbar arrows
csyang2 1:c0f972361605 87
csyang2 1:c0f972361605 88 #define MULTIPAGE_BI_SELECTED 0
csyang2 1:c0f972361605 89 #define MULTIPAGE_BI_UNSELECTED 1
csyang2 1:c0f972361605 90 #define MULTIPAGE_BI_DISABLED 2
csyang2 1:c0f972361605 91 #define MULTIPAGE_BI_MAX 3 // The defines above are used as array indices.
csyang2 1:c0f972361605 92
csyang2 1:c0f972361605 93 /*********************************************************************
csyang2 1:c0f972361605 94 *
csyang2 1:c0f972361605 95 * Public Types
csyang2 1:c0f972361605 96 *
csyang2 1:c0f972361605 97 **********************************************************************
csyang2 1:c0f972361605 98 */
csyang2 1:c0f972361605 99 typedef WM_HMEM MULTIPAGE_Handle;
csyang2 1:c0f972361605 100
csyang2 1:c0f972361605 101 typedef struct {
csyang2 1:c0f972361605 102 GUI_COLOR BkColor;
csyang2 1:c0f972361605 103 GUI_COLOR aBkUpper[2];
csyang2 1:c0f972361605 104 GUI_COLOR aBkLower[2];
csyang2 1:c0f972361605 105 GUI_COLOR FrameColor;
csyang2 1:c0f972361605 106 GUI_COLOR TextColor;
csyang2 1:c0f972361605 107 } MULTIPAGE_SKINFLEX_PROPS;
csyang2 1:c0f972361605 108
csyang2 1:c0f972361605 109 typedef struct {
csyang2 1:c0f972361605 110 U8 SelSideBorderInc; // Number of pixels to add on both sides when drawing the selected item.
csyang2 1:c0f972361605 111 U8 SelTopBorderInc; // Number of pixels to add on top of selected items.
csyang2 1:c0f972361605 112 } MULTIPAGE_SKIN_PROPS;
csyang2 1:c0f972361605 113
csyang2 1:c0f972361605 114 typedef struct {
csyang2 1:c0f972361605 115 #if GUI_SUPPORT_ROTATION
csyang2 1:c0f972361605 116 GUI_ROTATION * pRotation;
csyang2 1:c0f972361605 117 #endif
csyang2 1:c0f972361605 118 unsigned Align;
csyang2 1:c0f972361605 119 int Sel;
csyang2 1:c0f972361605 120 U16 State;
csyang2 1:c0f972361605 121 U8 FrameFlags; // Flags to let the drawing function know which parts of the frame to display.
csyang2 1:c0f972361605 122 U8 PageStatus;
csyang2 1:c0f972361605 123 GUI_DRAW_HANDLE * pDrawObj;
csyang2 1:c0f972361605 124 } MULTIPAGE_SKIN_INFO;
csyang2 1:c0f972361605 125
csyang2 1:c0f972361605 126 /*********************************************************************
csyang2 1:c0f972361605 127 *
csyang2 1:c0f972361605 128 * Create functions
csyang2 1:c0f972361605 129 *
csyang2 1:c0f972361605 130 **********************************************************************
csyang2 1:c0f972361605 131 */
csyang2 1:c0f972361605 132 MULTIPAGE_Handle MULTIPAGE_Create (int x0, int y0, int xSize, int ySize, WM_HWIN hParent, int Id, int Flags, int SpecialFlags);
csyang2 1:c0f972361605 133 MULTIPAGE_Handle MULTIPAGE_CreateEx (int x0, int y0, int xSize, int ySize, WM_HWIN hParent, int WinFlags, int ExFlags, int Id);
csyang2 1:c0f972361605 134 MULTIPAGE_Handle MULTIPAGE_CreateUser (int x0, int y0, int xSize, int ySize, WM_HWIN hParent, int WinFlags, int ExFlags, int Id, int NumExtraBytes);
csyang2 1:c0f972361605 135 MULTIPAGE_Handle MULTIPAGE_CreateIndirect(const GUI_WIDGET_CREATE_INFO * pCreateInfo, WM_HWIN hWinParent, int x0, int y0, WM_CALLBACK * cb);
csyang2 1:c0f972361605 136
csyang2 1:c0f972361605 137 /*********************************************************************
csyang2 1:c0f972361605 138 *
csyang2 1:c0f972361605 139 * The callback ...
csyang2 1:c0f972361605 140 *
csyang2 1:c0f972361605 141 * Do not call it directly ! It is only to be used from within an
csyang2 1:c0f972361605 142 * overwritten callback.
csyang2 1:c0f972361605 143 */
csyang2 1:c0f972361605 144 void MULTIPAGE_Callback(WM_MESSAGE * pMsg);
csyang2 1:c0f972361605 145
csyang2 1:c0f972361605 146 /*********************************************************************
csyang2 1:c0f972361605 147 *
csyang2 1:c0f972361605 148 * Member functions
csyang2 1:c0f972361605 149 *
csyang2 1:c0f972361605 150 **********************************************************************
csyang2 1:c0f972361605 151 */
csyang2 1:c0f972361605 152 void MULTIPAGE_AddEmptyPage (MULTIPAGE_Handle hObj, WM_HWIN hWin ,const char * pText);
csyang2 1:c0f972361605 153 void MULTIPAGE_AddPage (MULTIPAGE_Handle hObj, WM_HWIN hWin ,const char * pText);
csyang2 1:c0f972361605 154 WM_HWIN MULTIPAGE_AttachWindow (MULTIPAGE_Handle hObj, unsigned Index, WM_HWIN hWin);
csyang2 1:c0f972361605 155 void MULTIPAGE_DeletePage (MULTIPAGE_Handle hObj, unsigned Index, int Delete);
csyang2 1:c0f972361605 156 void MULTIPAGE_DisablePage (MULTIPAGE_Handle hObj, unsigned Index);
csyang2 1:c0f972361605 157 void MULTIPAGE_EnablePage (MULTIPAGE_Handle hObj, unsigned Index);
csyang2 1:c0f972361605 158 void MULTIPAGE_EnableScrollbar(MULTIPAGE_Handle hObj, unsigned OnOff);
csyang2 1:c0f972361605 159 GUI_COLOR MULTIPAGE_GetBkColor (MULTIPAGE_Handle hObj, unsigned Index);
csyang2 1:c0f972361605 160 const GUI_FONT * MULTIPAGE_GetFont (MULTIPAGE_Handle hObj);
csyang2 1:c0f972361605 161 int MULTIPAGE_GetSelection (MULTIPAGE_Handle hObj);
csyang2 1:c0f972361605 162 int MULTIPAGE_GetPageText (MULTIPAGE_Handle hObj, unsigned Index, char * pBuffer, int MaxLen);
csyang2 1:c0f972361605 163 GUI_COLOR MULTIPAGE_GetTextColor (MULTIPAGE_Handle hObj, unsigned Index);
csyang2 1:c0f972361605 164 int MULTIPAGE_GetUserData (MULTIPAGE_Handle hObj, void * pDest, int NumBytes);
csyang2 1:c0f972361605 165 WM_HWIN MULTIPAGE_GetWindow (MULTIPAGE_Handle hObj, unsigned Index);
csyang2 1:c0f972361605 166 int MULTIPAGE_IsPageEnabled (MULTIPAGE_Handle hObj, unsigned Index);
csyang2 1:c0f972361605 167 void MULTIPAGE_SelectPage (MULTIPAGE_Handle hObj, unsigned Index);
csyang2 1:c0f972361605 168 void MULTIPAGE_SetAlign (MULTIPAGE_Handle hObj, unsigned Align);
csyang2 1:c0f972361605 169 int MULTIPAGE_SetBitmapEx (MULTIPAGE_Handle hObj, const GUI_BITMAP * pBitmap, int x, int y, int Index, int State);
csyang2 1:c0f972361605 170 int MULTIPAGE_SetBitmap (MULTIPAGE_Handle hObj, const GUI_BITMAP * pBitmap, int Index, int State);
csyang2 1:c0f972361605 171 void MULTIPAGE_SetBkColor (MULTIPAGE_Handle hObj, GUI_COLOR Color, unsigned Index);
csyang2 1:c0f972361605 172 void MULTIPAGE_SetFont (MULTIPAGE_Handle hObj, const GUI_FONT * pFont);
csyang2 1:c0f972361605 173 void MULTIPAGE_SetRotation (MULTIPAGE_Handle hObj, unsigned Rotation);
csyang2 1:c0f972361605 174 void MULTIPAGE_SetTabWidth (MULTIPAGE_Handle hObj, int Width, int Index);
csyang2 1:c0f972361605 175 void MULTIPAGE_SetTabHeight (MULTIPAGE_Handle hObj, int Height);
csyang2 1:c0f972361605 176 void MULTIPAGE_SetTextAlign (MULTIPAGE_Handle hObj, unsigned Align);
csyang2 1:c0f972361605 177 void MULTIPAGE_SetText (MULTIPAGE_Handle hObj, const char * pText, unsigned Index);
csyang2 1:c0f972361605 178 void MULTIPAGE_SetTextColor (MULTIPAGE_Handle hObj, GUI_COLOR Color, unsigned Index);
csyang2 1:c0f972361605 179 int MULTIPAGE_SetUserData (MULTIPAGE_Handle hObj, const void * pSrc, int NumBytes);
csyang2 1:c0f972361605 180
csyang2 1:c0f972361605 181 /*********************************************************************
csyang2 1:c0f972361605 182 *
csyang2 1:c0f972361605 183 * Managing default values
csyang2 1:c0f972361605 184 *
csyang2 1:c0f972361605 185 **********************************************************************
csyang2 1:c0f972361605 186 */
csyang2 1:c0f972361605 187 unsigned MULTIPAGE_GetDefaultAlign (void);
csyang2 1:c0f972361605 188 GUI_COLOR MULTIPAGE_GetDefaultBkColor (unsigned Index);
csyang2 1:c0f972361605 189 const GUI_FONT * MULTIPAGE_GetDefaultFont (void);
csyang2 1:c0f972361605 190 GUI_COLOR MULTIPAGE_GetDefaultTextColor (unsigned Index);
csyang2 1:c0f972361605 191
csyang2 1:c0f972361605 192 void MULTIPAGE_SetDefaultAlign (unsigned Align);
csyang2 1:c0f972361605 193 void MULTIPAGE_SetDefaultBkColor (GUI_COLOR Color, unsigned Index);
csyang2 1:c0f972361605 194 void MULTIPAGE_SetDefaultBorderSizeX(unsigned Size);
csyang2 1:c0f972361605 195 void MULTIPAGE_SetDefaultBorderSizeY(unsigned Size);
csyang2 1:c0f972361605 196 void MULTIPAGE_SetDefaultFont (const GUI_FONT * pFont);
csyang2 1:c0f972361605 197 void MULTIPAGE_SetDefaultTextColor (GUI_COLOR Color, unsigned Index);
csyang2 1:c0f972361605 198
csyang2 1:c0f972361605 199 void MULTIPAGE_SetEffectColor (unsigned Index, GUI_COLOR Color);
csyang2 1:c0f972361605 200 GUI_COLOR MULTIPAGE_GetEffectColor (unsigned Index);
csyang2 1:c0f972361605 201 int MULTIPAGE_GetNumEffectColors (void);
csyang2 1:c0f972361605 202
csyang2 1:c0f972361605 203 /*********************************************************************
csyang2 1:c0f972361605 204 *
csyang2 1:c0f972361605 205 * Member functions: Skinning
csyang2 1:c0f972361605 206 *
csyang2 1:c0f972361605 207 **********************************************************************
csyang2 1:c0f972361605 208 */
csyang2 1:c0f972361605 209 int MULTIPAGE_DrawSkinFlex (const WIDGET_ITEM_DRAW_INFO * pDrawItemInfo);
csyang2 1:c0f972361605 210 void MULTIPAGE_GetSkinFlexProps (MULTIPAGE_SKINFLEX_PROPS * pProps, int Index);
csyang2 1:c0f972361605 211 WIDGET_DRAW_ITEM_FUNC * MULTIPAGE_SetDefaultSkin (WIDGET_DRAW_ITEM_FUNC * pfDrawSkin);
csyang2 1:c0f972361605 212 void MULTIPAGE_SetDefaultSkinClassic(void);
csyang2 1:c0f972361605 213 void MULTIPAGE_SetSkinClassic (MULTIPAGE_Handle hObj);
csyang2 1:c0f972361605 214 void MULTIPAGE_SetSkin (MULTIPAGE_Handle hObj, WIDGET_DRAW_ITEM_FUNC * pfDrawSkin);
csyang2 1:c0f972361605 215 void MULTIPAGE_SetSkinFlexProps (const MULTIPAGE_SKINFLEX_PROPS * pProps, int Index);
csyang2 1:c0f972361605 216
csyang2 1:c0f972361605 217 #define MULTIPAGE_SKIN_FLEX MULTIPAGE_DrawSkinFlex
csyang2 1:c0f972361605 218
csyang2 1:c0f972361605 219 #if defined(__cplusplus)
csyang2 1:c0f972361605 220 }
csyang2 1:c0f972361605 221 #endif
csyang2 1:c0f972361605 222
csyang2 1:c0f972361605 223 #endif // GUI_WINSUPPORT
csyang2 1:c0f972361605 224 #endif // MULTIPAGE_H
csyang2 1:c0f972361605 225
csyang2 1:c0f972361605 226 /*************************** End of file ****************************/