第二部分第十三章动画控件类

Chapter 13 of Part 2 Animation Control Class

---++动画控件简介 ---++Brief Introduction of Animation Control 动画控件通过对图片组和gif动态图片的绘制和显示，为用户提供了丰富的视觉体验。 mGNCS中的动画控件源于Minigui 3.0的animation控件，在其基础上增加了对图片组播放和gif图片播放控制的支持。同时，用户可以通过设置图片播放间隔时间，来控制播放速度。

Animation control provides rich visual experience to the users through drawing and displaying image group and gif dynamic images. Animation control in mGNCS is derived from animation control of minigui 3.0, and based on it, support to image group play and gif image play control is added. At the same time, users can control the play speed through setting image play interval.

Animate类层次关系
- mStatic * mAnimate
控件创建方法
- 自动创建：通过mStudio中的界面设计器，拖拽对应的动画控件，在属性栏中选择需要加载的GIF图片或图片目录，mStudio将自动创建控件，并提供可视化的控件配置，同时自动生成创建代码。
- 手动生成：按照mGNCS控件创建过程，通过编程，传入对应控件窗口类ID，生成控件，手动编程设置控件属性、事件处理。
Animate class hierarchical relation
- mStatic * mAnimate
Control creating method
- Automatic creation: through interface designer in mStudio, drag corresponding animation control, select GIF image or image directory that need to load in the property column, and mStudio will automatically create control and provides visual control configuration, at the same time, creation codes are generated automatically.
- Manual generation: according to mGNCS control creating process, through programming, corresponding control window class ID is imported, and control is generated. Manual programming sets control property and event handling.

---++mAnimate

控件窗口类: NCSCTRL_ANIMATE
控件英文名: Animate
简介: 动画控件。通过在控件上加载不同的图片处理对象，来显示绘制动态图片。
示意图:
Control window class: NCSCTRL_ANIMATE
Control English name: Animate
Brief introduction: Animation control. Display drawn dynamic images through loading different image processing objects on the control.
Schematic diagram:

---+++mAnimate风格 ---+++Style of mAnimate 继承自mStatic的风格

It is inherited from the style of mStatic

| Style name | mstudio property name | Explanation | | NCSS_ANMT_AUTOLOOP | Loop | Set animation play as automatic circle or not. When setting as True, the images are played in circle. When setting as False, it will stop after the images are all played. | | NCSS_ANMT_SCALE | Scale->ImageScaled | Set the image play area as control region area, and the images can be played enlarged or reduced | | NCSS_ANMT_AUTOFIT | Scale->AutoFit | Set the control region automatic matched as image area | | NCSS_ANMT_AUTOPLAY | Autoplay | Set images as automatic play or not. When it is True, the images are played automatically. When it is False, it is necessary for the users to send order to control the play |

---+++mAnimate属性 ---+++Property of mAnimate 继承自mStatic的属性

It is inherited from the property of mStatic

---+++mAnimate事件 ---+++Event of mAnimate

继承自mStatic的事件

It is inherited from the event of mStatic

---+++mAnimate渲染器 ---+++Renderer of mAnimate

非客户区的绘制请查阅mStatic的渲染器

For the drawing of non client area, please refer to the renderer of mStatic

---+++mAnimate方法 ---+++Method of mAnimate

---++++ncsAnimateStart %CODE{cpp}% BOOL ncsAnimateStart(mAnimate* self);

- 参数：<BR>
   - self -- 需要操作的动画控件指针
- 说明： <BR>
   开始播放self对应的动画控件， 如果动画控件已经在播放， 则回到动画起始处开始播放。
- 示例：<BR>

- Parameter: <BR>
   - self --  animation control pointer that needs operation
- Explanation: <BR>
   Start to play the animation control that self corresponds to. If the animation control is being played, then return to the animation starting point to begin playing.
- Example: <BR>
%CODE{cpp}%
//播放anim动画

// Play anim animation
    mAnimate *anim = (mAnimate *)ncsGetChildObj(hwnd, IDC_ANI);
    ncsAnimateStart(anim);

---++++ncsAnimatePauseResume %CODE{cpp}% BOOL ncsAnimatePauseResume(mAnimate* self);

- 参数：<BR>
   - self -- 需要操作的动画控件指针
- 说明： <BR>
   如果当前动画为暂停，此方法会继续播放动画， 如果动画为播放中， 此方法会暂停动画。
- 示例：<BR>

- Parameter: <BR>
   - self --  animation control pointer that needs operation
- Explanation: <BR>
   If the current animation is paused, this method will continue to play the animation. If the animation is in play, this method will pause to the animation.
- Example: <BR>
%CODE{cpp}%
//暂停anim动画

// Pause anim animation
    mAnimate *anim = (mAnimate *)ncsGetChildObj(hwnd, IDC_ANI);
    ncsAnimateStart(anim);
    ncsAnimatePauseResume(anim);

---++++ncsAnimateStop %CODE{cpp}% BOOL ncsAnimateStop(mAnimate* self);

- 参数：<BR>
   - self -- 需要操作的动画控件指针
- 说明： <BR>
   停止动画， 并将动画重置回第一帧。
- 示例：<BR>

- Parameter: <BR>
   - self --  animation control pointer that needs operation
- Explanation: <BR>
   Stop the animation, and reset the animation back to the first frame.
- Example: <BR>
%CODE{cpp}%
//暂停anim动画

// Pause anim animation
    mAnimate *anim = (mAnimate *)ncsGetChildObj(hwnd, IDC_ANI);
    ncsAnimateStop(anim);

---+++mAnimate编程示例 ---+++Programming Example of mAnimate

运行截图:
Operation screen shot:
本程序窗口区域上边的图片为gif动态图片，下面是对程序所在目录中图片的幻灯片播放，三个按钮start, pause, stop是对gif播放的控制。
普通按钮完整示例代码：animation.c
Images on the top of the window region of this program are gif dynamic images, and on the bottom, it is the slide play of the images in the directory of the program. The three buttons start, pause and stop are control of gif play.
Common button complete example code:animation.c

清单 p2c13-1 animation.c

List p2c13-1 animation.c

设置加载图片
Set loading image

%INCLUDE{"%ATTACHURL%/animation" pattern="^.*?//START_OF_PIC(.*?)//END_OF_PIC.*"}%

设置按键消息
Set key information

%INCLUDE{"%ATTACHURL%/animation" pattern="^.*?//START_OF_KEY_EVENT(.*?)//END_OF_KEY_EVENT.*"}%

设置显示界面模板
Set display interface template

%INCLUDE{"%ATTACHURL%/animation" pattern="^.*?//START_OF_TMPL(.*?)//END_OF_TMPL.*"}%

[Next](MStudioMGNCSV1dot0PGP2C12][Previous]] < MStudioMGNCSV1dot0PG][Index > [[MStudioMGNCSV1dot0PGP2C14)

-- Main.XiaodongLi - 22 Feb 2010

9.1 KiB Raw Blame History Unescape Escape

第二部分第十三章 动画控件类

Chapter 13 of Part 2 Animation Control Class

9.1 KiB

Raw Blame History

第二部分第十三章动画控件类