225 lines
10 KiB
C
225 lines
10 KiB
C
/*********************************************************************
|
|
* 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 : BUTTON.h
|
|
Purpose : BUTTON public header file (API)
|
|
--------------------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 BUTTON_H
|
|
#define BUTTON_H
|
|
|
|
#include "WM.h"
|
|
#include "DIALOG_Intern.h" /* Req. for Create indirect data structure */
|
|
#include "WIDGET.h"
|
|
|
|
#if GUI_WINSUPPORT
|
|
|
|
#if defined(__cplusplus)
|
|
extern "C" { /* Make sure we have C-declarations in C++ programs */
|
|
#endif
|
|
|
|
/*********************************************************************
|
|
*
|
|
* Create flags
|
|
*/
|
|
/* For compatibility only ! */
|
|
#define BUTTON_CF_HIDE WM_CF_HIDE
|
|
#define BUTTON_CF_SHOW WM_CF_SHOW
|
|
#define BUTTON_CF_MEMDEV WM_CF_MEMDEV
|
|
|
|
/*********************************************************************
|
|
*
|
|
* Color indices
|
|
*/
|
|
#define BUTTON_CI_UNPRESSED 0
|
|
#define BUTTON_CI_PRESSED 1
|
|
#define BUTTON_CI_DISABLED 2
|
|
|
|
/*********************************************************************
|
|
*
|
|
* Bitmap indices
|
|
*/
|
|
#define BUTTON_BI_UNPRESSED 0
|
|
#define BUTTON_BI_PRESSED 1
|
|
#define BUTTON_BI_DISABLED 2
|
|
|
|
/*********************************************************************
|
|
*
|
|
* States
|
|
*/
|
|
#define BUTTON_STATE_FOCUS WIDGET_STATE_FOCUS
|
|
#define BUTTON_STATE_PRESSED WIDGET_STATE_USER0
|
|
|
|
/*********************************************************************
|
|
*
|
|
* Skinning property indices
|
|
*/
|
|
#define BUTTON_SKINFLEX_PI_PRESSED 0
|
|
#define BUTTON_SKINFLEX_PI_FOCUSSED 1
|
|
#define BUTTON_SKINFLEX_PI_ENABLED 2
|
|
#define BUTTON_SKINFLEX_PI_DISABLED 3
|
|
|
|
/*********************************************************************
|
|
*
|
|
* Types
|
|
*
|
|
**********************************************************************
|
|
*/
|
|
typedef WM_HMEM BUTTON_Handle;
|
|
|
|
typedef struct {
|
|
GUI_COLOR aColorFrame[3];
|
|
GUI_COLOR aColorUpper[2];
|
|
GUI_COLOR aColorLower[2];
|
|
int Radius;
|
|
} BUTTON_SKINFLEX_PROPS;
|
|
|
|
/*********************************************************************
|
|
*
|
|
* Create function(s)
|
|
|
|
Note: the parameters to a create function may vary.
|
|
Some widgets may have multiple create functions
|
|
*/
|
|
|
|
BUTTON_Handle BUTTON_Create (int x0, int y0, int xSize, int ySize, int ID, int Flags);
|
|
BUTTON_Handle BUTTON_CreateAsChild (int x0, int y0, int xSize, int ySize, WM_HWIN hParent, int Id, int Flags);
|
|
BUTTON_Handle BUTTON_CreateEx (int x0, int y0, int xSize, int ySize, WM_HWIN hParent, int WinFlags, int ExFlags, int Id);
|
|
BUTTON_Handle BUTTON_CreateUser (int x0, int y0, int xSize, int ySize, WM_HWIN hParent, int WinFlags, int ExFlags, int Id, int NumExtraBytes);
|
|
BUTTON_Handle BUTTON_CreateIndirect(const GUI_WIDGET_CREATE_INFO * pCreateInfo, WM_HWIN hWinParent, int x0, int y0, WM_CALLBACK * cb);
|
|
|
|
/*********************************************************************
|
|
*
|
|
* Managing default values
|
|
*
|
|
**********************************************************************
|
|
*/
|
|
GUI_COLOR BUTTON_GetDefaultBkColor (unsigned Index);
|
|
const GUI_FONT * BUTTON_GetDefaultFont (void);
|
|
int BUTTON_GetDefaultTextAlign (void);
|
|
GUI_COLOR BUTTON_GetDefaultTextColor (unsigned Index);
|
|
void BUTTON_SetDefaultBkColor (GUI_COLOR Color, unsigned Index);
|
|
GUI_COLOR BUTTON_SetDefaultFocusColor(GUI_COLOR Color);
|
|
void BUTTON_SetDefaultFont (const GUI_FONT * pFont);
|
|
void BUTTON_SetDefaultTextAlign (int Align);
|
|
void BUTTON_SetDefaultTextColor (GUI_COLOR Color, unsigned Index);
|
|
|
|
/*********************************************************************
|
|
*
|
|
* The callback ...
|
|
*
|
|
* Do not call it directly ! It is only to be used from within an
|
|
* overwritten callback.
|
|
*/
|
|
void BUTTON_Callback(WM_MESSAGE *pMsg);
|
|
|
|
/*********************************************************************
|
|
*
|
|
* Member functions
|
|
*
|
|
**********************************************************************
|
|
*/
|
|
GUI_COLOR BUTTON_GetBkColor (BUTTON_Handle hObj, unsigned int Index);
|
|
const GUI_BITMAP * BUTTON_GetBitmap(BUTTON_Handle hObj,unsigned int Index);
|
|
const GUI_FONT * BUTTON_GetFont (BUTTON_Handle hObj);
|
|
GUI_COLOR BUTTON_GetFrameColor (BUTTON_Handle hObj);
|
|
WIDGET * BUTTON_GetpWidget (BUTTON_Handle hObj);
|
|
void BUTTON_GetText (BUTTON_Handle hObj, char * pBuffer, int MaxLen);
|
|
GUI_COLOR BUTTON_GetTextColor (BUTTON_Handle hObj, unsigned int Index);
|
|
int BUTTON_GetTextAlign (BUTTON_Handle hObj);
|
|
int BUTTON_GetUserData (BUTTON_Handle hObj, void * pDest, int NumBytes);
|
|
unsigned BUTTON_IsPressed (BUTTON_Handle hObj);
|
|
void BUTTON_SetBitmap (BUTTON_Handle hObj, unsigned int Index, const GUI_BITMAP * pBitmap);
|
|
void BUTTON_SetBitmapEx (BUTTON_Handle hObj, unsigned int Index, const GUI_BITMAP * pBitmap, int x, int y);
|
|
void BUTTON_SetBkColor (BUTTON_Handle hObj, unsigned int Index, GUI_COLOR Color);
|
|
void BUTTON_SetBMP (BUTTON_Handle hObj, unsigned int Index, const void * pBitmap);
|
|
void BUTTON_SetBMPEx (BUTTON_Handle hObj, unsigned int Index, const void * pBitmap, int x, int y);
|
|
void BUTTON_SetFont (BUTTON_Handle hObj, const GUI_FONT * pfont);
|
|
void BUTTON_SetFrameColor (BUTTON_Handle hObj, GUI_COLOR Color);
|
|
void BUTTON_SetState (BUTTON_Handle hObj, int State); /* Not to be doc. */
|
|
void BUTTON_SetPressed (BUTTON_Handle hObj, int State);
|
|
GUI_COLOR BUTTON_SetFocusColor (BUTTON_Handle hObj, GUI_COLOR Color);
|
|
void BUTTON_SetFocussable (BUTTON_Handle hObj, int State);
|
|
void BUTTON_SetStreamedBitmap (BUTTON_Handle hObj, unsigned int Index, const GUI_BITMAP_STREAM * pBitmap);
|
|
void BUTTON_SetStreamedBitmapEx(BUTTON_Handle hObj, unsigned int Index, const GUI_BITMAP_STREAM * pBitmap, int x, int y);
|
|
int BUTTON_SetText (BUTTON_Handle hObj, const char* s);
|
|
void BUTTON_SetTextAlign (BUTTON_Handle hObj, int Align);
|
|
void BUTTON_SetTextColor (BUTTON_Handle hObj, unsigned int Index, GUI_COLOR Color);
|
|
void BUTTON_SetTextOffset (BUTTON_Handle hObj, int xPos, int yPos);
|
|
void BUTTON_SetSelfDrawEx (BUTTON_Handle hObj, unsigned int Index, GUI_DRAW_SELF_CB * pDraw, int x, int y); /* Not to be doc. */
|
|
void BUTTON_SetSelfDraw (BUTTON_Handle hObj, unsigned int Index, GUI_DRAW_SELF_CB * pDraw); /* Not to be doc. */
|
|
void BUTTON_SetReactOnLevel (void);
|
|
void BUTTON_SetReactOnTouch (void);
|
|
int BUTTON_SetUserData (BUTTON_Handle hObj, const void * pSrc, int NumBytes);
|
|
|
|
/*********************************************************************
|
|
*
|
|
* Member functions: Skinning
|
|
*
|
|
**********************************************************************
|
|
*/
|
|
void BUTTON_GetSkinFlexProps (BUTTON_SKINFLEX_PROPS * pProps, int Index);
|
|
void BUTTON_SetSkinClassic (BUTTON_Handle hObj);
|
|
void BUTTON_SetSkin (BUTTON_Handle hObj, WIDGET_DRAW_ITEM_FUNC * pfDrawSkin);
|
|
int BUTTON_DrawSkinFlex (const WIDGET_ITEM_DRAW_INFO * pDrawItemInfo);
|
|
void BUTTON_SetSkinFlexProps (const BUTTON_SKINFLEX_PROPS * pProps, int Index);
|
|
void BUTTON_SetDefaultSkinClassic(void);
|
|
WIDGET_DRAW_ITEM_FUNC * BUTTON_SetDefaultSkin(WIDGET_DRAW_ITEM_FUNC * pfDrawSkin);
|
|
|
|
#define BUTTON_SKIN_FLEX BUTTON_DrawSkinFlex
|
|
|
|
#if defined(__cplusplus)
|
|
}
|
|
#endif
|
|
|
|
#endif // GUI_WINSUPPORT
|
|
#endif // BUTTON_H
|
|
|
|
/*************************** End of file ****************************/
|