前页 | 后页 |
绘图方法
使用形状脚本创建形状时,可以使用方法定义形状的值。这些值包括以下内容:
- 形状是什么-矩形,直线,球形
- 形状的大小
- 形状和边框的颜色
- 形状具有的隔室和隔室文本
- 形状及其周围显示的文本和标签
- 形状是否包含或包含捕获的图像
方法语法
<MethodName>“(”“ <ParameterList>”)“;”;
例
形状主体
{
//初始化属性-这些必须在绘制命令之前
noshadow =“ true”;
h_align =“中心”;
//绘制命令(方法)
矩形(0,0,100,100);
println(“ foo bar”);
}
方法
方法名称 |
描述 |
也可以看看 |
---|---|---|
addsubshape(字符串shapename(int宽度,int高度)) |
添加名称为“ shapename”的子形状,该子形状必须在当前形状定义中定义。 |
|
appendcompartmenttext(字符串) |
将其他字符串附加到隔离专区的文本。 文本添加到的隔离专区取决于在使用“ appendcompartmenttext”之前使用“ setcompartmentname”设置的隔离专区名称。 必须调用此方法以显示隔离专区。 |
将自定义隔间添加到元素 |
弧(左向左,向右上方,向右向右,向右下方,向左开始int,向左开始int,向左开始int,向右开始int) |
绘制一个椭圆形的逆时针圆弧,椭圆的范围在左,上,右和下。 圆弧的起始点由椭圆和从椭圆中心到该点的线(startingpointx,startingpointy)的交点定义。 圆弧的末端类似地由椭圆和从椭圆中心到点(endpointx,endpointpoint)的线的交点定义。 例如: 弧(0,0,100,100,95,0,5,0);
|
|
arcto(int左,int顶部,int右,int底部,int起始点,int起始点,int终止点,int终止点) |
对于圆弧方法,除了从当前位置到圆弧的起点绘制一条线,然后将当前位置更新到圆弧的终点。 |
|
bezierto(int控制点1x,int控制点1y,int控制点2x,int控制点2y,int端点x,int端点) |
绘制贝塞尔曲线并更新笔的位置。 |
|
defSize(int width,int height) |
设置元素的默认大小。 这会出现在IF和ELSE子句中,每个子句中都有不同的值,并且每次值更改时都会自动调整元素的大小。 if(HasTag(“ horizontal”,“ true”)) { defSize(100,20); 矩形(0,0,100,100); } 其他 { defSize(20,100); 矩形(0,0,100,100); } 每次更改“标记的值”“水平”时,此示例都会将形状设置为指定的默认大小。 设置此选项后,Alt + Z还会将形状调整为定义的尺寸。 int宽度和int高度的最小值均为10。 |
|
drawingativeshape() |
以其通常的非形状脚本符号渲染形状;随后的绘图命令将叠加在本机符号上。 仅对元素Shape Script启用此方法。不支持线形脚本。 |
|
drawparentshape() |
在扩展非UML对象类型时使用。 渲染从父构造型定义的形状。如果没有可用的继承形状脚本,则其行为与drawativeshape()相同。 |
创建扩展非UML对象的构造型 |
椭圆(左向左,向右上方,向右向右,向下向内) |
绘制一个椭圆,其范围由左,上,右和下定义。 |
|
endpath() |
结束定义路径的绘图命令序列。 |
|
fillandstrokepath() |
使用当前的填充颜色填充先前定义的路径,然后使用当前的笔绘制其轮廓。 |
|
fillpath() |
使用当前的填充颜色填充先前定义的路径。 |
|
getdefaultfillcolor() |
获取元素的默认填充颜色。这可以是所有元素的标准填充颜色,或者,如果在“首选项”对话框的“图>外观”页面上选择了“使用元素组样式”选项,则为元素类型定义默认填充颜色。 |
图表外观选项 标准色 |
getdefaultlinecolor() |
获取元素的默认线条颜色。这可以是所有元素的标准线条颜色,或者,如果在“首选项”对话框的“图>外观”页面上选择了“使用元素组样式”选项,则为元素类型定义的默认线条颜色。 |
标准色 图表外观选项 |
hidelabel(字符串标签名) |
隐藏由labelname指定的标签,其中labelname是以下值之一:
注意:此功能通过将指定标签设置为隐藏来起作用。脚本的任何后续更改都不会再次显示标签。 建议删除标签的方法是覆盖该形状。例如,取消默认构造型标签: 形状中底标签 { 打印(””); } |
|
image(字符串imageId,int左,int顶部,int右,int底部) |
在图像管理器中绘制名称为imageId的图像。 图像必须存在于使用构造型的模型中;如果模型中尚不存在它,则必须将其作为参考数据导入,或从工艺文件中选择它。 如果图像在技术文件中,则文件名的格式应为<技术ID> :: <图像名称>。<扩展名>。 |
导入参考数据 新增图片 |
lineto(int x,int y) |
从当前光标位置到x和y指定的点画一条线,然后将笔形光标更新到该位置。 (另请参见注释部分。) |
|
moveto(int x,int y) |
将笔形光标移动到x和y指定的点。 |
|
多边形(int centerx,int centery,intofsides,int半径,浮点旋转) |
绘制一个以点为中心(centerx,centery),边数为numberofsides的规则多边形。 |
|
打印(字符串文本) |
打印指定的文本字符串。 您不能更改此字体的字体大小或类型。 |
|
printifdefined(字符串属性名,字符串truepart(,字符串falsepart)) |
如果给定的属性存在并且具有非空值,则输出“ truepart”,否则输出可选的“ falsepart”。 您不能更改此字体的字体大小或类型。 |
|
println(字符串文本) |
在形状和换行符后附加一行文本。 您不能更改此字体的字体大小或类型。 |
|
printwrapped(字符串文本) |
打印指定的文本字符串,如果文本宽于其包含的形状,则将其包裹在多行上。 您不能更改此字体的字体大小或类型。 |
|
矩形(向左,向内顶部,向右向内,向下向内) |
绘制一个矩形,其范围在左侧,顶部,右侧,底部。值是百分比。 |
|
roundrect(int左,int顶部,int右,int底部,int abs_cornerwidth,int abs_cornerheight) |
绘制一个带有圆角的矩形,其范围由左,上,右和下定义。 拐角的大小由abs_cornerwidth和abs_cornerheight定义;这些值不随形状缩放。 |
|
setcompartmentname(字符串) |
将隔离专区名称设置为提供的字符串。 在调用appendcompartmenttext之前必须使用此方法;在调用appendcompartmenttext之后调用此函数将清除已添加到隔离专区的所有文本。 |
将自定义隔间添加到元素 |
setdefaultcolors() |
将画笔和笔的颜色恢复为默认设置,或将颜色恢复为用户定义的颜色(如果有)。 |
颜色查询 |
setfillcolor(红色,绿色,蓝色)或 |
设置填充颜色。 您可以通过定义RGB值或使用任何颜色查询返回的颜色值来指定所需的颜色,例如: GetUserFillColor()或 GetUserBorderColor() 在所有情况下,setfillcolor都优先于应用于该元素的任何颜色定义。 |
颜色查询 |
setfixedregion(int xStart,int yStart,int xEnd,int yEnd) |
固定连接器中可以绘制子形状的区域,以使子形状不会随连接器线的长度或方向重新缩放。 有关示例,请参见“ 示例脚本”主题中的“旋转方向”脚本。 |
示例脚本 |
setfontcolor(int红色,int绿色,int蓝色)或 |
设置文本字符串的字体颜色。 您可以通过定义RGB值或使用任何颜色查询返回的颜色值来指定所需的颜色,例如: GetUserFontColor()或 GetUserFillColor() 您可以将此命令与任何文本打印命令一起使用。 |
颜色查询 |
setlinestyle(字符串线型) |
更改使用笔的命令的笔划样式。 字符串线型:具有以下有效样式:
|
|
setorigin(字符串relativeTo,int xOffset,int yOffset) |
相对于主要形状放置浮动文本标签。
|
|
setpen(int红色,int绿色,int蓝色,int笔宽)或setpen(Color newcolor,int笔宽) |
将笔设置为定义的颜色并设置笔的宽度。 此方法仅适用于画线命令。它不影响任何文本打印命令。 |
颜色查询 |
setpencolor(int红色,int绿色,int蓝色)或setpencolor(Color newColor) |
设置笔的颜色。 您可以通过定义RGB值或使用任何颜色查询返回的颜色值来指定所需的颜色,例如: GetUserFillColor() 此方法仅适用于画线命令。它不影响任何文本打印命令。 |
颜色查询 |
setpenwidth(int penwidth) |
设置笔的宽度。笔的宽度应在1到5之间。 此方法仅适用于画线命令。它不影响任何文本打印命令。 |
|
showlabel(字符串标签名) |
显示由labelname指定的隐藏标签,其中labelname是以下值之一:
|
|
startcloudpath(puffWidth,puffHeight,噪声) |
与startpath相似,不同之处在于它以云状弯曲段(粉扑)绘制路径。 参数:
|
|
startpath() |
开始定义路径的绘图命令序列。 |
|
strokepath() |
用当前笔绘制先前定义的路径的轮廓。 |
笔记
- 如果为由多个线段组成的线绘制形状脚本并为线段定义不同的线型,则除中心线段外的所有线段均使用定义的第一个线型;中心线段使用定义的第二条线型,如下所示:
形状 主要
{
//此笔样式将被忽略,因为未绘制任何内容。
setpen(0,0,0,1);
SetLineStyle ( “ solid” );
//此笔样式将用于非中心线段,因为它是
//用于绘图的第一个。
setpen(255,0,0,2);
SetLineStyle ( “ dash” );
通过MoveTo(0,0);
了lineTo(50,0);
//此线型用于中间线段,但没有其他线型,因为它
//不是第一个绘制的对象。
setpen(0,255,0,1);
SetLineStyle ( “ dot” );
了lineTo(100,0);
//此线型仅用于中心线段中的注释。
setpen(0,0,0,1);
SetLineStyle ( “ solid” );
setfixedregion(40, - 10,60,10);
椭圆 (40, - 10,60,10);
}
具有此Shape Script的Dependency连接器可能类似于: