DS标签控件使用DSL文本渲染引擎,支持DSL引擎代码。目前支持代码如下:
<b>粗体</b> |
以粗体显示 |
<i>斜体</i> |
以斜体显示 |
<u>下划线</u> |
以下划线显示 |
<link=标识,链接目标>链接</link>
|
插入一个链接,如果指定enabled=false,则显示为一个灰色不可点击的链接,同时支持指定链接颜色如<link=标识,目标,color=255,0,0>链接</link> |
<link=标识>链接</link> |
|
<link=标识,enabled=false>链接</link> |
|
<link=标识,链接目标,enabled=false>链接</link> |
|
<lineA=r,g,b> |
从当前字符位置到本行结束的指定颜色的实线 |
<lineA=r,g,b,Width=10> |
从当前字符位置到本行结束的指定颜色指定线宽的实线 |
<lineB=r,g,b> |
从下一行起始位置到下一行行结束的指定颜色的实线 |
<lineB=r,g,b,Width=10> |
从下一行起始位置到下一行行结束的指定颜色指定线宽的实线 |
<lineC=r,g,b> |
从当前字符位置到本行结束的指定颜色的实线,忽略后续的换行符 |
<lineC=r,g,b,Width=10> |
从当前字符位置到本行结束的指定颜色指定线宽的实线,忽略后续的换行符 |
<lineD=r,g,b> |
从下一行起始位置到下一行行结束的指定颜色的实线,线条位置位于上一行文本底部,同时忽略后续的换行符 |
<lineD=r,g,b,Width=10> |
从下一行起始位置到下一行行结束的指定颜色指定线宽的实线,线条位置位于上一行文本底部,同时忽略后续的换行符 |
<Center>文本内容</Center> |
将从指定位置开始到本行结束或者指定结束位置之间的文本居中显示 |
<img=图像名称> |
插入一个图像,该图像在设计时不可见,运行时可见,支持Size属性,输出指定大小的图像,如Size=16,16 该图像将触发"请求图像事件",由该事件用户代码返回指定的图像并显示到控件. |
<simg=资源图像名称> |
插入一个图像,该图像在设计时不可见,运行时可见,支持Size属性,输出指定大小的图像,如Size=16,16 示例:<simg=123.png> 从当前程序默认资源包提取名称为123的图像 注意:资源名称大小写敏感,资源必须在项目中设置为"嵌入的资源". |
<linksimg=图像名称> |
插入一个带链接的图像,该图像在设计时不可见,运行时可见,从资源包提取,支持Size属性,输出指定大小的图像,如Size=16,16 示例:<linksimg=123.png> 从当前程序默认资源包提取名称为123的图像 注意:资源名称大小写敏感,资源必须在项目中设置为"嵌入的资源". |
<linksimg=资源图像名称,链接目标> |
|
<linkimg=图像名称> |
插入一个带链接的图像,该图像在设计时不可见,运行时可见,支持Size属性,输出指定大小的图像,如Size=16,16 该图像将触发"请求图像事件",由该事件用户代码返回指定的图像并显示到控件. |
<linkimg=图像名称,链接目标> |
|
<color=r,g,b>文本</color> |
指定颜色的字符,后面使用</color>将相应的字符包含 |
<OffsetY=100> |
指示后续字符应从此Y坐标位置开始布置(像素单位),注意:参数不支持分数形式。 |
<OffsetX=100> |
指示后续字符应从此X坐标位置开始布置(像素单位,位置为DS标签字符偏移X+指定值的和),当OffsetX偏移位置已超出控件右边缘时,自动换行,并恢复为原始偏移X. |
<OffsetX=1/2> |
指示后续字符应从此X坐标位置开始布置(DS标签控件水平宽度的相对分数形式,位置为DS标签字符偏移X+控件宽度*分数),当OffsetX偏移位置已超出控件右边缘时,自动换行,并恢复为原始偏移X.示例: <OffsetX=1/2>表示从DS标签控件水平宽度的二分之一位置开始. |
<%变量名称%> |
插入一个变量,该变量后期可通过属性或方法来进行单独重新赋值。 |
<ChValue=显示文本,目标控件名称,绑定的属性名称,最小值,最大值,当前值> |
显示一个文本字符串,鼠标移入时会显示左右双向箭头,按住鼠标不放可实现对目标控件属性的值的更改,适用于数值型控件。 显示文本:要显示的文本内容 目标控件名称:与当前DS标签同一顶级窗体内的指定控件名称 绑定的属性名称:按住鼠标移动时将数值赋值该属性 最小值、最大值、当前值:指定控件支持最小值、最大值,以及当前的默认值 示例: <ChValue=调整数值,NumericUpDown1,Value,0,100,0> |
<@变量名称@> |
绑定的对象字段、属性名称,该值会自动更新。 |
<块 可见=true>文本内容</块> |
文本块,可对该块设置可见或不可见状态,以便显示或隐藏文本块内的内容。 可见(可省略):True 可见,False 隐藏 |
DSL引擎代码可叠加使用,用法与html代码类似。除字体样式标签外,其余对象均支持tip提示,只需在标签后面的>括号前加上,tip=提示内容。即可在鼠标在其上悬停时显示提示信息。
DS标签控件支持的主要事件
图像的解析:控件触发"请求图像",参数告知正在解析哪个图像名称,用户代码指定"返回图像=对应的图像"
链接的点击:控件触发"点击链接",参数告知点击的是哪个链接
文本更改:当文本有变化时触发