lzc56/simplegui
1
0
Fork 0
mirror of https://gitee.com/Polarix/simplegui.git synced 2025-06-18 05:57:53 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
fc2ba121f7
simplegui/GUI/src/GUI_List.c

833 lines
32 KiB
C
Raw Normal View History

2017-05-29：基于MIT协议重新发布，原有项目废弃。
2017-05-29 07:54:57 +00:00
/*************************************************************************/
/** Copyright. **/
/** FileName: GUI_List.c **/
/** Author: XuYulin **/
/** Version: 1.0.0.0 **/
/** Description: Draw list interface. **/
/*************************************************************************/
//=======================================================================//
//= Include files. =//
//=======================================================================//
#include "LCD_OperationIF.h"
#include "GUI_Common.h"
#include "GUI_Basic.h"
#include "GUI_Text.h"
#include "GUI_ScrollBar.h"
#include "GUI_List.h"
#include "GUI_Frame.h"
#include <stddef.h>
#include <stdint.h>
#include <string.h>
//=======================================================================//
2017-06-02：模拟器增加定时器，用于模拟非用户触发动作；完善ActionMap机制，增加简单Demo；更新和完善部分注释。
2017-06-02 12:33:13 +00:00
//= User Macro definition. =//
2017-05-29：基于MIT协议重新发布，原有项目废弃。
2017-05-29 07:54:57 +00:00
//=======================================================================//
#define LIST_FONT_SIZE (GUI_FONT_SIZE_H12)
#define LIST_EDGE_MULTIPLE (1)
#if(LIST_EDGE_MULTIPLE == 0)
#define LIST_EDGE_SIZE (0)
#else
#define LIST_EDGE_SIZE (LIST_EDGE_MULTIPLE*2-1)
#endif
#define LIST_TITLE_HEIGHT (g_stFontSize[LIST_FONT_SIZE].Height+2)
#define LIST_SCROLLBAR_WIDTH (5)
#define LIST_SCROLLBAR_POSX (LCD_SIZE_WIDTH-LIST_EDGE_SIZE-LIST_SCROLLBAR_WIDTH)
#define LIST_ITEM_RECT_POSX (LIST_EDGE_SIZE+2)
#define LIST_ITEM_RECT_WIDTH (LCD_SIZE_WIDTH-(LIST_ITEM_RECT_POSX*2)-LIST_SCROLLBAR_WIDTH)
#define LIST_ITEM_TEXT_BLANK_EDGEX (2)
#define LIST_ITEM_TEXT_BLANK_EDGEY (1)
#define LIST_ITEM_TEXT_AREA_WIDTH (LIST_ITEM_RECT_WIDTH-(LIST_ITEM_TEXT_BLANK_EDGEX*2))
#define LIST_ITEM_PARAMETER_SPLIT_WIDTH (4)
#define LIST_ITEM_PARAMETER_AREA_WIDTH ((LIST_ITEM_TEXT_AREA_WIDTH/2)-LIST_ITEM_PARAMETER_SPLIT_WIDTH)
#define LIST_ITEM_PARAMETER_STARTX (LIST_ITEM_RECT_POSX+LIST_ITEM_TEXT_BLANK_EDGEX+(LIST_ITEM_TEXT_AREA_WIDTH-LIST_ITEM_PARAMETER_AREA_WIDTH))
#define LIST_ITEM_PARAMETER_TEXT_LENGTH_MAX (16)
//=======================================================================//
//= Static function declaration. =//
//=======================================================================//
static inline void GUI_List_RefreshListItems(GUI_LIST_STRUCT* pstList);
static inline void GUI_List_DrawItem(GUI_LIST_STRUCT* pstList, size_t uiIndex);
//=======================================================================//
//= Function implementation. =//
//=======================================================================//
/*****************************************************************************/
/** Function Name: GUI_List_InitializeListData **/
/** Purpose: Initialize a list control data. **/
/** Resources: List item data. **/
/** Params: **/
/** @pstList[in]: Pointer of list data will be initialized. **/
/** Return: None. **/
/** Notice: None. **/
/*****************************************************************************/
void GUI_List_InitializeListData(GUI_LIST_STRUCT* pstList)
{
/*----------------------------------*/
/* Variable Declaration */
/*----------------------------------*/
GUI_LIST_CONTROL* pstListControl;
GUI_LIST_DATA* pstListData;
GUI_LIST_SUBELEMENT* pstSubElement;
/*----------------------------------*/
/* Process */
/*----------------------------------*/
if(NULL != pstList)
{
pstListControl = &(pstList->ControlVariable);
pstListData = &(pstList->Data);
pstSubElement = &(pstList->SubElement);
2017-07-31：整理函数、注释名；列表接口追加动态列表控制，可以动态增减列表项目。
2017-07-31 13:29:09 +00:00
#ifdef _SIMPLE_GUI_ENABLE_DYNAMIC_MEMORY_
pstListData->Count = 0;
pstListData->Items = NULL;
#endif // _SIMPLE_GUI_ENABLE_DYNAMIC_MEMORY_
2017-05-29：基于MIT协议重新发布，原有项目废弃。
2017-05-29 07:54:57 +00:00
pstListControl->ListTitleHeight = LIST_TITLE_HEIGHT;
pstListControl->PageStartIndex = 0;
pstListControl->SelectIndex = 0;
pstListControl->ItemPosYOffSet = 0;
pstListControl->FirstVisibleItemPosY = LIST_EDGE_SIZE;
pstListControl->ListItemHeight = g_stFontSize[LIST_FONT_SIZE].Height + (LIST_ITEM_TEXT_BLANK_EDGEY*2);
pstListControl->VisibleItemsAreaHeight = LCD_SIZE_HEIGHT-LIST_EDGE_SIZE*2;
if(NULL != pstList->Data.Title)
{
pstListControl->FirstVisibleItemPosY += LIST_TITLE_HEIGHT + 1;
pstListControl->VisibleItemsAreaHeight -= LIST_TITLE_HEIGHT + 1;
}
pstListControl->VisibleIntegralItemsNum = pstListControl->VisibleItemsAreaHeight/(pstListControl->ListItemHeight);
if(pstListControl->VisibleIntegralItemsNum > pstList->Data.Count)
{
pstListControl->VisibleIntegralItemsNum = pstList->Data.Count;
}
pstListControl->VisibleItemsNum = (pstListControl->VisibleItemsAreaHeight-1)/pstListControl->ListItemHeight+1;
pstSubElement->ScrollBar.Parameter.eDirection = GUI_SCROLLBAR_VERTICAL;
pstSubElement->ScrollBar.Parameter.PosX = LIST_SCROLLBAR_POSX;
pstSubElement->ScrollBar.Parameter.PosY = pstListControl->FirstVisibleItemPosY;
pstSubElement->ScrollBar.Parameter.Width = LIST_SCROLLBAR_WIDTH;
pstSubElement->ScrollBar.Parameter.Height = pstListControl->VisibleItemsAreaHeight;
pstSubElement->ScrollBar.Data.Index = 0;
pstSubElement->ScrollBar.Parameter.MaxIndex = (pstListData->Count>pstListControl->VisibleIntegralItemsNum)?(pstListData->Count-pstListControl->VisibleIntegralItemsNum-1):0;
}
}
/*****************************************************************************/
/** Function Name: GUI_List_RefreshListItems **/
/** Purpose: Refresh all visible list item display. **/
/** Resources: List item data. **/
/** Params: **/
/** @pstList[in]: Pointer of list data will be refreshed. **/
2017-07-31：整理函数、注释名；列表接口追加动态列表控制，可以动态增减列表项目。
2017-07-31 13:29:09 +00:00
/** Return: None. **/
2017-05-29：基于MIT协议重新发布，原有项目废弃。
2017-05-29 07:54:57 +00:00
/** Notice: This only refresh visible items and scrollbar. **/
/*****************************************************************************/
void GUI_List_RefreshListItems(GUI_LIST_STRUCT* pstList)
{
/*----------------------------------*/
/* Variable Declaration */
/*----------------------------------*/
GUI_LIST_CONTROL* pstListControl;
GUI_LIST_SUBELEMENT* pstSubElement;
GUI_LIST_DATA* pstListData;
uint16_t uiCurrentItemIndex;
/*----------------------------------*/
/* Initialize */
/*----------------------------------*/
if(NULL != pstList)
{
pstListControl = &(pstList->ControlVariable);
pstListData = &(pstList->Data);
pstSubElement = &(pstList->SubElement);
uiCurrentItemIndex = pstListControl->PageStartIndex;
}
/*----------------------------------*/
/* Process */
/*----------------------------------*/
if(NULL != pstList)
{
if(pstList->Data.Count > 0)
{
2017-07-31：整理函数、注释名；列表接口追加动态列表控制，可以动态增减列表项目。
2017-07-31 13:29:09 +00:00
#ifdef _SIMPLE_GUI_ENABLE_DYNAMIC_MEMORY_
// Recalculate scroll bar parameter.
pstListControl->VisibleIntegralItemsNum = pstListControl->VisibleItemsAreaHeight/(pstListControl->ListItemHeight);
if(pstListControl->VisibleIntegralItemsNum > pstList->Data.Count)
{
pstListControl->VisibleIntegralItemsNum = pstList->Data.Count;
}
pstSubElement->ScrollBar.Parameter.MaxIndex = (pstListData->Count>pstListControl->VisibleIntegralItemsNum)?(pstListData->Count-pstListControl->VisibleIntegralItemsNum-1):0;
#endif // _SIMPLE_GUI_ENABLE_DYNAMIC_MEMORY_
2017-05-29：基于MIT协议重新发布，原有项目废弃。
2017-05-29 07:54:57 +00:00
// Clear list item display area.
GUI_Basic_DrawRectangle(LIST_ITEM_RECT_POSX, pstListControl->FirstVisibleItemPosY, LIST_ITEM_RECT_WIDTH, pstListControl->VisibleItemsAreaHeight, GUI_COLOR_BKGCLR, GUI_COLOR_BKGCLR);
2017-05-29：规范和修改部分函数名称与注释；添加ActionMap机制模型。
2017-05-31 12:35:32 +00:00
// Refresh scroll bar
2017-05-29：基于MIT协议重新发布，原有项目废弃。
2017-05-29 07:54:57 +00:00
pstSubElement->ScrollBar.Data.Index = pstListControl->PageStartIndex;
2017-05-29：规范和修改部分函数名称与注释；添加ActionMap机制模型。
2017-05-31 12:35:32 +00:00
GUI_ScrollBar_RefreshScrollBar(&(pstSubElement->ScrollBar));
2017-05-29：基于MIT协议重新发布，原有项目废弃。
2017-05-29 07:54:57 +00:00
// Draw all visible items.
while((uiCurrentItemIndex < pstListControl->PageStartIndex+pstListControl->VisibleItemsNum) && (uiCurrentItemIndex < pstListData->Count))
{
GUI_List_DrawItem(pstList, uiCurrentItemIndex++);
}
// High light focused items.
GUI_Basic_ReverseBlockColor(LIST_ITEM_RECT_POSX, pstListControl->FirstVisibleItemPosY+(pstListControl->SelectIndex-pstListControl->PageStartIndex)*pstListControl->ListItemHeight-pstListControl->ItemPosYOffSet,
LIST_ITEM_RECT_WIDTH, pstListControl->ListItemHeight);
}
}
}
/*****************************************************************************/
/** Function Name: GUI_List_RefreshList **/
/** Purpose: Refresh list display. **/
/** Resources: List item data. **/
/** Params: **/
/** @pstList[in]: Pointer of list data will be refreshed. **/
/** Return: None. **/
/** Notice: This function will refresh all list display on screen, **/
/** include edge, items, title and scrollbar. **/
/*****************************************************************************/
void GUI_List_RefreshList(GUI_LIST_STRUCT* pstList)
{
/*----------------------------------*/
/* Variable Declaration */
/*----------------------------------*/
2017-06-07：添加文本/数值编辑框的演示程序；修改了ActionMap机制的方法，新增了Refresh动作用于刷新屏幕；修正直线绘制算法在某些坐标值下可能出现的错误；曲线调整接口暂未完成。
2017-06-07 13:50:51 +00:00
GUI_BOX_FRAME_STRUCT stFrameData;
2017-05-29：基于MIT协议重新发布，原有项目废弃。
2017-05-29 07:54:57 +00:00
GUI_LIST_DATA* pstListData;
/*----------------------------------*/
/* Process */
/*----------------------------------*/
if(NULL != pstList)
{
pstListData = &(pstList->Data);
// Draw frame
2017-06-07：添加文本/数值编辑框的演示程序；修改了ActionMap机制的方法，新增了Refresh动作用于刷新屏幕；修正直线绘制算法在某些坐标值下可能出现的错误；曲线调整接口暂未完成。
2017-06-07 13:50:51 +00:00
stFrameData.Parameter.EdgeLayers = LIST_EDGE_MULTIPLE;
stFrameData.Parameter.FontSize = LIST_FONT_SIZE;
stFrameData.Data.Title = pstListData->Title;
GUI_Frame_DrawFullScreenFrame(&stFrameData);
2017-05-29：基于MIT协议重新发布，原有项目废弃。
2017-05-29 07:54:57 +00:00
// Draw list items
GUI_List_RefreshListItems(pstList);
}
}
/*****************************************************************************/
/** Function Name: GUI_List_SelectUpItem **/
/** Purpose: Select previous list item if existed. **/
/** Resources: List item data. **/
/** Params: **/
/** @pstList[in]: Pointer of list will be selected. **/
/** Return: None. **/
/** Notice: None. **/
/*****************************************************************************/
void GUI_List_SelectUpItem(GUI_LIST_STRUCT* pstList)
{
/*----------------------------------*/
/* Variable Declaration */
/*----------------------------------*/
GUI_LIST_CONTROL* pstListControl;
GUI_LIST_DATA* pstListData;
uint16_t uiReverseBlockPosY;
/*----------------------------------*/
/* Initialize */
/*----------------------------------*/
if(NULL != pstList)
{
pstListControl = &(pstList->ControlVariable);
pstListData = &(pstList->Data);
}
/*----------------------------------*/
/* Process */
/*----------------------------------*/
if((pstListControl->SelectIndex > 0) && (pstListData->Count > 1))
{
//Focused item and select item is visible and Integral;
if((pstListControl->SelectIndex>pstListControl->PageStartIndex+1) && (pstListControl->VisibleIntegralItemsNum>1))
{
// Unfocused current item.
uiReverseBlockPosY = pstListControl->FirstVisibleItemPosY+(pstListControl->SelectIndex-pstListControl->PageStartIndex)*pstListControl->ListItemHeight-pstListControl->ItemPosYOffSet;
GUI_Basic_ReverseBlockColor(LIST_ITEM_RECT_POSX, uiReverseBlockPosY, LIST_ITEM_RECT_WIDTH, pstListControl->ListItemHeight);
pstListControl->SelectIndex--;
// Focused previous item.
uiReverseBlockPosY = pstListControl->FirstVisibleItemPosY+(pstListControl->SelectIndex-pstListControl->PageStartIndex)*pstListControl->ListItemHeight-pstListControl->ItemPosYOffSet;
GUI_Basic_ReverseBlockColor(LIST_ITEM_RECT_POSX, uiReverseBlockPosY, LIST_ITEM_RECT_WIDTH, pstListControl->ListItemHeight);
}
else
{
pstListControl->SelectIndex--;
if(pstListControl->PageStartIndex == pstListControl->SelectIndex)
{
pstListControl->ItemPosYOffSet = 0;
}
if(pstListControl->SelectIndex < pstListControl->PageStartIndex)
{
pstListControl->PageStartIndex--;
}
GUI_List_RefreshListItems(pstList);
}
}
}
/*****************************************************************************/
/** Function Name: GUI_List_SelectDownItem **/
/** Purpose: Select next list item if existed. **/
/** Resources: List item data. **/
/** Params: **/
/** @pstList[in]: Pointer of list will be selected. **/
/** Return: None. **/
/** Notice: None. **/
/*****************************************************************************/
void GUI_List_SelectDownItem(GUI_LIST_STRUCT* pstList)
{
/*----------------------------------*/
/* Variable Declaration */
/*----------------------------------*/
GUI_LIST_CONTROL* pstListControl;
GUI_LIST_DATA* pstListData;
uint16_t uiReverseBlockPosY;
/*----------------------------------*/
/* Initialize */
/*----------------------------------*/
if(NULL != pstList)
{
pstListControl = &(pstList->ControlVariable);
pstListData = &(pstList->Data);
}
/*----------------------------------*/
/* Process */
/*----------------------------------*/
if((pstListControl->SelectIndex < pstListData->Count-1) && (pstListData->Count > 1))
{
//Focused item and select item is visible and Integral;
if((pstListControl->VisibleIntegralItemsNum>1) && ((pstListControl->SelectIndex)<(pstListControl->PageStartIndex+pstListControl->VisibleIntegralItemsNum-1)))
{
// Unfocused current item.
uiReverseBlockPosY = pstListControl->FirstVisibleItemPosY+(pstListControl->SelectIndex-pstListControl->PageStartIndex)*pstListControl->ListItemHeight-pstListControl->ItemPosYOffSet;
GUI_Basic_ReverseBlockColor(LIST_ITEM_RECT_POSX, uiReverseBlockPosY, LIST_ITEM_RECT_WIDTH, pstListControl->ListItemHeight);
pstListControl->SelectIndex++;
// Focused previous item.
uiReverseBlockPosY = pstListControl->FirstVisibleItemPosY+(pstListControl->SelectIndex-pstListControl->PageStartIndex)*pstListControl->ListItemHeight-pstListControl->ItemPosYOffSet;
GUI_Basic_ReverseBlockColor(LIST_ITEM_RECT_POSX, uiReverseBlockPosY, LIST_ITEM_RECT_WIDTH, pstListControl->ListItemHeight);
}
else
{
pstListControl->SelectIndex++;
if((pstListControl->SelectIndex-pstListControl->PageStartIndex+1) == pstListControl->VisibleItemsNum)
{
pstListControl->ItemPosYOffSet = pstListControl->ListItemHeight-pstListControl->VisibleItemsAreaHeight%pstListControl->ListItemHeight;
}
if((pstListControl->SelectIndex-pstListControl->PageStartIndex+1) > pstListControl->VisibleItemsNum)
{
pstListControl->PageStartIndex++;
}
GUI_List_RefreshListItems(pstList);
}
}
}
/*****************************************************************************/
/** Function Name: GUI_List_DrawItem **/
/** Purpose: Draw a visible list item. **/
/** Resources: List item data. **/
/** Params: **/
/** @pstList[in]: Pointer of list will be selected. **/
/** @uiIndex[in]: List item index will be draw. **/
/** Return: None. **/
/** Notice: This function only draw visible items, it's depending **/
/** on the first visible item index and count of visible **/
/** items. **/
/*****************************************************************************/
void GUI_List_DrawItem(GUI_LIST_STRUCT* pstList, size_t uiIndex)
{
/*----------------------------------*/
/* Variable Declaration */
/*----------------------------------*/
RECTANGLE stItemTextDisplayArea;
RECTANGLE stItemTextDataArea;
GUI_LIST_CONTROL* pstListControl;
GUI_LIST_ITEM* pstListItemPointer;
char szParameterStringBuffer[LIST_ITEM_PARAMETER_TEXT_LENGTH_MAX];
size_t uiParameterTextWidth;
/*----------------------------------*/
/* Initialize */
/*----------------------------------*/
if(NULL != pstList)
{
pstListControl = &(pstList->ControlVariable);
2017-07-31：整理函数、注释名；列表接口追加动态列表控制，可以动态增减列表项目。
2017-07-31 13:29:09 +00:00
pstListItemPointer = GUI_List_GetListItemPtr(pstList, uiIndex);
2017-05-29：基于MIT协议重新发布，原有项目废弃。
2017-05-29 07:54:57 +00:00
szParameterStringBuffer[0] = '\0';
}
/*----------------------------------*/
/* Process */
/*----------------------------------*/
if(NULL != pstList)
{
if((uiIndex >= pstListControl->PageStartIndex) && (uiIndex < pstListControl->PageStartIndex+pstListControl->VisibleItemsNum))
{
// Prepare draw list item text.
stItemTextDataArea.PosX = 0;
stItemTextDataArea.PosY = LIST_ITEM_TEXT_BLANK_EDGEY;
stItemTextDisplayArea.PosX = LIST_ITEM_RECT_POSX + LIST_ITEM_TEXT_BLANK_EDGEX;
stItemTextDisplayArea.Width = LIST_ITEM_TEXT_AREA_WIDTH;
if(uiIndex == pstListControl->PageStartIndex)
{
stItemTextDataArea.PosY -= pstListControl->ItemPosYOffSet;
stItemTextDisplayArea.PosY = pstListControl->FirstVisibleItemPosY;
stItemTextDisplayArea.Height = pstListControl->ListItemHeight-pstListControl->ItemPosYOffSet;
}
else if(uiIndex == pstListControl->PageStartIndex+pstListControl->VisibleItemsNum-1)
{
stItemTextDisplayArea.PosY = pstListControl->FirstVisibleItemPosY+pstListControl->ListItemHeight*(uiIndex-pstListControl->PageStartIndex)-pstListControl->ItemPosYOffSet;
if((0==pstListControl->ItemPosYOffSet) && (0 != pstListControl->VisibleItemsAreaHeight%pstListControl->ListItemHeight))
{
stItemTextDisplayArea.Height = (pstListControl->VisibleItemsAreaHeight%pstListControl->ListItemHeight);
}
else
{
stItemTextDisplayArea.Height = pstListControl->ListItemHeight;
}
//stItemTextDisplayArea.Height = (0==pstListControl->ItemPosYOffSet)?(pstListControl->VisibleItemsAreaHeight%pstListControl->ListItemHeight):(pstListControl->ListItemHeight);
}
else
{
stItemTextDisplayArea.PosY = pstListControl->FirstVisibleItemPosY+pstListControl->ListItemHeight*(uiIndex-pstListControl->PageStartIndex)-pstListControl->ItemPosYOffSet;
stItemTextDisplayArea.Height = pstListControl->ListItemHeight;
}
// Draw list item text.
2017-07-31：整理函数、注释名；列表接口追加动态列表控制，可以动态增减列表项目。
2017-07-31 13:29:09 +00:00
GUI_Text_DrawSingleLineText( pstListItemPointer->Text, LIST_FONT_SIZE,
&stItemTextDisplayArea, &stItemTextDataArea, GUI_DRAW_NORMAL);
2017-05-29：基于MIT协议重新发布，原有项目废弃。
2017-05-29 07:54:57 +00:00
// Prepare draw parameter text.
stItemTextDataArea.PosX = LIST_ITEM_PARAMETER_SPLIT_WIDTH+1;
stItemTextDisplayArea.PosX = LIST_ITEM_PARAMETER_STARTX;
stItemTextDisplayArea.Width = LIST_ITEM_PARAMETER_AREA_WIDTH;
if(LIST_ITEM_NORMAL != pstListItemPointer->Type)
{
2017-05-29：修改模拟环境，键盘事件响应接口增加Alt/Shift/Ctrl功能键响应功能。修改与优化列表显示接口。
2017-05-29 12:33:35 +00:00
if(pstListItemPointer->Valid.Value > pstListItemPointer->Valid.Max)
{
pstListItemPointer->Valid.Value = pstListItemPointer->Valid.Max;
}
else if(pstListItemPointer->Valid.Value < pstListItemPointer->Valid.Min)
{
pstListItemPointer->Valid.Value = pstListItemPointer->Valid.Min;
}
if(pstListItemPointer->Decimal.Value > pstListItemPointer->Decimal.Max)
{
pstListItemPointer->Decimal.Value = pstListItemPointer->Decimal.Max;
}
else if(pstListItemPointer->Decimal.Value < pstListItemPointer->Decimal.Min)
{
pstListItemPointer->Decimal.Value = pstListItemPointer->Decimal.Min;
}
2017-05-29：基于MIT协议重新发布，原有项目废弃。
2017-05-29 07:54:57 +00:00
switch(pstListItemPointer->Type)
{
case LIST_ITEM_ENUM:
{
2017-07-31：整理函数、注释名；列表接口追加动态列表控制，可以动态增减列表项目。
2017-07-31 13:29:09 +00:00
strncpy(szParameterStringBuffer, pstListItemPointer->EnumerationValues[pstListItemPointer->Valid.Value], LIST_ITEM_PARAMETER_TEXT_LENGTH_MAX-1);
2017-05-29：基于MIT协议重新发布，原有项目废弃。
2017-05-29 07:54:57 +00:00
szParameterStringBuffer[LIST_ITEM_PARAMETER_TEXT_LENGTH_MAX-1] = '\0';
uiParameterTextWidth = GUI_Text_GetTextGraphicsWidth(szParameterStringBuffer, LIST_FONT_SIZE);
if(uiParameterTextWidth < LIST_ITEM_PARAMETER_AREA_WIDTH)
{
stItemTextDataArea.PosX += (LIST_ITEM_PARAMETER_AREA_WIDTH-LIST_ITEM_PARAMETER_SPLIT_WIDTH)-uiParameterTextWidth;
}
break;
}
case LIST_ITEM_DIGIT:
{
2017-05-29：修改模拟环境，键盘事件响应接口增加Alt/Shift/Ctrl功能键响应功能。修改与优化列表显示接口。
2017-05-29 12:33:35 +00:00
GUI_Common_IntegerToStringWithDecimalPoint(pstListItemPointer->Valid.Value, pstListItemPointer->Decimal.Value, szParameterStringBuffer, 0, ' ');
2017-05-29：基于MIT协议重新发布，原有项目废弃。
2017-05-29 07:54:57 +00:00
uiParameterTextWidth = GUI_Text_GetTextGraphicsWidth(szParameterStringBuffer,LIST_FONT_SIZE);
if(uiParameterTextWidth < LIST_ITEM_PARAMETER_AREA_WIDTH)
{
stItemTextDataArea.PosX += (LIST_ITEM_PARAMETER_AREA_WIDTH-LIST_ITEM_PARAMETER_SPLIT_WIDTH)-uiParameterTextWidth;
}
break;
}
default:
{
// Undefined list item type, no any process.
break;
}
}
// Draw parameter text.
GUI_Text_DrawSingleLineText(szParameterStringBuffer, LIST_FONT_SIZE, &stItemTextDisplayArea, &stItemTextDataArea, GUI_DRAW_NORMAL);
}
}
}
}
/*****************************************************************************/
/** Function Name: GUI_List_SetListItemValue **/
/** Purpose: Set list parameter value if supported. **/
/** Resources: List item data. **/
/** Params: **/
/** @pstList[in]: Pointer of list will be selected. **/
/** @uiItemIndex[in]: Index of list item index will be changed. **/
/** @iSetValid[in]: Valid value will be set. **/
/** @iSetDecimal[in]: Decimal value will be set. **/
/** Return: None. **/
/** Notice: The bind value will update if existed. **/
/*****************************************************************************/
void GUI_List_SetListItemValue(GUI_LIST_STRUCT* pstList, size_t uiItemIndex, int32_t iSetValid, int32_t iSetDecimal)
{
/*----------------------------------*/
/* Variable Declaration */
/*----------------------------------*/
GUI_LIST_ITEM *pstSelectedListItem;
GUI_LIST_CONTROL *pstListControl;
/*----------------------------------*/
/* Initialize */
/*----------------------------------*/
pstSelectedListItem = NULL;
if(NULL != pstList)
{
if(uiItemIndex < pstList->Data.Count)
{
2017-07-31：整理函数、注释名；列表接口追加动态列表控制，可以动态增减列表项目。
2017-07-31 13:29:09 +00:00
pstSelectedListItem = GUI_List_GetListItemPtr(pstList, uiItemIndex);
2017-05-29：基于MIT协议重新发布，原有项目废弃。
2017-05-29 07:54:57 +00:00
}
pstListControl = &(pstList->ControlVariable);
}
/*----------------------------------*/
/* Process */
/*----------------------------------*/
if(NULL != pstSelectedListItem)
{
// Set valid.
if(iSetValid > pstSelectedListItem->Valid.Max)
{
pstSelectedListItem->Valid.Value = pstSelectedListItem->Valid.Max;
}
else if(iSetValid < pstSelectedListItem->Valid.Min)
{
pstSelectedListItem->Valid.Value = pstSelectedListItem->Valid.Min;
}
else
{
pstSelectedListItem->Valid.Value = iSetValid;
}
// Sync bind if existed.
if(NULL != pstSelectedListItem->Valid.Bind)
{
*(pstSelectedListItem->Valid.Bind) = pstSelectedListItem->Valid.Value;
}
// Set decimal.
if(iSetDecimal > pstSelectedListItem->Decimal.Max)
{
pstSelectedListItem->Decimal.Value = pstSelectedListItem->Decimal.Max;
}
else if(iSetDecimal < pstSelectedListItem->Decimal.Min)
{
pstSelectedListItem->Decimal.Value = pstSelectedListItem->Decimal.Min;
}
else
{
pstSelectedListItem->Decimal.Value = iSetDecimal;
}
// Sync bind if existed.
if(NULL != pstSelectedListItem->Decimal.Bind)
{
*(pstSelectedListItem->Decimal.Bind) = pstSelectedListItem->Decimal.Value;
}
// Clear list item area.
GUI_Basic_DrawRectangle(LIST_ITEM_RECT_POSX, pstListControl->FirstVisibleItemPosY+(pstListControl->SelectIndex-pstListControl->PageStartIndex)*pstListControl->ListItemHeight-pstListControl->ItemPosYOffSet,
LIST_ITEM_RECT_WIDTH, pstListControl->ListItemHeight, GUI_COLOR_BKGCLR, GUI_COLOR_BKGCLR);
// refresh list item
GUI_List_DrawItem(pstList, uiItemIndex);
// High light selected item.
GUI_Basic_ReverseBlockColor(LIST_ITEM_RECT_POSX, pstListControl->FirstVisibleItemPosY+(pstListControl->SelectIndex-pstListControl->PageStartIndex)*pstListControl->ListItemHeight-pstListControl->ItemPosYOffSet,
LIST_ITEM_RECT_WIDTH, pstListControl->ListItemHeight);
}
}
/*****************************************************************************/
/** Function Name: GUI_List_GetListItemValue **/
/** Purpose: Get list parameter value if supported. **/
/** Resources: List item data. **/
/** Params: **/
/** @pstList[in]: Pointer of list will be read. **/
/** @uiItemIndex[in]: Index of list item index will be read. **/
2017-07-31：整理函数、注释名；列表接口追加动态列表控制，可以动态增减列表项目。
2017-07-31 13:29:09 +00:00
/** @piValid[out]: Valid value will be read. **/
/** @piDecimal[out]: Decimal value will be read. **/
2017-05-29：基于MIT协议重新发布，原有项目废弃。
2017-05-29 07:54:57 +00:00
/** Return: None. **/
/** Notice: None. **/
/*****************************************************************************/
void GUI_List_GetListItemValue(GUI_LIST_STRUCT* pstList, size_t uiItemIndex, int32_t* piValid, int32_t* piDecimal)
{
/*----------------------------------*/
/* Variable Declaration */
/*----------------------------------*/
GUI_LIST_ITEM *pstSelectedListItem;
/*----------------------------------*/
/* Initialize */
/*----------------------------------*/
pstSelectedListItem = NULL;
if(NULL != pstList)
{
if(uiItemIndex < pstList->Data.Count)
{
2017-07-31：整理函数、注释名；列表接口追加动态列表控制，可以动态增减列表项目。
2017-07-31 13:29:09 +00:00
pstSelectedListItem = GUI_List_GetListItemPtr(pstList, uiItemIndex);
2017-05-29：基于MIT协议重新发布，原有项目废弃。
2017-05-29 07:54:57 +00:00
}
}
/*----------------------------------*/
/* Process */
/*----------------------------------*/
if(NULL != pstSelectedListItem)
{
// Read valid value.
if(NULL != piValid)
{
*piValid = pstSelectedListItem->Valid.Value;
}
// Read decimal value.
if(NULL != piDecimal)
{
*piDecimal = pstSelectedListItem->Decimal.Value;
}
}
}
/*****************************************************************************/
/** Function Name: GUI_List_BindData **/
/** Purpose: Bind a 32-bit integer variable by pointer. **/
/** Resources: List item data. **/
/** Params: **/
/** @pstList[in]: Pointer of list will be read. **/
/** @uiItemIndex[in]: Index of list item index will be read. **/
/** @piValid[out]: Valid variable pointer. **/
/** @piDecimal[out]: Decimal variable pointer. **/
/** Return: None. **/
/** Notice: Variable pointer and decimal variable can be NULL. **/
/*****************************************************************************/
void GUI_List_BindData(GUI_LIST_STRUCT* pstList, size_t uiItemIndex, int32_t* piValid, int32_t* piDecimal)
{
/*----------------------------------*/
/* Variable Declaration */
/*----------------------------------*/
GUI_LIST_ITEM *pstSelectedListItem;
/*----------------------------------*/
/* Initialize */
/*----------------------------------*/
pstSelectedListItem = NULL;
if(NULL != pstList)
2017-07-31：整理函数、注释名；列表接口追加动态列表控制，可以动态增减列表项目。
2017-07-31 13:29:09 +00:00
{
pstSelectedListItem = GUI_List_GetListItemPtr(pstList, uiItemIndex);
}
/*----------------------------------*/
/* Process */
/*----------------------------------*/
if(NULL != pstSelectedListItem)
{
pstSelectedListItem->Valid.Bind = piValid;
pstSelectedListItem->Decimal.Bind = piDecimal;
}
}
/*****************************************************************************/
/** Function Name: GUI_List_GetListItemPtr **/
/** Purpose: Get list item data pointer by index. **/
/** Resources: List item data. **/
/** Params: **/
/** @pstList[in]: Pointer of list will be read. **/
/** @uiItemIndex[in]: Index of list item index will be read. **/
/** Return: None. **/
/** Notice: Variable pointer and decimal variable can be NULL. **/
/*****************************************************************************/
GUI_LIST_ITEM* GUI_List_GetListItemPtr(GUI_LIST_STRUCT* pstList, uint32_t uiItemIndex)
{
/*----------------------------------*/
/* Variable Declaration */
/*----------------------------------*/
GUI_LIST_ITEM *pstSelectedListItem;
#ifdef _SIMPLE_GUI_ENABLE_DYNAMIC_MEMORY_
uint32_t uiItemCounter;
#endif //_SIMPLE_GUI_ENABLE_DYNAMIC_MEMORY_
/*----------------------------------*/
/* Initialize */
/*----------------------------------*/
pstSelectedListItem = NULL;
#ifdef _SIMPLE_GUI_ENABLE_DYNAMIC_MEMORY_
uiItemCounter = 0;
#endif //_SIMPLE_GUI_ENABLE_DYNAMIC_MEMORY_
/*----------------------------------*/
/* Process */
/*----------------------------------*/
if(NULL != pstList)
2017-05-29：基于MIT协议重新发布，原有项目废弃。
2017-05-29 07:54:57 +00:00
{
if(uiItemIndex < pstList->Data.Count)
{
2017-07-31：整理函数、注释名；列表接口追加动态列表控制，可以动态增减列表项目。
2017-07-31 13:29:09 +00:00
#if _SIMPLE_GUI_ENABLE_DYNAMIC_MEMORY_
pstSelectedListItem = pstList->Data.Items;
if(NULL != pstSelectedListItem)
{
while((pstList->Data.Count > 0) && (NULL != pstSelectedListItem->NextItem) && (uiItemCounter < uiItemIndex))
{
pstSelectedListItem = pstSelectedListItem->NextItem;
uiItemCounter++;
}
}
#else
2017-05-29：基于MIT协议重新发布，原有项目废弃。
2017-05-29 07:54:57 +00:00
pstSelectedListItem = pstList->Data.Items+uiItemIndex;
2017-07-31：整理函数、注释名；列表接口追加动态列表控制，可以动态增减列表项目。
2017-07-31 13:29:09 +00:00
#endif // _SIMPLE_GUI_ENABLE_DYNAMIC_MEMORY_
}
}
return pstSelectedListItem;
}
#if _SIMPLE_GUI_ENABLE_DYNAMIC_MEMORY_
/*****************************************************************************/
/** Function Name: GUI_List_InsertItem **/
/** Purpose: Insert a new item to list. **/
/** Resources: List item data. **/
/** Params: **/
/** @pstList[in]: Pointer of list will be read. **/
/** @pstNewItem[in]: New item data pointer. **/
/** @uiItemIndex[in]: Index of new list item. **/
/** Return: **/
/** @TRUE Insert success. **/
/** @FALSE Insert failed. **/
/** Notice: This function only supported when the dynamic list item **/
/** enabled, and new item index cannot greater then list **/
/** item count. **/
/*****************************************************************************/
BOOL GUI_List_InsertItem(GUI_LIST_STRUCT* pstList, GUI_LIST_ITEM* pstNewItem, uint32_t uiNewItemIndex)
{
/*----------------------------------*/
/* Variable Declaration */
/*----------------------------------*/
GUI_LIST_ITEM *pstListItemDataSource;
GUI_LIST_ITEM *pstNewListItem, *pstPosItem;
GUI_LIST_DATA *pstListData;
BOOL bResult;
/*----------------------------------*/
/* Initialize */
/*----------------------------------*/
pstListItemDataSource = pstNewItem;
pstNewListItem = NULL;
pstPosItem = NULL;
bResult = TRUE;
pstListData = &(pstList->Data);
/*----------------------------------*/
/* Process */
/*----------------------------------*/
if(uiNewItemIndex > pstList->Data.Count)
{
bResult = FALSE;
}
else
{
pstNewListItem = (GUI_LIST_ITEM*)GUI_Common_Allocate(sizeof(GUI_LIST_ITEM));
if(NULL != pstNewListItem)
{
GUI_Common_MemoryCopy(pstNewListItem, pstListItemDataSource, sizeof(GUI_LIST_ITEM));
if(0 == pstList->Data.Count)
{
pstNewListItem->NextItem = NULL;
pstNewListItem->PrevItem = NULL;
pstListData->Items = pstNewListItem;
}
else if(uiNewItemIndex == pstList->Data.Count)
{
pstPosItem = GUI_List_GetListItemPtr(pstList, uiNewItemIndex-1);
pstPosItem->NextItem = pstNewListItem;
pstNewListItem->PrevItem = pstPosItem;
pstNewListItem->NextItem = NULL;
}
else //if((uiNewItemIndex>0)&&(uiNewItemIndex<pstListData->Count))
{
pstPosItem = GUI_List_GetListItemPtr(pstList, uiNewItemIndex);
pstNewListItem->PrevItem = pstPosItem->PrevItem;
pstNewListItem->NextItem = pstPosItem;
if(NULL != pstPosItem->PrevItem)
{
pstPosItem->PrevItem->NextItem = pstNewListItem;
}
else
{
// Insert to list head, repointer the list head pointer.
pstListData->Items = pstNewListItem;
}
pstPosItem->PrevItem = pstNewListItem;
}
pstList->Data.Count++;
2017-05-29：基于MIT协议重新发布，原有项目废弃。
2017-05-29 07:54:57 +00:00
}
}
2017-07-31：整理函数、注释名；列表接口追加动态列表控制，可以动态增减列表项目。
2017-07-31 13:29:09 +00:00
return bResult;
}
/*****************************************************************************/
/** Function Name: GUI_List_RemoveItem **/
/** Purpose: Remove a item from list. **/
/** Resources: List item data. **/
/** Params: **/
/** @pstList[in]: Pointer of list will be read. **/
/** @uiItemIndex[in]: Index of list item will be removed. **/
/** Return: **/
/** @TRUE Remove success. **/
/** @FALSE Remove failed. **/
/** Notice: This function only supported when the dynamic list item **/
/** enabled, and index of removed item cannot greater then **/
/** list item count. **/
/*****************************************************************************/
BOOL GUI_List_RemoveItem(GUI_LIST_STRUCT* pstList, uint32_t uiNewItemIndex)
{
/*----------------------------------*/
/* Variable Declaration */
/*----------------------------------*/
GUI_LIST_ITEM *pstRemoveListItem;
BOOL bResult;
/*----------------------------------*/
/* Initialize */
/*----------------------------------*/
pstRemoveListItem = GUI_List_GetListItemPtr(pstList, uiNewItemIndex);
bResult = TRUE;
2017-05-29：基于MIT协议重新发布，原有项目废弃。
2017-05-29 07:54:57 +00:00
/*----------------------------------*/
/* Process */
/*----------------------------------*/
2017-07-31：整理函数、注释名；列表接口追加动态列表控制，可以动态增减列表项目。
2017-07-31 13:29:09 +00:00
if(NULL != pstRemoveListItem)
2017-05-29：基于MIT协议重新发布，原有项目废弃。
2017-05-29 07:54:57 +00:00
{
2017-07-31：整理函数、注释名；列表接口追加动态列表控制，可以动态增减列表项目。
2017-07-31 13:29:09 +00:00
if(NULL != pstRemoveListItem->PrevItem)
{
pstRemoveListItem->PrevItem->NextItem = pstRemoveListItem->NextItem;
}
if(NULL != pstRemoveListItem->NextItem)
{
pstRemoveListItem->NextItem->PrevItem = pstRemoveListItem->PrevItem;
}
if(0 == uiNewItemIndex)
{
pstList->Data.Items = pstRemoveListItem->NextItem;
}
GUI_Common_Free(pstRemoveListItem);
pstList->Data.Count--;
2017-05-29：基于MIT协议重新发布，原有项目废弃。
2017-05-29 07:54:57 +00:00
}
2017-07-31：整理函数、注释名；列表接口追加动态列表控制，可以动态增减列表项目。
2017-07-31 13:29:09 +00:00
return bResult;
2017-05-29：基于MIT协议重新发布，原有项目废弃。
2017-05-29 07:54:57 +00:00
}
2017-07-31：整理函数、注释名；列表接口追加动态列表控制，可以动态增减列表项目。
2017-07-31 13:29:09 +00:00
#endif // _SIMPLE_GUI_ENABLE_DYNAMIC_MEMORY_
Reference in New Issue Copy Permalink