VincentWei/minigui-docs

Fork 0

mirror of https://github.com/VincentWei/minigui-docs.git synced 2025-10-23 10:08:11 +08:00

Files

Vincent Wei 8739619013 porting guides

2019-10-16 10:25:45 +08:00

17 KiB

Raw Blame History

旋钮类控件

Spinner Class Control

旋钮类控件简介

Brief Introduction of Spinner Class Controls

旋钮类控件通常由一组箭头按钮（上下或者左右），通常表示一个范围，通过箭头控制，可以一步一步的改变值。

mGNCS提供两种按钮，mSpinner和mSpinbox，他们的继承关系如下

mWidget
- mSpinner * mSpinbox

Spinner class control is usually composed of a group of arrow buttons (up and down, or left and right), which usually represent a range. Through arrow control, value can be changed step by step.

mGNCS provides two kinds of buttons, mSpinner and mSpinbox, and their inheritance relation is as follows

mWidget
- mSpinner * mSpinbox

mSpinner

控件名称: NCSCTRL_SPINNER
英文名: Spinner
简要介绍: 由两个箭头按钮（上下或者左右）组成的能够控制在一个范围内变化的值的控件
示意图:
Control name: NCSCTRL_SPINNER
English name: Spinner
Brief introduction: Control consisting of two arrow buttons (up and down or left and right) that can control values changing in a range
Schematic diagram:

mSpinner风格

Style of mSpinner

It is inherited from the style of mWidget |* Style ID | mStudio name *| * Explanation *| | NCSS_SPNR_VERTICAL | Direction->Vert| Vertical style, up and down arrows. When clicking up and down arrows, it will send keyboard information of the up and down direction keys to the objective window | | NCSS_SPNR_HORIZONTAL | Direction->Horz | Horizontal style, left and right arrows. When clicking the left and right arrows, it will send keyboard information of the left and right direction keys to the objective window | | NCSS_SPNR_AUTOLOOP | AutoLoop | When reaching the maximum or minimum value, it will automatically loop to the minimum or maximum value |

mSpinner属性

Property of mSpinner

继承自mWidget的属性

|* 属性ID | mStudio 名| 类型 | 权限 | 说明 *| | NCSP_SPNR_MAXPOS | MaxPos | int | RW | 变化范围的最大值 | | NCSP_SPNR_MINPOS | MinPos | int | RW | 变化范围的最小值 | | NCSP_SPNR_CURPOS | CurPos | int | RW | 当前值 | | NCSP_SPNR_LINESTEP | LineStep | int | RW | 步进步长 | | NCSP_SPNR_TARGET | - | HWND | RW | 目标窗口句柄 |

It is inherited from the property of mWidget

mSpinner事件

Event of mSpinner

继承自mWidget的事件

It is inherited from the event if mWidget

mSpinner方法

Method of mSpinner

继承自mWidget的方法

该类没有新增方法

It is inherited from the method of mWidget

The class does not have newly added method

mSpinner渲染器

Renderer of mSpinner

---++++ mSpinner classic渲染器 ---++++ mSpinner classic renderer

非客户区查看mWidget的classic渲染器

For the non client area, refer to classic renderer of mWidget

---++++ mSpinner Skin渲染器 ---++++ mSpinner Skin Renderer

参阅附录B : Skin 渲染器使用的图片资源规范

Refer to Appendix B : Specification for the Image Resource Used by Skin Renderer

---++++ mSpinner Fashion 渲染器 ---++++ mSpinner Fashion Renderer

---++++ mSpinner Flat 渲染器 ---++++ mSpinner Flat Renderer

mSpinner示例

Example of mSpinner

下面的示例（截图见mSpinner的示意图）演示了Spinner和一个Static控件关联。当Spinner的pos改变后，Static会响应的变化。

主要涉及的属性有
- NCSP_SPN_MAXPOS
- NCSP_SPN_MINPOS
- NCSP_SPN_CURPOS
主要涉及的事件:
- NCSN_SPN_CHANGED

The example below (for the screen shot, see the schematic diagram of mSpinner) demonstrates that Spinner is associated with a Static control. After pos of Spinner changes, Static will change correspondingly.

Properties mainly involved are
- NCSP_SPN_MAXPOS
- NCSP_SPN_MINPOS
- NCSP_SPN_CURPOS
Event mainly involved is:
- NCSN_SPN_CHANGED

为了方便我们主要数据绑定的方法来实现

示例 spinner.c
在窗口的模板定义文件中设置spinner的属性

For convenience, we mainly realize through the method of data binding

Example spinner.c
In the template definition file of the window, set properties of spinner

%CODE{cpp}% %INCLUDE{"%ATTACHURL%/spinner.c.txt" pattern="^.?//START_SET_PROPS(.?)//END_SET_PROPS.*"}%


- 在主窗口的MSG_CREATE消息中，建立和static的连接
   - 获取窗口对象

- In MSG_CREATE message of the main window, establish connection with static
   - Get window object

