菜单

面板类控件

下载

前言

下面将讲解面板，贴磁等控件的一些常用接口

面板

接口展示

c++ 复制代码 
/**
 * @LEVEL2
 * @brief 设置基本参数
 * @param x,y,w,h 	位置、大小
 * @param type		控件类型 0:面板  1:图片  2:页面
 */
void setMainArg(int x, int y, int w, int h, int type=2);
/**
 * @LEVEL2
 * @brief 设置基本样式
 * @param r			圆角半径
 * @param c1		背景主色(渐变时为起始色)
 * @param c2		背景渐变时的终止色
 * @param dir		渐变类型 0~不渐变 1~上下 2~左右
 * @param opa		不透明度0~255
 * @param w_border	边框线粗
 * @param c_border	边框线色
 * @param img		背景图
 */
void setMainStyle(int r=0, int c1=0xffffff, int c2=0xffffff, int dir=0, int opa=0, int w_border=0, int c_border=0xdddddd, const string& img="");
/**
 * @LEVEL1
 * @brief 设置背景图片。可设置GIF(仅STTPage控件可设置GIF)
 */
STTWidget* setBgImg(const string& path, int part = Part::Main);
/**
 * @HideCA
 * @brief 设置尺寸(由于此控件可能有图片，需要在resize前，将图片清空。resize后，再将图片设置回来)
 */
STTWidget* setSize(int w, int h);

使用方法

c++ 复制代码 
wMPanel1->setSize(640,480);

模式

面板有三种模式，在组态界面如下显示

下面将说明面板与页面模式

面板

面板模式为默认模式，用户可以控件放置于面板上，对控件进行排列规划，不做过多讲解。如果面板超过页面大小，会出现页面可拖拽的现象。

页面

当面板设置为页面模式，该面板可以作为嵌入页使用。作为被嵌入的页面，页面宽度应该设置与面板相同的宽度。如果被嵌入的页面宽高大于面板的宽高，会出现页面可拖拽的现象。

贴磁

通过贴磁控件，可以实现单页面上控件切换，滑动的效果。默认出厂工程使用的就是该控件。

设置不同的贴磁页

将贴磁拖入页面后，右键控件，设置位置

也可以通过右方属性，设置位置

在属性中，可以关联变量来形成切换页面的效果

接口展示

c++ 复制代码 
/**
 * @LEVEL2
 * @brief 获取tile控件
 * @return tile控件
 */
STTTile* getTile(int8_t index);
/**
 * @LEVEL2
 * @brief 设置当前tile序号
 * @param index	序号
 * @param an	启用动画
 */
void setTileIndex(int8_t index, bool an);
/**
 * @LEVEL2
 * @brief 获取当前tile序号
 * @return 当前tile序号
 */
int8_t getTileIndex();
/**
 * @LEVEL2
 * @brief 获取当前tile控件
 * @return 当前tile控件
 */
STTTile* getActTile();

使用方法

c++ 复制代码 
wMTileView1->setTileIndex(0,false);
上一个
按钮类控件
下一个
工程案例讲解
最近修改: 2025-04-08Powered by