Nuvoton / Mbed OS NuMaker-mbed-emWin-example

NuMaker emWin HMI

emWin/Include/TREEVIEW.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 : TREEVIEW.h
csyang2 1:c0f972361605 40 Purpose : TREEVIEW include
csyang2 1:c0f972361605 41 --------------------END-OF-HEADER-------------------------------------
csyang2 1:c0f972361605 42 */
csyang2 1:c0f972361605 43
csyang2 1:c0f972361605 44 #ifndef TREEVIEW_H
csyang2 1:c0f972361605 45 #define TREEVIEW_H
csyang2 1:c0f972361605 46
csyang2 1:c0f972361605 47 #include "WM.h"
csyang2 1:c0f972361605 48 #include "DIALOG_Intern.h" /* Req. for Create indirect data structure */
csyang2 1:c0f972361605 49 #include "WIDGET.h"
csyang2 1:c0f972361605 50
csyang2 1:c0f972361605 51 #if GUI_WINSUPPORT
csyang2 1:c0f972361605 52
csyang2 1:c0f972361605 53 #if defined(__cplusplus)
csyang2 1:c0f972361605 54 extern "C" { /* Make sure we have C-declarations in C++ programs */
csyang2 1:c0f972361605 55 #endif
csyang2 1:c0f972361605 56
csyang2 1:c0f972361605 57 /*********************************************************************
csyang2 1:c0f972361605 58 *
csyang2 1:c0f972361605 59 * Defines
csyang2 1:c0f972361605 60 *
csyang2 1:c0f972361605 61 **********************************************************************
csyang2 1:c0f972361605 62 */
csyang2 1:c0f972361605 63 /* Status- and create flags */
csyang2 1:c0f972361605 64 #define TREEVIEW_CF_HIDELINES (1 << 0)
csyang2 1:c0f972361605 65 #define TREEVIEW_CF_ROWSELECT (1 << 1)
csyang2 1:c0f972361605 66 #define TREEVIEW_CF_AUTOSCROLLBAR_H (1 << 2)
csyang2 1:c0f972361605 67 #define TREEVIEW_CF_AUTOSCROLLBAR_V (1 << 3)
csyang2 1:c0f972361605 68 #define TREEVIEW_SF_HIDELINES TREEVIEW_CF_HIDELINES
csyang2 1:c0f972361605 69 #define TREEVIEW_SF_ROWSELECT TREEVIEW_CF_ROWSELECT
csyang2 1:c0f972361605 70 #define TREEVIEW_SF_AUTOSCROLLBAR_H TREEVIEW_CF_AUTOSCROLLBAR_H
csyang2 1:c0f972361605 71 #define TREEVIEW_SF_AUTOSCROLLBAR_V TREEVIEW_CF_AUTOSCROLLBAR_V
csyang2 1:c0f972361605 72
csyang2 1:c0f972361605 73 /* Bitmap indices */
csyang2 1:c0f972361605 74 #define TREEVIEW_BI_CLOSED 0
csyang2 1:c0f972361605 75 #define TREEVIEW_BI_OPEN 1
csyang2 1:c0f972361605 76 #define TREEVIEW_BI_LEAF 2
csyang2 1:c0f972361605 77 #define TREEVIEW_BI_PLUS 3
csyang2 1:c0f972361605 78 #define TREEVIEW_BI_MINUS 4
csyang2 1:c0f972361605 79 #define TREEVIEW_BI_PM 5
csyang2 1:c0f972361605 80
csyang2 1:c0f972361605 81 /* Color indices */
csyang2 1:c0f972361605 82 #define TREEVIEW_CI_UNSEL 0
csyang2 1:c0f972361605 83 #define TREEVIEW_CI_SEL 1
csyang2 1:c0f972361605 84 #define TREEVIEW_CI_DISABLED 2
csyang2 1:c0f972361605 85
csyang2 1:c0f972361605 86 /* Relative positions (create) */
csyang2 1:c0f972361605 87 #define TREEVIEW_INSERT_ABOVE 0
csyang2 1:c0f972361605 88 #define TREEVIEW_INSERT_BELOW 1
csyang2 1:c0f972361605 89 #define TREEVIEW_INSERT_FIRST_CHILD 2
csyang2 1:c0f972361605 90
csyang2 1:c0f972361605 91 /* Relative positions (retrieve) */
csyang2 1:c0f972361605 92 #define TREEVIEW_GET_FIRST 0
csyang2 1:c0f972361605 93 #define TREEVIEW_GET_LAST 1
csyang2 1:c0f972361605 94 #define TREEVIEW_GET_NEXT_SIBLING 2
csyang2 1:c0f972361605 95 #define TREEVIEW_GET_PREV_SIBLING 3
csyang2 1:c0f972361605 96 #define TREEVIEW_GET_FIRST_CHILD 4
csyang2 1:c0f972361605 97 #define TREEVIEW_GET_PARENT 5
csyang2 1:c0f972361605 98
csyang2 1:c0f972361605 99 /* Item flags */
csyang2 1:c0f972361605 100 #define TREEVIEW_ITEM_TYPE_LEAF (0 << 0)
csyang2 1:c0f972361605 101 #define TREEVIEW_ITEM_TYPE_NODE (1 << 0)
csyang2 1:c0f972361605 102
csyang2 1:c0f972361605 103 /* Selection mode */
csyang2 1:c0f972361605 104 #define TREEVIEW_SELMODE_ROW 1
csyang2 1:c0f972361605 105 #define TREEVIEW_SELMODE_TEXT 0
csyang2 1:c0f972361605 106
csyang2 1:c0f972361605 107 /************************************************************
csyang2 1:c0f972361605 108 *
csyang2 1:c0f972361605 109 * Types
csyang2 1:c0f972361605 110 *
csyang2 1:c0f972361605 111 *************************************************************
csyang2 1:c0f972361605 112 */
csyang2 1:c0f972361605 113 typedef WM_HMEM TREEVIEW_Handle;
csyang2 1:c0f972361605 114 typedef WM_HMEM TREEVIEW_ITEM_Handle;
csyang2 1:c0f972361605 115
csyang2 1:c0f972361605 116 typedef struct {
csyang2 1:c0f972361605 117 int IsNode;
csyang2 1:c0f972361605 118 int IsExpanded;
csyang2 1:c0f972361605 119 int HasLines;
csyang2 1:c0f972361605 120 int HasRowSelect;
csyang2 1:c0f972361605 121 int Level;
csyang2 1:c0f972361605 122 } TREEVIEW_ITEM_INFO;
csyang2 1:c0f972361605 123
csyang2 1:c0f972361605 124 typedef struct {
csyang2 1:c0f972361605 125 GUI_COLOR ColorBk;
csyang2 1:c0f972361605 126 GUI_COLOR ColorText;
csyang2 1:c0f972361605 127 GUI_COLOR ColorTextBk;
csyang2 1:c0f972361605 128 GUI_COLOR ColorLines;
csyang2 1:c0f972361605 129 GUI_RECT rText;
csyang2 1:c0f972361605 130 TREEVIEW_ITEM_Handle hItem;
csyang2 1:c0f972361605 131 const GUI_FONT * pFont;
csyang2 1:c0f972361605 132 char * pText;
csyang2 1:c0f972361605 133 U8 NumLines;
csyang2 1:c0f972361605 134 I16 ax0[3];
csyang2 1:c0f972361605 135 I16 ay0[3];
csyang2 1:c0f972361605 136 I16 ax1[3];
csyang2 1:c0f972361605 137 I16 ay1[3];
csyang2 1:c0f972361605 138 U8 NumConnectors;
csyang2 1:c0f972361605 139 I16 axc[16];
csyang2 1:c0f972361605 140 const GUI_BITMAP * pBmPM;
csyang2 1:c0f972361605 141 const GUI_BITMAP * pBmOCL;
csyang2 1:c0f972361605 142 I16 xPosPM, xPosOCL;
csyang2 1:c0f972361605 143 U8 IndexPM;
csyang2 1:c0f972361605 144 U8 IndexOCL;
csyang2 1:c0f972361605 145 } TREEVIEW_ITEM_DRAW_INFO;
csyang2 1:c0f972361605 146
csyang2 1:c0f972361605 147 /*********************************************************************
csyang2 1:c0f972361605 148 *
csyang2 1:c0f972361605 149 * Create functions
csyang2 1:c0f972361605 150 *
csyang2 1:c0f972361605 151 **********************************************************************
csyang2 1:c0f972361605 152 */
csyang2 1:c0f972361605 153 TREEVIEW_Handle TREEVIEW_CreateEx (int x0, int y0, int xSize, int ySize, WM_HWIN hParent, int WinFlags, int ExFlags, int Id);
csyang2 1:c0f972361605 154 TREEVIEW_Handle TREEVIEW_CreateUser (int x0, int y0, int xSize, int ySize, WM_HWIN hParent, int WinFlags, int ExFlags, int Id, int NumExtraBytes);
csyang2 1:c0f972361605 155 TREEVIEW_Handle TREEVIEW_CreateIndirect(const GUI_WIDGET_CREATE_INFO * pCreateInfo, WM_HWIN hWinParent, int x0, int y0, WM_CALLBACK * cb);
csyang2 1:c0f972361605 156
csyang2 1:c0f972361605 157 /*********************************************************************
csyang2 1:c0f972361605 158 *
csyang2 1:c0f972361605 159 * The callback ...
csyang2 1:c0f972361605 160 *
csyang2 1:c0f972361605 161 * Do not call it directly ! It is only to be used from within an
csyang2 1:c0f972361605 162 * overwritten callback.
csyang2 1:c0f972361605 163 */
csyang2 1:c0f972361605 164 void TREEVIEW_Callback(WM_MESSAGE * pMsg);
csyang2 1:c0f972361605 165
csyang2 1:c0f972361605 166 /*********************************************************************
csyang2 1:c0f972361605 167 *
csyang2 1:c0f972361605 168 * Common functions
csyang2 1:c0f972361605 169 *
csyang2 1:c0f972361605 170 **********************************************************************
csyang2 1:c0f972361605 171 */
csyang2 1:c0f972361605 172 int TREEVIEW_AttachItem (TREEVIEW_Handle hObj, TREEVIEW_ITEM_Handle hItem, TREEVIEW_ITEM_Handle hItemAt, int Position);
csyang2 1:c0f972361605 173 void TREEVIEW_DecSel (TREEVIEW_Handle hObj);
csyang2 1:c0f972361605 174 TREEVIEW_ITEM_Handle TREEVIEW_GetItem (TREEVIEW_Handle hObj, TREEVIEW_ITEM_Handle hItem, int Flags);
csyang2 1:c0f972361605 175 TREEVIEW_ITEM_Handle TREEVIEW_GetSel (TREEVIEW_Handle hObj);
csyang2 1:c0f972361605 176 int TREEVIEW_GetUserData (TREEVIEW_Handle hObj, void * pDest, int NumBytes);
csyang2 1:c0f972361605 177 void TREEVIEW_IncSel (TREEVIEW_Handle hObj);
csyang2 1:c0f972361605 178 TREEVIEW_ITEM_Handle TREEVIEW_InsertItem (TREEVIEW_Handle hObj, int IsNode, TREEVIEW_ITEM_Handle hItemPrev, int Position, const char * s);
csyang2 1:c0f972361605 179 int TREEVIEW_OwnerDraw (const WIDGET_ITEM_DRAW_INFO * pDrawItemInfo);
csyang2 1:c0f972361605 180 void TREEVIEW_ScrollToSel (TREEVIEW_Handle hObj);
csyang2 1:c0f972361605 181 void TREEVIEW_SetAutoScrollH (TREEVIEW_Handle hObj, int State);
csyang2 1:c0f972361605 182 void TREEVIEW_SetAutoScrollV (TREEVIEW_Handle hObj, int State);
csyang2 1:c0f972361605 183 void TREEVIEW_SetBitmapOffset(TREEVIEW_Handle hObj, int Index, int xOff, int yOff);
csyang2 1:c0f972361605 184 void TREEVIEW_SetBkColor (TREEVIEW_Handle hObj, int Index, GUI_COLOR Color);
csyang2 1:c0f972361605 185 void TREEVIEW_SetFont (TREEVIEW_Handle hObj, const GUI_FONT * pFont);
csyang2 1:c0f972361605 186 void TREEVIEW_SetHasLines (TREEVIEW_Handle hObj, int State);
csyang2 1:c0f972361605 187 void TREEVIEW_SetImage (TREEVIEW_Handle hObj, int Index, const GUI_BITMAP * pBitmap);
csyang2 1:c0f972361605 188 int TREEVIEW_SetIndent (TREEVIEW_Handle hObj, int Indent);
csyang2 1:c0f972361605 189 void TREEVIEW_SetLineColor (TREEVIEW_Handle hObj, int Index, GUI_COLOR Color);
csyang2 1:c0f972361605 190 void TREEVIEW_SetOwnerDraw (TREEVIEW_Handle hObj, WIDGET_DRAW_ITEM_FUNC * pfDrawItem);
csyang2 1:c0f972361605 191 void TREEVIEW_SetSel (TREEVIEW_Handle hObj, TREEVIEW_ITEM_Handle hItem);
csyang2 1:c0f972361605 192 void TREEVIEW_SetSelMode (TREEVIEW_Handle hObj, int Mode);
csyang2 1:c0f972361605 193 void TREEVIEW_SetTextColor (TREEVIEW_Handle hObj, int Index, GUI_COLOR Color);
csyang2 1:c0f972361605 194 int TREEVIEW_SetTextIndent (TREEVIEW_Handle hObj, int TextIndent);
csyang2 1:c0f972361605 195 int TREEVIEW_SetUserData (TREEVIEW_Handle hObj, const void * pSrc, int NumBytes);
csyang2 1:c0f972361605 196
csyang2 1:c0f972361605 197
csyang2 1:c0f972361605 198 /*********************************************************************
csyang2 1:c0f972361605 199 *
csyang2 1:c0f972361605 200 * Treeview item related functions
csyang2 1:c0f972361605 201 *
csyang2 1:c0f972361605 202 **********************************************************************
csyang2 1:c0f972361605 203 */
csyang2 1:c0f972361605 204 void TREEVIEW_ITEM_Collapse (TREEVIEW_ITEM_Handle hItem);
csyang2 1:c0f972361605 205 void TREEVIEW_ITEM_CollapseAll(TREEVIEW_ITEM_Handle hItem);
csyang2 1:c0f972361605 206 TREEVIEW_ITEM_Handle TREEVIEW_ITEM_Create (int IsNode, const char * s, U32 UserData);
csyang2 1:c0f972361605 207 void TREEVIEW_ITEM_Delete (TREEVIEW_ITEM_Handle hItem);
csyang2 1:c0f972361605 208 void TREEVIEW_ITEM_Detach (TREEVIEW_ITEM_Handle hItem);
csyang2 1:c0f972361605 209 void TREEVIEW_ITEM_Expand (TREEVIEW_ITEM_Handle hItem);
csyang2 1:c0f972361605 210 void TREEVIEW_ITEM_ExpandAll (TREEVIEW_ITEM_Handle hItem);
csyang2 1:c0f972361605 211 void TREEVIEW_ITEM_GetInfo (TREEVIEW_ITEM_Handle hItem, TREEVIEW_ITEM_INFO * pInfo);
csyang2 1:c0f972361605 212 void TREEVIEW_ITEM_GetText (TREEVIEW_ITEM_Handle hItem, U8 * pBuffer, int MaxNumBytes);
csyang2 1:c0f972361605 213 U32 TREEVIEW_ITEM_GetUserData(TREEVIEW_ITEM_Handle hItem);
csyang2 1:c0f972361605 214 void TREEVIEW_ITEM_SetImage (TREEVIEW_ITEM_Handle hItem, int Index, const GUI_BITMAP * pBitmap);
csyang2 1:c0f972361605 215 TREEVIEW_ITEM_Handle TREEVIEW_ITEM_SetText (TREEVIEW_ITEM_Handle hItem, const char * s);
csyang2 1:c0f972361605 216 void TREEVIEW_ITEM_SetUserData(TREEVIEW_ITEM_Handle hItem, U32 UserData);
csyang2 1:c0f972361605 217
csyang2 1:c0f972361605 218 /*********************************************************************
csyang2 1:c0f972361605 219 *
csyang2 1:c0f972361605 220 * Managing default values
csyang2 1:c0f972361605 221 *
csyang2 1:c0f972361605 222 **********************************************************************
csyang2 1:c0f972361605 223 */
csyang2 1:c0f972361605 224 GUI_COLOR TREEVIEW_GetDefaultBkColor (int Index);
csyang2 1:c0f972361605 225 const GUI_FONT * TREEVIEW_GetDefaultFont (void);
csyang2 1:c0f972361605 226 GUI_COLOR TREEVIEW_GetDefaultLineColor(int Index);
csyang2 1:c0f972361605 227 GUI_COLOR TREEVIEW_GetDefaultTextColor(int Index);
csyang2 1:c0f972361605 228 void TREEVIEW_SetDefaultBkColor (int Index, GUI_COLOR Color);
csyang2 1:c0f972361605 229 void TREEVIEW_SetDefaultFont (const GUI_FONT * pFont);
csyang2 1:c0f972361605 230 void TREEVIEW_SetDefaultLineColor(int Index, GUI_COLOR Color);
csyang2 1:c0f972361605 231 void TREEVIEW_SetDefaultTextColor(int Index, GUI_COLOR Color);
csyang2 1:c0f972361605 232
csyang2 1:c0f972361605 233 #if defined(__cplusplus)
csyang2 1:c0f972361605 234 }
csyang2 1:c0f972361605 235 #endif
csyang2 1:c0f972361605 236
csyang2 1:c0f972361605 237 #endif // GUI_WINSUPPORT
csyang2 1:c0f972361605 238 #endif // TREEVIEW_H
csyang2 1:c0f972361605 239
csyang2 1:c0f972361605 240 /*************************** End of file ****************************/