aardio 文档

aardio 图形界面 - plus 控件使用指南

强烈推荐先仔细阅读:《Z 序:原理与优化》
里面也讲解了 plus 控件的优化技术。Z 序与很多问题都有关系,一定要仔细看。

plus 控件简介

plus 控件可支持各种字体图标, jpg 图像,透明 gif 图像,透明动画,半透明 png 图像,并可设定多种不同的绘图模式、九宫格贴图等等,使用 plus 控件可以简单地通过在窗体设计器中拖拉创建各种漂亮的控件效果、可创建静态图片框、动画播放控件、按钮、透明按钮、不规则按钮、复选框、超链接、组合框、进度条、扇形进度条、滑块跟踪条、选项卡、弹出菜单、下拉框...... plus 控件还提供了非常多的灵活的可调整参数,如果您擅于发挥可以做出更多的控件效果。

aardio 的窗体背景图也支持九宫格,缓存绘图等功能。另外 aardio 还提供 bk,bkplus 等纯背景贴图控件( 无句柄控件 )。使用这些背景贴图功能,再加上 plus 控件,可以轻松拖放出好看的界面。

plus 控件的基本用法

使用 plus 控件的基本步骤:

  1. 首先拖一个 plus 控件到界面上,选中 plus 控件。

  2. 鼠标双击并打开"aardio 工具 » 界面 » plus 控件配色工具"。

  3. 配置好颜色样式,或者点击预设的范例样式,然后点击 「导出到窗体设计器选中控件」 就可以了。

创建 plus 控件 #

