【emWin实战教程V2.0】第59章 SCROLLBAR-滚动条控件

参与人数 1

转最新版本教程
本章节为大家讲解STemWin支持的滚动条控件，滚动条控件基本不单独使用，都是附加到多行文本控件，下拉列表控件，listview等控件上面使用，所以我们本章节配套的例子也是采用附加方式创建滚动条，突出实战性。对于官方提供的直接创建方式和间接创建方式不做讲解。
      59.1 初学者重要提示
      59.2 滚动条控件基础知识
      59.3 实验例程说明（RTOS）
      59.4 实验例程说明（裸机）
      59.5 总结

lee_st · 2017-3-28 09:34:16

59.1 初学者重要提示

1、本教程配套的emWin版本是5.32，从emWin5.28版本开始，皮肤色是自动使能的，所以部分滚动条控件的API函数是失效的，主要是滚动条控件颜色设置函数，此问题经常被初学者问。

lee_st · 2017-3-28 09:34:28

2、滚动条控件的所有API函数在emWin手册中都有讲解，下图是中文版手册里面API函数位置：

lee_st · 2017-3-28 09:34:38

下图是英文版手册里面API函数的位置：

lee_st · 2017-3-28 09:34:49

59.2 滚动条控件基础知识

滚动条控件基本不单独使用，都是附加到多行文本控件，下拉列表控件，listview等控件上面。例如下图所示的下拉列表中附加的滚动条：

不开启皮肤色时，滚动条控件的显示效果如下：

lee_st · 2017-3-28 09:35:02

设置皮肤后显示效果如下（滚动条可以创建成垂直的，也可以创建成水平的）：

lee_st · 2017-3-28 09:35:11

59.2.1 滚动条控件支持的通知代码

滚动条控件支持的通知代码主要是用来处理滚动条消息用的，滚动条主要支持四种消息事件，点击消息，释放消息，滚动条刚添加到窗口上的通知消息和滚动条中滚动位置发生改变的消息。比如用户通过触摸屏点击了滚动条，窗口管理器会给滚动条父窗口回调函数发送消息WM_NOTIFY_PARENT来通知父窗口，进而再区分是四种消息中的哪一种，用户就可以在相应的消息代码里面加入要实现的功能。

以下事件是作为WM_NOTIFY_PARENT消息的一部分由滚动条发送给其父窗口，用来区分不同的滚动条消息。

图片:9.6.png

实际项目中，滚动条的通知消息很少用到。

lee_st · 2017-3-28 09:35:21

59.2.2 滚动条控件支持的键盘反应（输入聚焦）

滚动条支持输入聚焦，也支持外置键盘或者类似外置键盘的输入设备给滚动条控件发消息。当前仅支持以下六种按键消息：
（输入聚焦是一个重要的知识点，使用外置键盘或者类似外置键盘的输入设备要用到）

特别注意一点，对于滚动条控件来说，要先聚焦到这个控件上了，给滚动条控件发按键消息才会有反应。

lee_st · 2017-3-28 09:35:29

59.2.3 滚动条控件API函数

实际项目中，我们既不使用直接创建函数SCROLLBAR_Create创建滚动条，也不使用间距创建函数SCROLLBAR_CreateIndirect，因为下拉列表控件，多行文本控件，listview等控件的滚动条都是可以通过各自的API函数自动使能的，比如多行文本控件的垂直滚动条使能函数MULTIEDIT_SetAutoScrollH()。但是自动使能的滚动条都比较窄，我们希望将其加宽，此时我们就可以使用函数：

lee_st · 2017-3-28 09:35:36

SCROLLBAR_CreateAttached将滚动条附加到窗口上，通过这个函数返回的句柄，我们就可以调用滚动条的API函数操作此控件了。实际项目中推荐大家这么做，本章节配套的例子也是采用的这种方法给多行文本控件添加一个垂直滚动条，代码如下：

lee_st · 2017-3-28 09:35:43

#include "DIALOG.h"

/*
*********************************************************************************************************
*                                         变量
*********************************************************************************************************
*/
const char AddressURL[] = "www.armfly.comn"
                          "STM32-V1n"
                          "STM32-V2n"
                          "STM32-V3n"
                           "STM32-V4n"
                          "STM32-V5n"
                          "STM32-V6n"
                          "STM32-V7n"
                          "STM32-V8n"
                           "STM32-V9n"
                          "STM32-V10n";

