VincentWei/minigui-docs

Fork 0

mirror of https://github.com/VincentWei/minigui-docs.git synced 2025-10-19 20:13:25 +08:00

Files

Vincent Wei 355eda49fd fix bad format manually

2019-10-28 17:18:32 +08:00

19 KiB

Raw Blame History

旋钮类控件

Spinner Class Control

旋钮类控件简介

Brief Introduction of Spinner Class Controls

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

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

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

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 | miniStudio 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 | miniStudio 名| 类型 | 权限 | 说明 *| | 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](MStudioMGNCSV1dot0PGP2C3#mWidget)

`mSpinner方法`

Method of `mSpinner`

继承自mWidget的方法

该类没有新增方法

It is inherited from [the method of mWidget](MStudioMGNCSV1dot0PGP2C3#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](MStudioMGNCSV1dot0PGP2C3#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

%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

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

连接窗口属性
Property of the connection window

%INCLUDE{"%ATTACHURL%/spinner.c.txt" pattern="^.*?//START_CONNECT_PROPS(.*?)//END_CONNECT_PROPS.*"}%

更新当前的信息到Static中
Update the current information into Static

%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 thestyle ofmSpinner</a`>

`mSpinbox属性`

Property of `mSpinbox`

继承自mSpinner的属性

It is inherited from the property of mSpinner</a>

`mSpinbox事件`

Event of `mSpinbox`

继承自 mSpinner的事件

It is inherited from theevent ofmSpinner</a`>

`mSpinbox方法`

Method of `mSpinbox`

继承自 mSpinner的方法</a>

It is inherited from the method of mSpinner</a>

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

addItem 增加一个新的项

The functions below are only valid when spinbox contains NCSS_SPNBOX_STRING style

addItem adds a new item

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

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

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

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渲染的效果由<a href="#mSpinner%E6%B8%B2%E6%9F%93%E5%99%A8">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:

%INCLUDE{"%ATTACHURL%/spinbox.c.txt" pattern="^.*?//START_SPINBOX(.*?)//END_SPINBOX.*"}%

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

-- Main.XiaodongLi - 22 Feb 2010

<< | Table of Contents | >>

19 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 classic渲染器

mSpinner classic renderer

mSpinner Skin渲染器

mSpinner Skin Renderer

mSpinner Fashion 渲染器

mSpinner Fashion Renderer

mSpinner Flat 渲染器

mSpinner Flat Renderer

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

19 KiB

Raw Blame History

`mSpinner`

`mSpinner`

`mSpinner风格`

Style of `mSpinner`

`mSpinner属性`

Property of `mSpinner`

`mSpinner事件`

Event of `mSpinner`

`mSpinner方法`

Method of `mSpinner`

`mSpinner渲染器`

Renderer of `mSpinner`

`mSpinner` classic渲染器

`mSpinner` classic renderer

`mSpinner` Skin渲染器

`mSpinner` Skin Renderer

`mSpinner` Fashion 渲染器

`mSpinner` Fashion Renderer

`mSpinner` Flat 渲染器

`mSpinner` Flat Renderer

`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`