VincentWei/minigui-docs
1
0
Fork 0
mirror of https://github.com/VincentWei/minigui-docs.git synced 2025-10-19 20:13:25 +08:00
Code Issues Packages Projects Releases Wiki Activity
Files
355eda49fd9b6d66c03da02fc70667a9ed9b78f8
minigui-docs/programming-guide/MiniGUIProgGuidePart2Chapter11.md
Vincent Wei 355eda49fd fix bad format manually
2019-10-28 17:18:32 +08:00

12 KiB
Raw Blame History

第二部分 第十章 进度条控件

Chapter 10 of Part 2 Progress Bar Control

进度条控件简介

Brief Introduction of Progress Bar Control

进度条控件（ProgressBar）是GUI系统中不可或缺的的重要控件之一，可以直观的表示出某项的进度，在进行文件复制、软件安装、文件传输时经常用到。mGNCS中的进度条控件基于MiniGUI 3.0中内置的进度条控件进行了增强和重构，增加了渲染器的设置，使其更加易用，更加绚丽。

Progress bar control is an essential control in GUI system, which can visually show progress of an item and is often used in file copying, software installation and file transmission. Progress bar control in mGNCS is strengthened and reconstructed based on the built-in progress bar control in MiniGUI 3.0, and setting of renderer is added, making it easier to use and more splendid.

  • Class hierarchical relation of progress bar
  • mWidget

mProgressBar

mProgressBar

  • 控件窗口类: NCSCTRL_PROGRESSBAR

  • 控件英文名: ProgressBar

  • 简介: 用于表示进度，在进行文件复制、软件安装、文件传输时经常用到。

  • 示意图:

  • Control window class: NCSCTRL_PROGRESSBAR

  • Control English name: ProgressBar

  • Brief introduction: Used to show progress, often used in file copying, software installation and file transmission.

  • Schematic diagram:

mProgressBar风格

Style of mProgressBar

继承自mWidget的风格 | 风格ID | miniStudio属性名 | 说明 || | NCSS_PRGBAR_HORIZONTAL | -- | miniStudio中将这两种风格分成了两个控件来使用 分别对应为| Horz ProgressBar | | NCSS_PRGBAR_VERTICAL | -- | ^ | Vert ProgressBar | | NCSS_PRGBAR_BLOCKS | BlockChunk->TRUE | 块状进度 | prog_block.png | | NCSS_PRGBAR_SMOOTH | BlockChunk->FALSE | 平滑进度，与上面的块状进度相对 | prog_smooth.png | | NCSS_PRGBAR_SHOWPERCENT | ShowPercent | 显示当前进度值（百分比)| prog_per.png |

It is inherited from the style of mWidget | Style ID | *miniStudio property * | Explanation || | NCSS_PRGBAR_HORIZONTAL | -- | In miniStudio, the two styles are divided into two controls to use, respectively corresponding to| Horz ProgressBar | | NCSS_PRGBAR_VERTICAL | -- | ^ | Vert ProgressBar | | NCSS_PRGBAR_BLOCKS | BlockChunk->TRUE | Block progress | prog_block.png | | NCSS_PRGBAR_SMOOTH | BlockChunk->FALSE | Smooth progress, relative to the above block progress | prog_smooth.png | | NCSS_PRGBAR_SHOWPERCENT | ShowPercent | Display the current progress value (percentage)| prog_per.png |

mProgressBar属性

Property of mProgressBar

继承自mWidget的属性 | 属性名 |miniStudio属性名 | 类型 | RW | 说明 | | NCSP_PROG_MAXPOS | MaxPos | int | RW | 进度范围最大值 | | NCSP_PROG_MINPOS | MinPos | int | RW | 进度范围最小值 | | NCSP_PROG_CURPOS | CurPos | int | RW | 当前进度值 | | NCSP_PROG_LINESTEP | LineStep | int | RW | 步长 |

It is inherited from the property of mWidget | Property name |miniStudio property name | Type | RW | Explanation | | NCSP_PROG_MAXPOS | MaxPos | int | RW | Maximum value of the progress range | | NCSP_PROG_MINPOS | MinPos | int | RW | Minimum value of the progress range | | NCSP_PROG_CURPOS | CurPos | int | RW | Current progress value | | NCSP_PROG_LINESTEP | LineStep | int | RW | Step length |

mProgressBar事件

Event of mProgressBar

继承自mWidget的事件
%RED% 该控件类没有新增事件 %ENDCOLOR%

It is inherited from the event of mWidget
%RED% The control class does not have newly added event %ENDCOLOR%

mProgressBar方法

Method of mProgressBar

继承自mWidget的方法

It is inherited from the method of mWidget

increase