/*
*********************************************************************************************************
*                                         宏定义
*********************************************************************************************************
*/
#define ID_FRAMEWIN_0   (GUI_ID_USER + 0x00)
#define ID_MULTIEDIT_0  (GUI_ID_USER + 0x01)

/*
*********************************************************************************************************
*                           GUI_WIDGET_CREATE_INFO类型数组
*********************************************************************************************************
*/
static const GUI_WIDGET_CREATE_INFO _aDialogCreate[] =
{
     { FRAMEWIN_CreateIndirect, "Framewin", ID_FRAMEWIN_0, 0, 0, 800, 480, 0, 0x0, 0 },
     { MULTIEDIT_CreateIndirect, "Multiedit", ID_MULTIEDIT_0, 40, 30, 200, 120, 0, 0x0, 0 },
};

/*
*********************************************************************************************************
*    函数名: _cbDialog
*    功能说明: 对话框回调函数
*    形    参: pMsg  回调参数
*    返回值: 无
*********************************************************************************************************
*/
static void _cbDialog(WM_MESSAGE * pMsg)
{
     WM_HWIN hItem;
     SCROLLBAR_Handle hScroll;
     int     NCode;
     int     Id;

     switch (pMsg->MsgId)
     {
         case WM_INIT_DIALOG:

              //
              // 初始化框架窗口
              //
              hItem = pMsg->hWin;
              FRAMEWIN_SetFont(hItem, GUI_FONT_32B_ASCII);
              FRAMEWIN_SetText(hItem, "armfly");
              FRAMEWIN_SetTextAlign(hItem, GUI_TA_HCENTER | GUI_TA_VCENTER);

              //
              // 初始化多行文本控件
              //
              hItem = WM_GetDialogItem(pMsg->hWin, ID_MULTIEDIT_0);
              MULTIEDIT_SetText(hItem, AddressURL);
              MULTIEDIT_SetFont(hItem, GUI_FONT_16_ASCII);

              /* 使能多行文本的插入模式 */
              MULTIEDIT_SetInsertMode(hItem, 1);

              /* 将滚动条附加到多行文本控件 */
              hScroll = SCROLLBAR_CreateAttached(hItem, GUI_ID_VSCROLL);
              /* 设置滚动条的宽度 */
              SCROLLBAR_SetWidth(hScroll, 15);
              break;

         case WM_NOTIFY_PARENT:
              Id    = WM_GetId(pMsg->hWinSrc);
              NCode = pMsg->Data.v;
              switch(Id)
              {
                   case ID_MULTIEDIT_0:
                   switch(NCode)
                   {
                       case WM_NOTIFICATION_CLICKED:
                            break;

                       case WM_NOTIFICATION_RELEASED:
                            break;

                       case WM_NOTIFICATION_VALUE_CHANGED:
                            break;
                   }
                   break;
              }
              break;

         default:
              WM_DefaultProc(pMsg);
              break;
     }
}

/*
*********************************************************************************************************
*    函数名: CreateFramewin
*    功能说明: 创建对话框
*    形    参: 无
*    返回值: 返回对话框句柄
*********************************************************************************************************
*/
WM_HWIN CreateFramewin(void)
{
     WM_HWIN hWin;

     hWin = GUI_CreateDialogBox(_aDialogCreate, GUI_COUNTOF(_aDialogCreate), _cbDialog, WM_HBKWIN, 0, 0);
     return hWin;
}

lee_st · 2017-3-28 09:35:52

在对话框的初始化消息WM_INIT_DIALOG里面调用函数：
hScroll = SCROLLBAR_CreateAttached(hItem,GUI_ID_VSCROLL)将滚动条附加到多行文本控件上，返回的句柄hScroll就是滚动条的，通过这个句柄，用户就可以调用滚动条相关的API函数来操作它，我们这里是调用函数SCROLLBAR_SetWidth(hScroll, 15)将滚动条的宽度设置为15个像素。
其实不光多行文本控件，任何其它支持滚动条的控件都可以采用这种方法，简单有效。

lee_st · 2017-3-28 09:36:03

59.3实验例程说明（RTOS）

实验目的：
      1.    本实验主要学习滚动条控件的使用。
      2.    emWin功能的实现在MainTask.c文件里面。
