/********************************************************************* * Portions COPYRIGHT 2016 STMicroelectronics * * Portions SEGGER Microcontroller GmbH & Co. KG * * Solutions for real time microcontroller applications * ********************************************************************** * * * (c) 1996 - 2015 SEGGER Microcontroller GmbH & Co. KG * * * * Internet: www.segger.com Support: support@segger.com * * * ********************************************************************** ** emWin V5.32 - Graphical user interface for embedded applications ** All Intellectual Property rights in the Software belongs to SEGGER. emWin is protected by international copyright laws. Knowledge of the source code may not be used to write a similar product. This file may only be used in accordance with the following terms: The software has been licensed to STMicroelectronics International N.V. a Dutch company with a Swiss branch and its headquarters in Plan- les-Ouates, Geneva, 39 Chemin du Champ des Filles, Switzerland for the purposes of creating libraries for ARM Cortex-M-based 32-bit microcon_ troller products commercialized by Licensee only, sublicensed and dis_ tributed under the terms and conditions of the End User License Agree_ ment supplied by STMicroelectronics International N.V. Full source code is available at: www.segger.com We appreciate your understanding and fairness. ---------------------------------------------------------------------- File : MULTIPAGE.h Purpose : MULTIPAGE include --------------------END-OF-HEADER------------------------------------- */ /** ****************************************************************************** * @attention * * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); * You may not use this file except in compliance with the License. * You may obtain a copy of the License at: * * http://www.st.com/software_license_agreement_liberty_v2 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. * ****************************************************************************** */ #ifndef MULTIPAGE_H #define MULTIPAGE_H #include "WM.h" #include "DIALOG.h" // Required for Create indirect data structure #if GUI_WINSUPPORT #if defined(__cplusplus) extern "C" { // Make sure we have C-declarations in C++ programs #endif /********************************************************************* * * Defines * ********************************************************************** */ /********************************************************************* * * Create / Status flags */ #define MULTIPAGE_ALIGN_LEFT (0 << 0) #define MULTIPAGE_ALIGN_RIGHT (1 << 0) #define MULTIPAGE_ALIGN_TOP (0 << 2) #define MULTIPAGE_ALIGN_BOTTOM (1 << 2) #define MULTIPAGE_CF_ROTATE_CW WIDGET_CF_VERTICAL #define MULTIPAGE_CI_DISABLED 0 #define MULTIPAGE_CI_ENABLED 1 #define MULTIPAGE_SKIN_FRAME_LEFT (1 << 0) #define MULTIPAGE_SKIN_FRAME_RIGHT (1 << 1) #define MULTIPAGE_SKIN_FRAME_TOP (1 << 2) #define MULTIPAGE_SKIN_FRAME_BOTTOM (1 << 3) #define MULTIPAGE_SKIN_FRAME_ALL (MULTIPAGE_SKIN_FRAME_LEFT | MULTIPAGE_SKIN_FRAME_RIGHT | MULTIPAGE_SKIN_FRAME_TOP | MULTIPAGE_SKIN_FRAME_BOTTOM) #define MULTIPAGE_SKINFLEX_PI_ENABLED 0 #define MULTIPAGE_SKINFLEX_PI_SELECTED 1 #define MULTIPAGE_SKINFLEX_PI_DISABLED 2 #define SCROLLBAR_SIZE 32 // Defines the space for the scrollbar arrows #define MULTIPAGE_BI_SELECTED 0 #define MULTIPAGE_BI_UNSELECTED 1 #define MULTIPAGE_BI_DISABLED 2 #define MULTIPAGE_BI_MAX 3 // The defines above are used as array indices. /********************************************************************* * * Public Types * ********************************************************************** */ typedef WM_HMEM MULTIPAGE_Handle; typedef struct { GUI_COLOR BkColor; GUI_COLOR aBkUpper[2]; GUI_COLOR aBkLower[2]; GUI_COLOR FrameColor; GUI_COLOR TextColor; } MULTIPAGE_SKINFLEX_PROPS; typedef struct { U8 SelSideBorderInc; // Number of pixels to add on both sides when drawing the selected item. U8 SelTopBorderInc; // Number of pixels to add on top of selected items. } MULTIPAGE_SKIN_PROPS; typedef struct { #if GUI_SUPPORT_ROTATION GUI_ROTATION * pRotation; #endif unsigned Align; int Sel; U16 State; U8 FrameFlags; // Flags to let the drawing function know which parts of the frame to display. U8 PageStatus; GUI_DRAW_HANDLE * pDrawObj; } MULTIPAGE_SKIN_INFO; /********************************************************************* * * Create functions * ********************************************************************** */ MULTIPAGE_Handle MULTIPAGE_Create (int x0, int y0, int xSize, int ySize, WM_HWIN hParent, int Id, int Flags, int SpecialFlags); MULTIPAGE_Handle MULTIPAGE_CreateEx (int x0, int y0, int xSize, int ySize, WM_HWIN hParent, int WinFlags, int ExFlags, int Id); MULTIPAGE_Handle MULTIPAGE_CreateUser (int x0, int y0, int xSize, int ySize, WM_HWIN hParent, int WinFlags, int ExFlags, int Id, int NumExtraBytes); MULTIPAGE_Handle MULTIPAGE_CreateIndirect(const GUI_WIDGET_CREATE_INFO * pCreateInfo, WM_HWIN hWinParent, int x0, int y0, WM_CALLBACK * cb); /********************************************************************* * * The callback ... * * Do not call it directly ! It is only to be used from within an * overwritten callback. */ void MULTIPAGE_Callback(WM_MESSAGE * pMsg); /********************************************************************* * * Member functions * ********************************************************************** */ void MULTIPAGE_AddEmptyPage (MULTIPAGE_Handle hObj, WM_HWIN hWin ,const char * pText); void MULTIPAGE_AddPage (MULTIPAGE_Handle hObj, WM_HWIN hWin ,const char * pText); WM_HWIN MULTIPAGE_AttachWindow (MULTIPAGE_Handle hObj, unsigned Index, WM_HWIN hWin); void MULTIPAGE_DeletePage (MULTIPAGE_Handle hObj, unsigned Index, int Delete); void MULTIPAGE_DisablePage (MULTIPAGE_Handle hObj, unsigned Index); void MULTIPAGE_EnablePage (MULTIPAGE_Handle hObj, unsigned Index); void MULTIPAGE_EnableScrollbar(MULTIPAGE_Handle hObj, unsigned OnOff); const GUI_FONT * MULTIPAGE_GetFont (MULTIPAGE_Handle hObj); int MULTIPAGE_GetSelection (MULTIPAGE_Handle hObj); int MULTIPAGE_GetPageText (MULTIPAGE_Handle hObj, unsigned Index, char * pBuffer, int MaxLen); int MULTIPAGE_GetUserData (MULTIPAGE_Handle hObj, void * pDest, int NumBytes); WM_HWIN MULTIPAGE_GetWindow (MULTIPAGE_Handle hObj, unsigned Index); int MULTIPAGE_IsPageEnabled (MULTIPAGE_Handle hObj, unsigned Index); void MULTIPAGE_SelectPage (MULTIPAGE_Handle hObj, unsigned Index); void MULTIPAGE_SetAlign (MULTIPAGE_Handle hObj, unsigned Align); int MULTIPAGE_SetBitmapEx (MULTIPAGE_Handle hObj, const GUI_BITMAP * pBitmap, int x, int y, int Index, int State); int MULTIPAGE_SetBitmap (MULTIPAGE_Handle hObj, const GUI_BITMAP * pBitmap, int Index, int State); void MULTIPAGE_SetBkColor (MULTIPAGE_Handle hObj, GUI_COLOR Color, unsigned Index); void MULTIPAGE_SetFont (MULTIPAGE_Handle hObj, const GUI_FONT * pFont); void MULTIPAGE_SetRotation (MULTIPAGE_Handle hObj, unsigned Rotation); void MULTIPAGE_SetTabWidth (MULTIPAGE_Handle hObj, int Width, int Index); void MULTIPAGE_SetTabHeight (MULTIPAGE_Handle hObj, int Height); void MULTIPAGE_SetTextAlign (MULTIPAGE_Handle hObj, unsigned Align); void MULTIPAGE_SetText (MULTIPAGE_Handle hObj, const char * pText, unsigned Index); void MULTIPAGE_SetTextColor (MULTIPAGE_Handle hObj, GUI_COLOR Color, unsigned Index); int MULTIPAGE_SetUserData (MULTIPAGE_Handle hObj, const void * pSrc, int NumBytes); /********************************************************************* * * Managing default values * ********************************************************************** */ unsigned MULTIPAGE_GetDefaultAlign (void); GUI_COLOR MULTIPAGE_GetDefaultBkColor (unsigned Index); const GUI_FONT * MULTIPAGE_GetDefaultFont (void); GUI_COLOR MULTIPAGE_GetDefaultTextColor (unsigned Index); void MULTIPAGE_SetDefaultAlign (unsigned Align); void MULTIPAGE_SetDefaultBkColor (GUI_COLOR Color, unsigned Index); void MULTIPAGE_SetDefaultBorderSizeX(unsigned Size); void MULTIPAGE_SetDefaultBorderSizeY(unsigned Size); void MULTIPAGE_SetDefaultFont (const GUI_FONT * pFont); void MULTIPAGE_SetDefaultTextColor (GUI_COLOR Color, unsigned Index); void MULTIPAGE_SetEffectColor (unsigned Index, GUI_COLOR Color); GUI_COLOR MULTIPAGE_GetEffectColor (unsigned Index); int MULTIPAGE_GetNumEffectColors (void); /********************************************************************* * * Member functions: Skinning * ********************************************************************** */ int MULTIPAGE_DrawSkinFlex (const WIDGET_ITEM_DRAW_INFO * pDrawItemInfo); void MULTIPAGE_GetSkinFlexProps (MULTIPAGE_SKINFLEX_PROPS * pProps, int Index); WIDGET_DRAW_ITEM_FUNC * MULTIPAGE_SetDefaultSkin (WIDGET_DRAW_ITEM_FUNC * pfDrawSkin); void MULTIPAGE_SetDefaultSkinClassic(void); void MULTIPAGE_SetSkinClassic (MULTIPAGE_Handle hObj); void MULTIPAGE_SetSkin (MULTIPAGE_Handle hObj, WIDGET_DRAW_ITEM_FUNC * pfDrawSkin); void MULTIPAGE_SetSkinFlexProps (const MULTIPAGE_SKINFLEX_PROPS * pProps, int Index); #define MULTIPAGE_SKIN_FLEX MULTIPAGE_DrawSkinFlex #if defined(__cplusplus) } #endif #endif // GUI_WINSUPPORT #endif // MULTIPAGE_H /*************************** End of file ****************************/