%CODE{cpp}%
%INCLUDE{"%ATTACHURL%/spinner.c.txt" pattern="^.*?//START_GET_CTRLS(.*?)//END_GET_CTRLS.*"}%

连接窗口属性
Property of the connection window %CODE{cpp}% %INCLUDE{"%ATTACHURL%/spinner.c.txt" pattern="^.?//START_CONNECT_PROPS(.?)//END_CONNECT_PROPS.*"}%

   - 更新当前的信息到Static中

   - Update the current information into Static
%CODE{cpp}%
%INCLUDE{"%ATTACHURL%/spinner.c.txt" pattern="^.*?//START_UPDATE_CTRLS(.*?)//END_UPDATE_CTRLS.*"}%

mSpinbox

控件窗口类名 : NCSCTRL_SPINBOX
控件英文名 : Spinbox
简要介绍 : 把箭头按钮和编辑框组合起来，通过箭头按钮控制编辑框内的内容
示意图 :
Control window class name : NCSCTRL_SPINBOX
Control English name : Spinbox
Brief introduction : Combine the arrow button with the edit box, and control the content in the edit box through arrow button
Schematic diagram :

mSpinbox风格

Style of mSpinbox

继承自mSpinner的风格

It is inherited from the style of mSpinner

mSpinbox属性

Property of mSpinbox

继承自mSpinner的属性

It is inherited from the property of mSpinner

mSpinbox事件

Event of mSpinbox

继承自mSpinner的事件

It is inherited from the event of mSpinner

mSpinbox方法

Method of mSpinbox

继承自 mSpinner的方法

It is inherited from the method of mSpinner

以下的函数只有在spinbox包含NCSS_SPNBOX_STRING风格时有效

addItem 增加一个新的项

The functions below are only valid when spinbox contains NCSS_SPNBOX_STRING style

addItem adds a new item %CODE{cpp}% BOOL (*addItem)(clsName *self, char *item);

   - 增加一个字符串到spinbox中
   - 参数：
         *  item : 添加的字符串
   - 返回值： 成功 - TRUE; 失败 - FALSE;

   - Add a character string into spinbox
   - Parameter:
         *  item : added character string
   - Returned value: successful- TRUE; failed- FALSE;

- remove Item
%CODE{cpp}%
BOOL (*removeItem)(clsName *self, int index);

删除一个item
参数： * index 要删除item的索引
返回值：成功 - TRUE; 失败 - FALSE;
Remove an item
Parameter: * index: the index of removing item 要删除item的索引
Returned: successful- TRUE; failed- FALSE;
setItem %CODE{cpp}% BOOL (*setItem)(clsName *self, int index, char *item);

   - 设置一个item的字符串内容
   - 参数：
         * index 要设置的索引
         * item   新的item内容
   - 返回值：成功 - TRUE; 失败 - FALSE;

   - Set character string content of an item
   - Parameter:
         * index Index to set
         * Item content of new item
   - Returned value: successful- TRUE; failed- FALSE;

- getItem
%CODE{cpp}%
char* (*getItem)(clsName *self, int index);

获取item的字符串内容
参数： * index item的索引
返回值：NULL - 失败；有效的字符串指针
Get character string content of item
Parameter * index of the index item
Returned value: NULL- failed; valid character string pointer.

mSpinbox渲染器

Renderer of mSpinbox

mSpinbox渲染的效果由mSpinner和mSlEdit的效果组成，该类本身没有新增的属性

Effect of mSpinbox render is composed of the effects of mSpinner andmSlEdit, and the class itself does not have newly added properties

mSpinbox示例

Example of mSpinbox

该示例分别说明了水平风格下和垂直风格下，数字型和列表型两种形态下的spinbox。

示意图：

The example explains spinbox under numeric type and list type under horizontal style and vertical style.

Schematic diagram:

源代码spinbox.c
主要代码如下:
Source Codespinbox.c
The main codes are as below: %CODE{cpp}% %INCLUDE{"%ATTACHURL%/spinbox.c.txt" pattern="^.?//START_SPINBOX(.?)//END_SPINBOX.*"}%


[Next](MStudioMGNCSV1dot0PGP2C8][Previous]] < [[MStudioMGNCSV1dot0PG][Index]] > [[MStudioMGNCSV1dot0PGP2C10)




-- Main.XiaodongLi - 22 Feb 2010

17 KiB Raw Blame History Unescape Escape

旋钮类控件

Spinner Class Control

旋钮类控件简介

Brief Introduction of Spinner Class Controls

mSpinner

mSpinner

mSpinner风格

Style of mSpinner

mSpinner属性

Property of mSpinner

mSpinner事件

Event of mSpinner

mSpinner方法

Method of mSpinner

mSpinner渲染器

Renderer of mSpinner

mSpinner示例

Example of mSpinner

mSpinbox

mSpinbox

mSpinbox风格

Style of mSpinbox

mSpinbox属性

Property of mSpinbox

mSpinbox事件

Event of mSpinbox

mSpinbox方法

Method of mSpinbox

mSpinbox渲染器

Renderer of mSpinbox

mSpinbox示例

Example of mSpinbox

17 KiB

Raw Blame History