实验内容：
      1.    K1按键按下，串口打印任务执行情况（波特率115200，数据位8，奇偶校验位无，停止位1）。
      2.    K2按键按下，实现截图功能，将图片以BMP格式保存到SD卡中。
      3.    GUI任务在对话框上面创建了一个多行文本控件，将滚动条控件附加到多行文本控件上。
      4.    各个任务实现的功能如下：
            App Task Start 任务：实现按键和触摸扫描。
            App Task MspPro任务：实现截图功能，将图片以BMP格式保存到SD卡中。
            App Task UserIF  任务：按键消息处理。
            App Task COM 任务：暂未使用。
         App Task GUI 任务：GUI任务。

lee_st · 2017-3-28 09:36:14

μCOS-III任务调试信息（按K1按键，串口打印）：

lee_st · 2017-3-28 09:41:43

STemWin界面显示效果：
800*480分辨率界面效果。

lee_st · 2017-3-28 09:42:23

STemWin动态内存配置：
      GUIConf.c文件中的配置如下：
#define EX_SRAM   1/*1 used extern sram, 0 used internal sram */

#if EX_SRAM
#define GUI_NUMBYTES  (1024*1024*8)
#else
#define GUI_NUMBYTES  (100*1024)
#endif

lee_st · 2017-3-28 09:42:40

通过宏定义来配置使用内部SRAM还是外部的SDRAM做为emWin的动态内存，当配置：
#define EX_SRAM 1 表示使用外部SDRAM作为emWin动态内存，大小8MB。
#define EX_SRAM 0 表示使用内部SRAM作为emWin动态内存，大小100KB。
默认情况下，本教程配套的所有emWin例子都是用外部SDRAM作为emWin动态内存。

lee_st · 2017-3-28 09:42:49

通过宏定义来配置使用内部SRAM还是外部的SDRAM做为emWin的动态内存，当配置：
#define EX_SRAM 1 表示使用外部SDRAM作为emWin动态内存，大小8MB。
#define EX_SRAM 0 表示使用内部SRAM作为emWin动态内存，大小100KB。
默认情况下，本教程配套的所有emWin例子都是用外部SDRAM作为emWin动态内存。

lee_st · 2017-3-28 09:43:30

STemWin底层接口配置：
      LCDConf_Lin_Template.c文件中共12项emWin配置：
/*
**********************************************************************************************************
                                          用户可以配置的选项
**********************************************************************************************************
*/
/* 0. 在官方代码的基础上再做优化，官方的部分函数效率低，耗内存, 0表示优化 */
#define emWin_Optimize   0

/*
  1. 显示屏的物理分辨率，驱动已经做了显示屏自适应，支持4.3寸，5寸和7寸屏
     这里填写自适应显示屏中的最大分辨率。
*/
#define XSIZE_PHYS       800
#define YSIZE_PHYS       480

/* 2. 多缓冲 / 虚拟屏，多缓冲和虚拟屏不可同时使用，emWin不支持 */
#define NUM_BUFFERS      3 /* 定义多缓冲个数，仅可以设置1,2和3，也就是最大支持三缓冲 */
#define NUM_VSCREENS     1 /* 定义虚拟屏个数 */

/* 3. 没有图层激活时，背景色设置, 暂时未用到 */
#define BK_COLOR         GUI_DARKBLUE

/*
   4. 重定义图层数，对于STM32F429/439，用户可以选择一个图层或者两个图层，不支持三图层
      (1). 设置GUI_NUM_LAYERS = 1时，即仅使用图层1时，默认触摸值是发送给图层1的。
       (2). 设置GUI_NUM_LAYERS = 2时，即图层1和图层2都已经使能，此时图层2是顶层，
            用户需要根据自己的使用情况设置如下两个地方。
            a. 在bsp_touch.c文件中的函数TOUCH_InitHard里面设置参数State.Layer = 1，1就表示
               给图层2发送触摸值。
            b. 调用GUI_Init函数后，调用函数GUI_SelectLayer(1), 设置当前操作的是图层2。
*/
#undef  GUI_NUM_LAYERS
#define GUI_NUM_LAYERS    1