plus 控件主要由五个部分组成:

  1. 背景:在创建 plus 控件以后可通过 background 属性设置图像或颜色。在创建控件的参数表内可用 background 字段指定图像,可用 bgcolor 字段指定初始背景色。
  2. 前景:通过 foreground 属性设置图像或颜色( 0xAARRGGBB 格式 )。在创建控件的参数表内可用 foreground 字段指定图像,可用 forecolor 字段指定初始前景色。
  3. 文本:通过 text 属性设置文本,color 属性设置文本颜色,font 属性设置字体,align 属性设置水平对齐,valign 设置垂直对齐。
  4. 图标文本: 通过 iconText 属性设置图标,iconColor 属性设置颜色,iconStyle 设置样式( font 字段设置图标字体,align 与 valign 字段设置对齐。
  5. 边框: 通过 border 属性设置。

plus 控件的边距设置:

🅰 示例:

import fonts.fontAwesome;
import win.ui;
/*DSG{{*/
var winform = win.form(text="aardio form";right=759;bottom=469)
winform.add(
plus={
    cls="plus";//不能省略
    left=228;top=263;right=390;bottom=295;//不能省略

    //文本相关,所有字段可选
    db=1;dl=1;dr=1;//固定边距
    text="标题文本";
    color=0x3C3C3C; //文本颜色
    font=LOGFONT(h=-13); //字体
    textPadding={left=1;top=1;right=1;bottom=1}; //文本边距
    align="center"; //居中是默认值,可以省略
    valign="center"; //居中是默认值,可以省略

    //图标相关,所有字段可选
    iconText='\uF0AD';//图标文本
    iconStyle={//图标字体样式
        font=LOGFONT(h=-13;name='FontAwesome');//图标字体
        align="center"; //居中是默认值,可以省略
        valign="center"; //居中是默认值,可以省略
        padding={left=8;right=86} //图标文本边距
    }; 

    //边框,所有字段可选
    border={ 
        radius=8; //圆角
        color=0xFFC0C0C0;//边框颜色
        //可以单独设置各边大小,不指定则为 0 ,四边一样可以简写为 width=1;
        left=1;top=1;right=1;bottom=1; 
    };

    //前景边距,所有字段可选。
    paddingBottom=1;paddingLeft=1;paddingRight=1;paddingTop=1;
    z=1
};

)
/*}}*/

//设置交互样式
winform.plus.skin({
    color={
        active=0xFF00FF00;
        default=0xFF3C3C3C;
        disabled=0xFF6D6D6D;
        hover=0xFFFF0000        
    }
});

winform.show();
win.loopMessage();

注意 plus 控件的 align, valign 属性的默认值都是 "center",plus 控件的 text 与 iconText 在各自的显示区域内独立计算文本对齐。如果 plus 控件设置了同时显示 text 与 iconText , 并且 text 与 iconText 显示区域相同而且在水平与垂直方向都居中,就会导致 text 与 iconText 重叠遮挡。有两种方案可以避免这个问题:

  1. text 与 iconText 都居中,设置图标文本某一侧的边距为略大于 text 的显示宽度或高度,使 iconText 偏向一侧。例如在上面的示例中 iconStyle.padding.right 设为 86,这刚好比 text 的显示宽度略大一些,效果就是 iconText 与 text 都实现了居中显示并且 iconText 刚好出现在 text 的前面。
  2. text 与 iconText 都向同一侧对齐,然后依次设置这一侧的"文本边距"以及"图标文本边距",使之一前一后显示。

使用图标字体 #

注意 plus 控件可以指定两个文本属性,一个是普通「文本」属性,一个是「图标文本」属性。

如果「图标文本」为空,则「图标字体」属性被忽略。普通文本的「字体」属性也可以指定为图标字体,但如果普通文本的「字体」属性用适合文本的 Tahoma 字体,而「图标文本」使用 FontAwesome 等图标字体效果会更好一些。

为 plus 控件指定图标字体是非常简单的:

  1. 选中 plus 控件。
  2. 点击『 aardio 工具 » 界面 » 字体图标 』,选中需要的字体图标,然后点击字体图标就可以了。

示例代码:

import win.ui;
import fonts.fontAwesome;
/*DSG{{*/
var winform = win.form(text="FontAwesome 图标字体演示";right=455;bottom=286)
winform.add(
plus={cls="plus";text='\uF1f7'/*_FA_BELL_SLASH_O*/;left=64;top=75;right=109;bottom=117;color=32768;font=LOGFONT(name='FontAwesome';h=-35);transparent=1;z=1};
plus2={cls="plus";text='\uF25a'/*_FA_HAND_POINTER_O*/;left=154;top=77;right=199;bottom=119;color=32768;font=LOGFONT(name='FontAwesome';h=-35);transparent=1;z=2};
plus3={cls="plus";text= '\uF1d6 点这里联系我们'/*_FA_QQ*/;left=248;top=76;right=420;bottom=118;color=32768;font=LOGFONT(name='FontAwesome';h=-16);transparent=1;z=3}
)
/*}}*/

var hyperlink = {
     color = {
        hover = 0xFFFF0000; //鼠标移上去的颜色
        active = 0xFF00FF00; //鼠标按下去的颜色
    }
}
winform.plus.skin(hyperlink);
winform.plus2.skin(hyperlink);
winform.plus3.skin(hyperlink);

winform.show();
win.loopMessage();

工具会自动添加代码 import fonts.fontAwesome 以导入 FontAwesome 字体。

设置背景图像、前景图像 #

  1. 首先,请新建一个窗体。
  2. 然后在开发环境左下侧『界面控件』面板点选 plus 控件(高级图像控件),并在窗体上拖拽画出控件。
  3. 在窗体上点选添加上去的 plus 控件,然后在右侧属性面板中修改"前景图像"、"背景图像"等属性。等价于在代码中设置控件的 background 属性以显示背景图像,设置控件的 foreground 属性以显示前景图像。plus 控件支持 jpg ,gif 动画,透明动画,png 半透明图像。可以同时设置背景图、前景图在运行时合成新的图像。如果图像是一个 GIF 动画则会自动播放。

注意 plus 控件使用的图像一定要包含在工程目录下(并且目录的"内嵌资源"属性应设为 true ), picturebox 添加图像时默认为会在路径前添加包含操作符$通过内存载入图像,图像不需要添加到工程管理器中。
而 plus 控件默认不会这么做,应当将图像添加到工程中(可以放在资源目录下,在工程管理器右键菜单中简单的点击【同步本地目录】),如果你指定一个文件名(可以指定资源文件名)而不是内存数据(),plus 控件将可以更好的缓存优化图像。

控件属性中的背景模式( repeat 属性 )、前景模式( foreRepeat 属性 )可以设置图像的显示模式,可选项如下:

  1. expand: 九宫格拉伸模式,按你设定的上、右、下、左四个切图位置(表示边距的数据)把图像划四条线切分为九个方块,位于四个角的图像方块保持原来的大小显示在屏幕上,而其他位于中间的图像块则拉伸显示。

    固定 自动拉伸 固定
    拉伸 自动拉伸 拉伸
    固定 自动拉伸 固定

    如果指定 expand 模式,则可以通过控件属性「背景切图」、「前景切图」指定九宫格切图位置。我们可以在开发环境的窗体设计器点选控件,然后在控件的属性面板鼠标点选"背景切图"、"前景切图"属性的上、右、下、左四个数值,然后**滚动鼠标滚轮**快速调整切图位置。在"窗体设计器"中,会实时使用不同颜色的线条标明背景、前景的九宫格切图位置。

    对于背景图像,在代码中使用控件的 bkTop,bkRight,bkBottom,bkLeft 属性指定切图坐标。 对于前景图像,在代码中使用控件的 forekTop,foreRight,foreBottom,foreLeft 属性指定切图坐标。 每一个切图坐标属性都是可选的,不指定则默认为 0 。

  2. stretch:普通拉伸模式,控件多大图像就缩放到适应的大小显示。

  3. center: 绝对居中模式,图像保持原始大小,图像的中心对准控件的中心,如果图像比控件大则只会显示能显示的部分,超出控件的被剪切掉不显示。

  4. scale:保持图像原来的比例不变、并缩放到适应控件的大小

  5. tile:图像保持原来的大小并横向、纵向重复平铺显示

  6. repeat-x:仅横向重复平铺显示,这种模式下切图坐标会转换为画板边距(指定下边距则忽略上边距)。

  7. repeat-y:仅纵向重复平铺显示,这种模式下切图坐标会转换为画板边距(指定右边距则忽略左边距)。

  8. point: 仅适用于前景图。point 模式按 x,y 指定的控件客户区坐标显示前景图(忽略 "前景边距"),x,y 如果为小数则按百分比划分图像与控件间的剩余空间(忽略 "前景边距")。如果为负数则表示相对控件右下角的坐标。

我们还可以设置控件的"前景边距"以指定前景图像与文本的显示外边距,"前景边距"不会改变背景图像的边距。

expand 模式是最常用的一种图像显示模式,自适应系统 DPI 缩放的效果较好。

设置 plus 控件的颜色属性 #

在窗体设计器的控件属性或者创建控件的初始化参数里可以为 plus 控件指定以下「设计时属性」:

「设计时属性」指的是在创建控件以前指定的初始化属性( 在由 /*DSG{{*/ .../*}}*/ 包围的代码内指定设计时属性 ),在「设计时属性」 里只能指定 GDI 的 COLORREF(0xBBGGRR,不支持透明度) 格式颜色值。这是因为只有 plus 控件是基于 GDI+,而其他控件与 IDE 提供的窗体设计器则基于 GDI 接口。

创建控件以后可以使用的属性称为「运行时属性」,plus 控件可以使用以下「运行时属性」指定配色:

8888 ARGB 格式指的是 GDI+ 接口使用的 0xAARRGGBB 格式颜色值,其中 AA 指的是 Alpha 分量(不透明度)。

在 plus 控件 skin 方法的参数表内部所有颜色值都必须是 0xAARRGGBB 格式。

请参考:创建窗口控件

设置 plus 控件交互样式 #

在窗体设计器中添加一 个 plus 控件,然后设置好「背景颜色/背景图像」或「前景图像/前景颜色」等参数。

然后双击该控件添加代码如下:


/*
设定 plus 控件不同属性在不同状态下的外观样式。
下面指定了 plus 控件的 background 属性在不同状态下显示的不同的背景图像(或背景颜色)。
同样也可以使用 foreground 属性指定不同状态下的前景图像(或前景颜色),或者使用 color 属性指定不同状态下的字体颜色。  
*/
winform.plus.skin(

    background = { //指定控件在不同状态下的背景样式
        hover = "/res/btn-hover.png";//鼠标移到控件上的图像,也可以指定颜色数值。
        focus = "/res/btn-focus.png";//控件得到焦点的图像,也可以指定颜色数值。
        active = "/res/btn-active.png";//鼠标按下时的图像,也可以指定颜色数值。
        disabled = "/res/btn-disabled.png"; //控件禁用的图像,也可以指定颜色数值。
    }
)

// 点击按钮时触发下面的事件
winform.plus.oncommand = function(id,event){

}

实际上现代软件界面使用图像已经不多见了,更流行的是使用字体图标与配色实现轻快简洁的效果。使用「」aardio 工具 » 界面 » plus 配色工具」以及 aardio 提供的「aardio 工具 » 界面 » 字体图标工具」 制作这样的现代化界面将会非常方便。我们可以在「窗体设计器」上点选 plus 控件,然后在 "plus 配色工具" 里就可以设置选定控件的样式并自动生成 winform.plus.skin 函数的调用代码。

plus 控件的 skin 成员即可以作为方法使用,也可以作为属性使用,也就是说 winform.plus.skin(styleTable) 等价于 winform.plus.skin = styleTable

winform.plus.skin 函数:

  1. 函数原型

    winform.plus.skin(styleTable,clone)

  2. 参数说明:

    参数 @styleTable 必须是一个指定控件不同状态显示样式的表对象。
    可选参数 @clone 用于指定是复调用 table.clone 函数先复制参数 @styleTable,默认值为 false 。

    参数 @styleTable 可选指定以下「样式字段」:

    参数 @styleTable 还可以用一个特殊的字段 checked 指定件在选中状态下的样式,checked 字段同样支持以上所有「样式字段」,这个功能通常用来实现单选控件或者复选控件的效果。

    iconText,iconStyle可直接指定样式,其他 「样式字段」则需要在以下表示不同交互状态字段内指定样式(每个状态字段都是可选的):

    如果参数 @styleTable 指定为另一个 plus 控件,则先获取该控件的样式配置作为参数,也就是说 winform.plus2.skin(winform.plus1) 等价于 winform.plus2.skin = winform.plus1.skin

用 plus 控件实现超链接 #

创建超链接很简单,在设计器中双击 plus 控件,修改 skin 函数调用代码如下:

 winform.plus.skin(  
     color = {
         hover = 0xFFFF0000; //鼠标移上去的颜色  
         active = 0xFF00FF00; //鼠标按下去的颜色  
     }  
 )

plus 控件使用 GDI+ 绘图,所以使用的颜色格式也是 GDI+ 颜色格式 0xAARRGGBB。其中A为透明度,R为红色分量,G为绿色分量,B为蓝色分量。

下面是一个完整的示例:

import win.ui;
/*DSG{{*/
var winform = win.form(text="用 plus 控件创建超链接";right=492;bottom=254;bgcolor=4448391;max=false)
winform.add(
plus={cls="plus";text="http://www.aardio.com";left=46;top=85;right=429;bottom=130;color=15793151;font=LOGFONT(h=-24);notify=1;z=2};
progress={cls="plus";left=119;top=107;right=377;bottom=131;align="left";background="~\res\progress-bg.jpg";color=16777215;foreRepeat="expand";foreground="~\res\progress.jpg";z=1}
)
/*}}*/

winform.plus.skin(
    //颜色样式
    color = { 
        hover = 0xFFFF0000; //鼠标移上去的颜色
        active = 0xFF00FF00; //鼠标按下去的颜色
    }
)

//鼠标点击超链接触发下面的函数
winform.plus.onMouseClick = function(){
    //打开网页
    raw.execute("http://www.aardio.com");
}

winform.show();
win.loopMessage(); 

plus 控件默认使用透明背景,也可以如下指定不同状态下的背景色:

winform.plus.skin(  
    background = {  
        active = 0xFF004444;  
        hover = 0xFFCCCC00;  
    }  
)  

注意 background 的样式可以指定图像路径,也可以直接指定 0xAARRGGBB 格式的颜色代码。

用 plus 控件实现进度条 #

在窗体上拖放一个 plus 控件。 然后切换窗体设计器到 "代码模式",添加一句代码 winform.plus.setProgressRange(1,100) 指定进度条的最小值、最大值就可以自动切换到进度条模式了。

进度条可以是横向的(宽度大于高度),也可以是竖向的(高度大于宽度),plus 控件会根据设计时的宽高比自动判断进度条的方向,不需要设置其他参数。

如果未配置进度条的颜色或图像,plus 控件会在预设的配色方案中随机选择并配置背景色与前景色。 进度条默认以背景色、前景色区分进度。

我们也可以在窗体设计器的「属性面板」自行配置背景色或前景色,也可以指定背景图像或前景图像,进度条如果使用图像则必须指定为"expand"模式(九宫格贴图模式 )。

进度条也可以显示文本,文本的限制范围被限制在前景显示范围内,文本的显示区域外边距为前景边框 + 文本边距。

示例:

import win.ui;
/*DSG{{*/
var winform = win.form(text="plus控件 - 进度条")
winform.add(
plus={cls="plus";left=161;top=282;right=707;bottom=316;bgcolor=6447459;forecolor=9959653;notify=1;z=1}
)
/*}}*/

//设置进度区间,可自动切换到进度条显示模式
winform.plus.setProgressRange(1,50);//控件的 mode 属性自动设为 "progress"

//使用 progressPos 属性获取或修改当前进度值
winform.plus.progressPos = 20;

winform.show() 
win.loopMessage();

用 plus 控件实现扇形进度条 #

如果使用 winform.plus.setPieRange(1,100); 设定进度条的进度范围就可以创建圆形的进度条。
进度条以前景与背景区分进度,如果调用此函数时尚未指定前景与前景则会自预设配色方案中随机选择配色。

如果配置扇形进度条前景图、背景图,则图像的显示模式应当设置为 "center" ( 即绝对居中 )。

示例:

import win.ui;
/*DSG{{*/
var winform = win.form(text="扇形进度条";right=759;bottom=469)
winform.add(
plus={cls="plus";left=390;top=108;right=643;bottom=361;notify=1;z=1}
)
/*}}*/

//切换为扇形进度条
winform.plus.setPieRange(1,360) //控件的 mode 属性自动设为 "pie"

//前景色
winform.plus.foreground = 0x80ffff00;

//背景色
winform.plus.background = 0x60ff00ff;

//进度动画
winform.setInterval( 
    function(){
        //改变进度条的进度
        winform.plus.progressPos = winform.plus.progressPos+1
    },10 
)

winform.show() 
win.loopMessage();

用 plus 控件实现滑尺控件 #

如果我们想让 trackbar 变得更漂亮一些,用系统 trackbar 就比较为难了。我们可以用 aardio 中最强大的控件 —— plus 控件来绘制 trackbar 控件。

方法很简单,先拖一个 plus 控件到窗体界面上,切找到代码模式添加代码 winform.plus.setTrackbarRange(1,100) 设置好进度范围就可以自动切换到滑尺显示模式。

调用 winform.plus.setTrackbarRange 会检查滑道滑块的大小与配色设置,如果未指定则会自动指定默认值,并在预设的配色方案中随机选择配色。

如果要进一步自定义外观与交互样式,可以打开「 aardio 工具 » 界面 » 滑尺配色工具」 ,在 "滑尺配色工具" 里配置好外观与样式,然后「导出到窗体设计器选中控件」就行了。

滑尺可以是横向的(宽度大于高度),也可以是竖向的(高度大于宽度),plus 控件会根据设计时的宽高比自动判断滑尺的方向,不需要设置其他参数。与此类似,当 plus 控件作为普通进度条使用时也自动支持横向、竖向进度条(同样根据设计时的宽高比自动判断)。

以水平滑尺为例,使用前景切图参数 foreRight 可以设置滑块大小(默认为 15 ),使用前景边距参数 paddingTop,paddingBottom 设置滑道外边距大小(默认为 5 )。指定滑道边距是为了让滑块显示得比滑道大一些。如果同时用 border={radius=-1} 设置了圆形边框则滑块会显示为圆形。

滑尺默认以背景色与前景色区分滑道当前进度,滑块颜色为控件的字体颜色。

如果需要用图像制作滑尺,背景图、前景图都必须使用"expand"模式( 九宫格模式 )。以水平滑尺为例,前景图的九宫格切图参数需要指定右侧切图的宽度(也就是 foreRight )作为滑块按钮的宽度。注意在九宫格切图模式下,foreRight 限定的部分是固定大小的,其余部分自动拉伸,对于滑尺来说就是指滑块按钮图像固定大小不变,而滑道图像则自动拉伸。

在滑尺内显示文本不太好,可以在边上再放一个控件显示进度

更多内容请参考教程《trackbar 控件高级玩法》

示例:

import win.ui;
/*DSG{{*/
var winform = win.form(text="用 plus 控件创建滑尺控件")
winform.add(
lbTrackbar={cls="static";text="1";left=77;top=213;right=116;bottom=235;align="right";transparent=1;z=2};
trackbar={cls="plus";left=133;top=214;right=575;bottom=229;bgcolor=14265123;border={radius=-1};foreRight=15;forecolor=1865727;paddingBottom=5;paddingTop=5;z=1}
)
/*}}*/

//设置滑尺范围,切换到滑尺模式
winform.trackbar.setTrackbarRange(1,100); //控件的 mode 属性自动设置为 "trackbar"

//使用 progressPos 属性获取或修改滑块当前位置
winform.trackbar.progressPos = 1;

//鼠标按下拖动时在提示控件中显示滑尺当前位置
winform.trackbar.onPosChanged = function( pos,thumbTrack ){

    //thumbTrack 参数表示当前是否正在拖动滑块
    if(thumbTrack){  

    }

    //pos 参数为当前滑块位置
    winform.lbTrackbar.text = pos;
}

//设置外观
winform.trackbar.skin({
    background={
        default=0xFF23ABD9;
    };
    foreground={
        default=0xFFFF771C;
        hover=0xFFFF6600;
    };
    color={
        default=0xFFFF5C00;
        hover=0xFFFF6600;
    }
})

winform.show(); 
win.loopMessage();

请参考:plus 控件范例 - 滑尺控件

plus 控件创建静态控件 #

plus 控件在窗体设计器属性面板中将 【事件回调】属性设 false 则创建静态控件(这是默认值),设为 true 则创建可响应用户操作的动态控件。在窗体设计器双击 plus 控件,或在代码中调用 plus 控件的 skin 函数都会自动设置【事件回调】属性为 true 。

事件回调属性对应于代码中的 notify 属性,这个属性只能由控件的构造参数指定或者由 skin 函数自动设置。

plus 静态控件不会像动态控件那样争抢焦点并改变 Z 序,可作为其他控件的背景控件。相比 bk,bkplus 这样的纯背景控件,plus 静态控件提供了更多的外观选项。

在 plus 控件内添加文本框 #

在窗体设计器中点选 plus 控件,然后在控件属性中设置『允许编辑』为 "edit" 或 "richedit" 就可以在 plus 控件内部显示文本框( edit 控件)或富文本框( richedit 控件)。

这样的好处是可以利用 plus 控件丰富的外观样式美化文本框控件,下面的示例使用 plus 控件创建了一个背景透明、底部划线的单行输入框:

import win.ui;
/*DSG{{*/
var winform = win.form(text="用 plus 创建文本框示例")
winform.add(
plusEdit={cls="plus";left=100;top=48;right=321;bottom=74;align="right";border={bottom=1;color=-6908266};editable=true;textPadding={top=6;bottom=2};z=1}
)
/*}}*/

winform.show();
win.loopMessage();

窗体设计器中控件的 『允许编辑』 属性对应于代码中的 editable 属性 。editable = true 等价于 editable = "richedit" ,表示在 plus 控件内创建 richedit 控件。而 editable = "edit" 则表示在 plus 控件内创建 edit 控件。

注意:高度较小的单行文本框不要将『多行』属性设为 true (对应于代码中的 multiline = true ),避免多行文本框高度太小时无法显示输入光标。

plus 控件演示 #

如果创建 aardio 工程,建议将应用了 plus 控件 skin 函数的样式参数写到库文件里,以简化与重用样式配置参数。

import fonts.fontAwesome;
import win.ui;
/*DSG{{*/
var winform = win.form(text="plus 控件演示";right=759;bottom=469)
winform.add(
plusButton={cls="plus";text="按钮";left=193;top=51;right=292;bottom=81;align="left";bgcolor=8FB2B0;font=LOGFONT(h=-13);iconStyle={align="left";font=LOGFONT(h=-13;name='FontAwesome');padding={left=20}};iconText='\uF021';textPadding={left=39};z=3};
plusCheckBox={cls="plus";text="复选框";left=574;top=51;right=657;bottom=82;align="left";font=LOGFONT(h=-15);iconStyle={align="left";font=LOGFONT(h=-15;name='FontAwesome')};iconText='\uF0C8';textPadding={left=24};z=5};
plusEdit={cls="plus";left=70;top=108;right=386;bottom=134;align="right";border={bottom=1;color=0xFF969696};editable=1;font=LOGFONT(h=-13);textPadding={top=6;bottom=2};z=7};
plusGroupBox={cls="plus";left=18;top=24;right=745;bottom=452;align="left";border={color=0xFF008000;radius=8;width=1};db=1;dl=1;dr=1;dt=1;font=LOGFONT(h=-14);textPadding={left=16};valign="top";z=1};
plusGroupTitle={cls="plus";text="组合框标题,「剪切背景」属性设为 true (默认设置)穿透显示窗口背景";left=156;top=10;right=575;bottom=36;dl=1;dt=1;z=11};
plusHyperlink={cls="plus";text="超链接";left=330;top=51;right=400;bottom=75;color=0x800000;font=LOGFONT(h=-13);textPadding={left=5};z=4};
plusPictureBox={cls="plus";left=70;top=166;right=292;bottom=276;notify=1;z=10};
plusProgressBar={cls="plus";left=70;top=373;right=616;bottom=407;bgcolor=0x626163;forecolor=0x97F8E5;notify=1;z=9};
plusRadioButton={cls="plus";text="单选框";left=437;top=51;right=537;bottom=82;align="left";font=LOGFONT(h=-16);iconStyle={align="left";font=LOGFONT(h=-15;name='FontAwesome')};iconText='\uF111 ';textPadding={left=24};z=6};
plusTrackBar={cls="plus";left=70;top=322;right=512;bottom=337;bgcolor=23ABD9;border={radius=-1};color=0x005CFF;foreRight=15;forecolor=0xFF1C77FF;paddingBottom=5;paddingTop=5;z=8};
plusTransButton={cls="plus";text="透明按钮";left=59;top=51;right=156;bottom=81;align="left";color=0x3C3C3C;font=LOGFONT(h=-13);iconStyle={align="left";font=LOGFONT(h=-13;name='FontAwesome');padding={left=8}};iconText='\uF122';textPadding={left=25};z=2}
)
/*}}*/

// 配置 plus 控件的外观样式 🎨 为超链接效果 
winform.plusHyperlink.skin({
    color = { //文本颜色
        //skin 函数使用的颜色格式都是 0xAARRGGBB
        default=0xFF000080;//默认样式
        active=0xFF00FF00;//点按控件时的样式
        hover=0xFFFF0000; //鼠标移入控件后的样式 
        disabled=0xFF6D6D6D;//禁用时的样式 
    }
})

//响应鼠标点击事件
winform.plusHyperlink.onMouseClick = function(){ 
    raw.execute("http://www.aardio.com");//打开网页
}

//配置 plus 控件外观为复选框效果,使用控件的 checked 属性读写选中状态
winform.plusCheckBox.skin({
    color={ 
        default=0xFF000000;
        hover=0xFFFF0000;
        active=0xFF00FF00; 
        disabled=0xEE666666; 
    };
    checked={ //参数表的 checked 字段设置选中状态下的样式
        iconText='\uF14A' //用单引号包围 Unicode 转义字体图标     
    }
})

//单选框样式
winform.plusRadioButton.skin({
    color={
        active=0xFF00FF00;
        default=0xFF000000;
        disabled=0xFF6D6D6D;
        hover=0xFFFF0000        
    };
    checked={
        iconText='\uF058'       
    };
    group="分组名称";//可选指定单选框分组
})

//显示为按钮效果
winform.plusButton.skin({
    background={ //背景颜色
        default=0x668FB2B0;
        disabled=0xFFCCCCCC;
        hover=0xFF928BB3        
    };
    color={
        default=0xFF000000;
        disabled=0xFF6D6D6D     
    }
})

//响应用户点击命令
winform.plusButton.oncommand = function( id,event ){
    //禁用按钮并播放表示等待的沙漏动画(循环显示 FontAwesome 字体沙漏图标)
    winform.plusButton.disabledText = ['\uF254','\uF251','\uF252','\uF253','\uF250']

    //创建工作线程
    thread.invoke( 
        function(winform){
            thread.delay(2000);

            //启用按钮并停止沙漏动画
            winform.plusButton.disabledText = null;

            winform.plusCheckBox.checked = true;
        },winform
    )
}

//透明背景按钮效果
winform.plusTransButton.skin({
    color={
        active=0xFF00FF00;
        default=0xFF3C3C3C;
        disabled=0xFF6D6D6D;
        hover=0xFFFF0000        
    }
})

/*
plus 控件调用 setProgressRange 函数自动切换为进度条( progress bar )模式。
以前景色与背景色区分进度位置。
*/
winform.plusProgressBar.setProgressRange(1,100)
winform.plusProgressBar.progressPos = 50; //读写当前进度

/*
plus 控件调用 setTrackbarRange 函数自动切换到滑尺( trackbar )模式。
控件的前景边距(水平滑尺指 paddingBottom,paddingTop 属性)指定滑道边距以限制滑道的大小。
控件的前景九宫格切图参数用于控制滑块按钮大小,水平滑尺通过控件参数中的 `foreRight=15` 指定了滑块按钮大小。
使用 winform.plusTrackBar.progressPos 读写滑尺当前进度值。
*/
winform.plusTrackBar.setTrackbarRange(1,100);

//滑尺外观,背景色与前景色用于在滑道上区分进度位置。
winform.plusTrackBar.skin({
    background={
        default=0xFF23ABD9
    };
    foreground={
        default=0xFFFF771C;
        hover=0xFFFF6600
    };
    color={
        default=0xFFFF5C00;
        hover=0xFFFF6600
    }
})

/*
plus 控件显示为进度条或滑尺模式,在进度变更时触发 onPosChanged 事件,
pos 参数为当前进度,triggeredByUser 参数为 true 则是由用户拖动滑块导致进度值变动
*/
winform.plusTrackBar.onPosChanged = function( pos,triggeredByUser ){
    winform.plusProgressBar.progressPos = pos;//拖动滑尺则改变进度条的值
}


import inet.http;
/*
plus 控件直接支持 JPG,PNG 透明背景图像,GIF 动画等。
plus 控件的 background,forground 属性可指定颜色值,也可以指定图像文件路径或内存数据。
如果事先导入 inet.http ,则可以指定为图像网址。
*/
winform.plusPictureBox.background = "http://download.aardio.com/v10.files/demo/transparent.gif";

winform.show();
win.loopMessage();

沙漏动画 #

准备步骤:

然后双击 plus 控件实现的按钮,切换到代码视图,添加以下代码:

winform.plus.oncommand = function(id,event){

    //禁用按钮并播放沙漏动画
    winform.plus.disabledText = ['\uF254','\uF251','\uF252','\uF253','\uF250']

}

winform.plus.disabledText 可以指定 3 种类型的值

  1. 字符串 - 禁用按钮并显示该字符串
  2. 字符数组 - 禁用按钮并显示等待动画,以动画方式循环切换显示字符串数组中的图标字符。 对使用了 FontAwesome 字体的按钮,数组 ['\uF254','\uF251','\uF252','\uF253','\uF250'] 显示的是沙漏动画。 注意用于显示图标的转义字符必须放在单引号内。

    如果 plus 按钮原来就显示了图标文本(plus 控件有「普通文本」与「图标文本」两个不同的属性)则会在图标文本内显示字符图标,否则显示在按钮的普通文本前面。

    数组如果指定了 text 字段,则禁用时也会临时改变原来的文本为 text 字段指定的文本。

  3. null - 当控件的 disabledText 属性设为 null 值,则取消禁用状态,并恢复在禁用之前显示的图标与文本。

完整示例代码

圆角与圆形样式 #

import win.ui;
/*DSG{{*/
var winform = win.form(text="圆角与圆形样式";right=757;bottom=467)
winform.add(
plus={cls="plus";left=113;top=184;right=194;bottom=265;foreRepeat="stretch";notify=1;z=1}
)
/*}}*/

/*
可在创建控件的参数(设计属性)中通过 border.radius  指定圆角半径。
也可通过运行时属性 border.radius 修改圆角半径。

如果 border.radius 大于 0 则裁剪背景与前景为圆角,并将边框显示为圆角。
*/
winform.plus.border = { radius=16 }
winform.plus.background = 0xFF008000;

/*
如果将 border.radius 设为 -1,则裁剪前景(前景图像或前景色)为圆形,
设为 -1 不会影响控件的背景,并且忽略边框的其他设置(也就是不显示边框)。
*/
winform.plus.border = { radius=-1 }
winform.plus.foreground = 0xFF000080;//这时前景为圆形,背景为方形。
winform.plus.background = 0x00008000;//将背景设为透明(Alpha 分量设为0)

//也可以用这种方法自动生成圆形图标
//winform.plus.foreground = "~\extensions\wizard\project2\template\plus\1\res\images\excel.png";

//添加交互样式,显示为圆形按钮
winform.plus.skin(
    foreground = { //圆形效果仅对前景有效,
        default = 0xFF008000; 
        hover = 0xFFE81123; 
        active = 0xFFF1707A; 
    };
    color = {
        default = 0xFFFFFFFF;  
    }
)

winform.show();
win.loopMessage();

Markdown 格式