为OLED屏增加GUI支持4：文本框控件

本文博客链接:http://blog.csdn.net/jdh99,作者:jdh,转载请注明.

环境：

主机:WIN10

开发环境:MDK5.13

MCU:STM32F103

说明：

本文定义了文本框控件。在gui中增加了字库支持后，就可以用文本框来显示字符。

源代码：

gui_widget_text.h

/**
* Copyright (c), 2015-2025
* @file gui_widget_text.h
* @brief 文本控件头文件
* @author jdh
* @date 2015/9/8
*/

#ifndef _GUI_WIDGET_TEXT_H_
#define _GUI_WIDGET_TEXT_H_

/*********************************************************************
*							头文件
**********************************************************************/

#include "gui_interface.h"

/*********************************************************************
*							宏定义
**********************************************************************/

/**
* @brief 文本长度.单位:字节
*/

#define LEN_WIDGET_TEXT				32

/*********************************************************************
*							数据结构
**********************************************************************/

/**
* @brief 文本框数据结构
*/

typedef struct _Widget_Text
{
	//x轴位置
	uint16_t x;
	//y轴位置
	uint16_t y;
	//水平尺寸
	uint16_t xsize;
	//垂直尺寸
	uint16_t ysize;
	//字体
	uint8_t font;
	//文本
	char s[LEN_WIDGET_TEXT];
}*Widget_Text_Handle;

/*********************************************************************
*							函数
**********************************************************************/

/**
* @brief 创建控件text
* @param x:左上角x坐标
* @param y:左上角y坐标
* @param xsize:水平尺寸
* @param ysize:垂直尺寸
* @param font:字体
* @param s:文本
* @retval 控件句柄
*/

Widget_Text_Handle gui_widget_text_create(uint16_t x,uint16_t y,uint16_t xsize,uint16_t ysize,uint8_t font,char *s);

/**
* @brief 设置文本
* @param s:文本
*/

void gui_widget_text_set_text(Widget_Text_Handle handle,uint8_t font,char *s);

#endif

gui_widget_text.c

/**
* Copyright (c), 2015-2025
* @file gui_widget_text.c
* @brief 文本控件主文件
* @author jdh
* @date 2015/9/8
*/

/*********************************************************************
*							头文件
**********************************************************************/

#include "gui_widget_text.h"
#include "gui_2d_lib.h"
#include "gui_text_lib.h"
#include "stdlib.h"
#include "string.h"

/*********************************************************************
*							静态函数
**********************************************************************/

/**
* @brief 控件显示
* @param handle:控件句柄
*/

static void show(Widget_Text_Handle handle);

/*********************************************************************
*							函数
**********************************************************************/

/**
* @brief 创建控件text
* @param x:左上角x坐标
* @param y:左上角y坐标
* @param xsize:水平尺寸
* @param ysize:垂直尺寸
* @param font:字体
* @param s:文本
* @retval 控件句柄
*/

Widget_Text_Handle gui_widget_text_create(uint16_t x,uint16_t y,uint16_t xsize,uint16_t ysize,uint8_t font,char *s)
{
	Widget_Text_Handle handle;

	//控件初始化
	handle = malloc(sizeof(*handle));
	handle->x = x;
	handle->y = y;
	handle->xsize = xsize;
	handle->ysize = ysize;
	handle->font = font;
	strcpy(handle->s,s);

	//显示
	show(handle);

	return handle;
}

/**
* @brief 设置文本
* @param s:文本
*/

void gui_widget_text_set_text(Widget_Text_Handle handle,uint8_t font,char *s)
{
	handle->font = font;
	strcpy(handle->s,s);

	//显示
	show(handle);
}

/**
* @brief 控件显示
* @param handle:控件句柄
*/

static void show(Widget_Text_Handle handle)
{
	//清除区域
	gui_fill_rect(handle->x,handle->y,handle->x + handle->xsize,handle->y + handle->ysize,0);
	//显示
	gui_disp_string_at(handle->x,handle->y,handle->font,handle->s);
}

使用示例：

Widget_Text_Handle Widget_Text_State;
Widget_Text_State = gui_widget_text_create(93,40,30,20,GB18030_20X20,"正常");