/*
   5. 设置图层1和图层2对应的显存地址
      (1) EXT_SDRAM_ADDR 是SDRAM的首地址。
      (2) LCD_LAYER0_FRAME_BUFFER 是图层1的显存地址。
       (3) LCD_LAYER1_FRAME_BUFFER 是图层2的显存地址。
       (4) 每个图层的显存大小比较考究，这里进行下简单的说明。
           如果用户选择的颜色模式 = 32位色ARGB8888，显存的大小：
           XSIZE_PHYS * YSIZE_PHYS * 4 * NUM_VSCREENS * NUM_BUFFERS

           颜色模式 = 24位色RGB888，显存的大小：
           XSIZE_PHYS * YSIZE_PHYS * 3 * NUM_VSCREENS * NUM_BUFFERS

           颜色模式 = 16位色RGB566，ARGB1555, ARGB4444，AL88，那么显存的大小就是：
           XSIZE_PHYS * YSIZE_PHYS * 2 * NUM_VSCREENS * NUM_BUFFERS

           颜色模式 = 8位色L8，AL44，那么显存的大小就是：
           XSIZE_PHYS * YSIZE_PHYS * 1 * NUM_VSCREENS * NUM_BUFFERS

      这里为了方便起见，将开发板配套的16MB的SDRAM前8MB分配给LCD显存使用，后8MB用于emWin动态内存。
       对于24位色，16位色，8位色，用户可以对其使能三缓冲，并且使能双图层。但是32位色也使能三缓冲和双
       图层的话会超出8MB，所以用户根据自己的情况做显存和emWin动态内存的分配调整。
         举一个例子，对于800*480分辨率的显示屏，使能32位色，三缓冲，那么最终一个图层需要的大小就是
      800 * 480 * 4 * 3  = 4.394MB的空间，如果是双图层，已经超出8MB的分配范围。

      (5)为了方便起见，图层2的宏定义LCD_LAYER1_FRAME_BUFFER中的参数4是按照32位色设置的，如果用户的图层1
         使用的是8位色，这里填数字1,如果是16位色，这里填2，如果是24位色，这里填3。
*/
#define LCD_LAYER0_FRAME_BUFFER  EXT_SDRAM_ADDR
#define LCD_LAYER1_FRAME_BUFFER  (LCD_LAYER0_FRAME_BUFFER + XSIZE_PHYS * YSIZE_PHYS * 4 * NUM_VSCREENS *
NUM_BUFFERS)

/*
   6. STM32F429/439支持的颜色模式，所有模式都支持，用户可任意配置。
      特别注意如下两个问题：
       (1) 如果用户选择了ARGB8888或者RGB888模式，LCD闪烁比较厉害的话，
           请降低LTDC的时钟大小，在文件bsp_tft_429.c的函数LCD_ConfigLTDC里面设置。
           a. 一般800*480分辨率的显示屏，ARGB8888或者RGB888模式LTDC时钟选择10-20MHz即可。
           b. 480*272分辨率的可以高些，取20MHz左右即可。
       (2) 16位色或者8位色模式，LTDC的时钟频率一般可以比24位色或者32位色的高一倍。
*/
#define _CM_ARGB8888      1
#define _CM_RGB888        2
#define _CM_RGB565        3
#define _CM_ARGB1555      4
#define _CM_ARGB4444      5
#define _CM_L8            6
#define _CM_AL44          7
#define _CM_AL88          8

/* 7. 配置图层1的颜色模式和分辨率大小 */
#define COLOR_MODE_0      _CM_RGB565
#define XSIZE_0           XSIZE_PHYS
#define YSIZE_0           YSIZE_PHYS

/* 8. 配置图层2的的颜色模式和分辨率大小 */
#define COLOR_MODE_1      _CM_RGB565
#define XSIZE_1           XSIZE_PHYS
#define YSIZE_1           YSIZE_PHYS

/* 9. 单图层情况下，根据用户选择的颜色模式可自动选择图层1的emWin的驱动和颜色模式 */
#if   (COLOR_MODE_0 == _CM_ARGB8888)
  #define COLOR_CONVERSION_0 GUICC_M8888I
  #define DISPLAY_DRIVER_0   GUIDRV_LIN_32
#elif (COLOR_MODE_0 == _CM_RGB888)
  #define COLOR_CONVERSION_0 GUICC_M888
  #define DISPLAY_DRIVER_0   GUIDRV_LIN_24
#elif (COLOR_MODE_0 == _CM_RGB565)
  #define COLOR_CONVERSION_0 GUICC_M565
  #define DISPLAY_DRIVER_0   GUIDRV_LIN_16
#elif (COLOR_MODE_0 == _CM_ARGB1555)
  #define COLOR_CONVERSION_0 GUICC_M1555I
  #define DISPLAY_DRIVER_0   GUIDRV_LIN_16
#elif (COLOR_MODE_0 == _CM_ARGB4444)
  #define COLOR_CONVERSION_0 GUICC_M4444I
  #define DISPLAY_DRIVER_0   GUIDRV_LIN_16
#elif (COLOR_MODE_0 == _CM_L8)
  #define COLOR_CONVERSION_0 GUICC_8666
  #define DISPLAY_DRIVER_0   GUIDRV_LIN_8