int increase (mProgressBar *self, int delta);

  • 参数：

  • self ：控件对象指针

  • delta ：增加幅度

  • 说明 ： 用户可以使用改函数控制进度值的增加，delta用来指定增加的量，一般用来控制非匀速的增长效果

  • 示例 ：

  • Parameter:

  • self ：control object pointer

  • delta ：increase amplitude

  • Explanation: users can use the function to control increase of the progress value; delta is used to appoint the increase amount, which is generally used to control the increase effect of non even speed

  • Example:

_c(pb)->increase (pb, 5);    //进度值增加5 //The progress value increases 5

stepIncrease

int stepIncrease (mProgressBar *_this);

  • 参数：

  • self ：控件对象指针

  • 说明：该函数可以步进增加进度值，每调用一次增加一个步长值，可以实现匀速的增长效果，步长值的设定通过相应的属性来完成

  • 示例 ：

  • Parameter:

  • self ：control object pointer

  • Explanation: the function can increase the progress value by step; calling once, a step length value is increased, and even-speed increase effect can be realized; setting of step length value is completed through corresponding properties

  • Example:

//设置ProgressBar的步进长度
// Set step length of ProgressBar
_c(pb)->setProperty(pb, NCSP_PROG_LINESTEP, 5);
......
_c(pb)->stepIncrease (pb);

mProgressBar渲染器

Renderer of mProgressBar

classic渲染器

Classic Renderer

继承自mWidget的classic渲染器
| 属性名 |miniStudio属性名 | 类型 | 示意图 | 说明 | | NCS_BGC_HILIGHT_ITEM | ChunkColor | DWORD（ARGB） | classic_prog.png | 进度条的chunk部分的颜色，本渲染器使用高亮item的颜色绘制 |

It is inherited from the classic renderer of mWidget
| Property name |*miniStudio property * | Type | Schematic diagram | Explanation | | NCS_BGC_HILIGHT_ITEM | ChunkColor | DWORD（ARGB） | classic_prog.png | Color of chunk part of the progress bar, and this renderer uses the color of highlight item to draw |

fashion渲染器

Fashion Renderer

继承自mWidget的fashion渲染器
| 属性名 |miniStudio属性名 | 类型 | 示意图 | 说明 | | NCS_BGC_PRGBAR_CHUNK | ChunkColor | DWORD（ARGB） | fsh_prog.png | 进度条的chunk部分的基础颜色，渲染器会根据这个颜色进行减淡、加深，来绘制渐变效果的进度条 |

It is inherited from the fashion renderer of mWidget
| Property name |miniStudio property name | Type | Schematic diagram | Explanation | | NCS_BGC_PRGBAR_CHUNK | ChunkColor | DWORD（ARGB） | fsh_prog.png | Foundation color of chunk part of the progress bar, and the renderer will lighten or darken according to this color to draw progress bar of gradual change effect |

flat渲染器

Flat Renderer

继承自mWidget的flat渲染器
| 属性名 |miniStudio属性名 | 类型 | 示意图 | 说明 | | NCS_FGC_WINDOW | ChunkColor | DWORD（ARGB） | flat_prog.png | 进度条的chunk部分的颜色,这里使用窗口前景色 |

It is inherited from flat renderer of mWidget
| Property name |miniStudio property name | Type | Schematic diagram | Explanation | | NCS_FGC_WINDOW | ChunkColor | DWORD（ARGB） | flat_prog.png | Color of chunk part of the progress bar, here window foreground color is used |

skin渲染器

Skin Renderer

参阅 Skin渲染器使用的图片资源规范(ProgressBar图片规范中[[MStudioMGNCSV1dot0PGAppB#m_ProgressBar)

Refer to [Appendix B](MStudioMGNCSV1dot0PGAppB#m_ProgressBar][ProgressBar Image Specification]] in Specification for Image Resource Used by Skin Renderer ([[MStudioMGNCSV1dot0PGAppB))

mProgressBar编程示例

Instance of mProgressBar

  • ProgressBar示例代码 ：progressbar.c

  • ProgressBar模板

  • ProgressBar Example code:progressbar.c

  • ProgressBar template

%INCLUDE{"%ATTACHURL%/progressbar.c.txt" pattern="^.*?//START_OF_TEMPLATE(.*?)//END_OF_TEMPLATE.*"}%

  • 初始化ProgressBar属性

  • Initialize the property of ProgressBar

%INCLUDE{"%ATTACHURL%/progressbar.c.txt" pattern="^.*?//START_OF_INITIAL_PROPS(.*?)//END_OF_INITIAL_PROPS.*"}%

  • 在Timer消息中，改变ProgressBar的属性值

  • In Timer message, change the property value of ProgressBar

%INCLUDE{"%ATTACHURL%/progressbar.c.txt" pattern="^.*?//START_OF_SET_PROPERTY(.*?)//END_OF_SET_PROPERTY.*"}%

[Next](MStudioMGNCSV1dot0PGP2C9][Previous]] < MStudioMGNCSV1dot0PG][Index > [[MStudioMGNCSV1dot0PGP2C11)

-- Main.XiaodongLi - 22 Feb 2010

<< | Table of Contents | >>