#elif (COLOR_MODE_0 == _CM_AL44)
  #define COLOR_CONVERSION_0 GUICC_1616I
  #define DISPLAY_DRIVER_0   GUIDRV_LIN_8
#elif (COLOR_MODE_0 == _CM_AL88)
  #define COLOR_CONVERSION_0 GUICC_88666I
  #define DISPLAY_DRIVER_0   GUIDRV_LIN_16
#else
  #error Illegal color mode 0!
#endif

/* 10. 双图层情况下，根据用户选择的颜色模式可自动选择图层2的emWin的驱动和颜色模式 */
#if (GUI_NUM_LAYERS > 1)

#if   (COLOR_MODE_1 == _CM_ARGB8888)
  #define COLOR_CONVERSION_1 GUICC_M8888I
  #define DISPLAY_DRIVER_1   GUIDRV_LIN_32
#elif (COLOR_MODE_1 == _CM_RGB888)
  #define COLOR_CONVERSION_1 GUICC_M888
  #define DISPLAY_DRIVER_1   GUIDRV_LIN_24
#elif (COLOR_MODE_1 == _CM_RGB565)
  #define COLOR_CONVERSION_1 GUICC_M565
  #define DISPLAY_DRIVER_1   GUIDRV_LIN_16
#elif (COLOR_MODE_1 == _CM_ARGB1555)
  #define COLOR_CONVERSION_1 GUICC_M1555I
  #define DISPLAY_DRIVER_1   GUIDRV_LIN_16
#elif (COLOR_MODE_1 == _CM_ARGB4444)
  #define COLOR_CONVERSION_1 GUICC_M4444I
  #define DISPLAY_DRIVER_1   GUIDRV_LIN_16
#elif (COLOR_MODE_1 == _CM_L8)
  #define COLOR_CONVERSION_1 GUICC_8666
  #define DISPLAY_DRIVER_1   GUIDRV_LIN_8
#elif (COLOR_MODE_1 == _CM_AL44)
  #define COLOR_CONVERSION_1 GUICC_1616I
  #define DISPLAY_DRIVER_1   GUIDRV_LIN_8
#elif (COLOR_MODE_1 == _CM_AL88)
  #define COLOR_CONVERSION_1 GUICC_88666I
  #define DISPLAY_DRIVER_1   GUIDRV_LIN_16
#else
  #error Illegal color mode 1!
#endif

#else

#undef XSIZE_0
#undef YSIZE_0
#define XSIZE_0       XSIZE_PHYS
#define YSIZE_0       YSIZE_PHYS

#endif

/*11. 配置选项检测，防止配置错误或者某些选项没有配置 */
#ifndef   XSIZE_PHYS
  #error Physical X size of display is not defined!
#endif
#ifndef   YSIZE_PHYS
  #error Physical Y size of display is not defined!
#endif
#ifndef   NUM_VSCREENS
  #define NUM_VSCREENS 1
#else
  #if (NUM_VSCREENS <= 0)
    #error At least one screeen needs to be defined!
  #endif
#endif
#if (NUM_VSCREENS > 1) && (NUM_BUFFERS > 1)
  #error Virtual screens and multiple buffers are not allowed!
#endif

lee_st · 2017-3-28 09:43:46

对于这12个配置选项，注释说明已经比较详细。默认情况下，本教程配套的emWin例子都是用的三缓冲，RGB565格式，且仅使用单图层。
程序设计：
任务栈大小分配：
      μCOS-III任务栈大小在os_cfg.h文件中配置：
#define  APP_CFG_TASK_START_STK_SIZE                   512u
#define  APP_CFG_TASK_MsgPro_STK_SIZE                   512u
#define  APP_CFG_TASK_COM_STK_SIZE                      512u
#define  APP_CFG_TASK_USER_IF_STK_SIZE                   512u
#define  APP_CFG_TASK_GUI_STK_SIZE                      1024u
      任务栈大小的单位是4字节，那么每个任务的栈大小如下：
      App Task Start 任务：2048字节。
   App Task MspPro任务：2048字节。
   App Task UserIF  任务：2048字节。
   App Task COM 任务：2048字节。
      App Task GUI 任务：4096字节。

搜索历史

【emWin实战教程V2.0】第59章 SCROLLBAR-滚动条控件

评分

相关推荐

46 条评论

评分

评分

评分

评论

精选推荐

热门帖

站长推荐 /7