力控学习参考-第三章-脚本函数

396

第三章 脚本函数

脚本函数由力控预先定义，可在界面系统中的动作脚本和动画连接中引用。目前提供的脚本函数类包括：系统、数学、配方、SQL查询、设备操作、字符串操作、Window控件、

内置数据表、其他类函数。

“系统”类和“其它”类包含数据转换、文件操作、系统功能调用、对象操作等功能函数。

“数学”类包含一组常用数学运算函数；

“配方”类包含一组用于控制配方管理器的函数；

“SQL查询”类包含一组用于实现SQL访问功能的函数；

“设备操作”类包含一组实现计算机I/O读写操作的函数；

“字符串操作”类包含一组对字符串进行操作的函数。

“Windows控件”类包含一组对力控Windows控件对象（如表格，下拉框等）进行操作的函数。

“内置数据表”类包含一组对内置数据表进行操作的函数。

1、系统函数

AlmAck

语法

说明

AlmAck()

当前最新报警确认,当前最新报警显示在系统报警窗右侧。要显示系统报警窗，首先要选中参数

返回值

备注

示例

系统参数中系统报警检查框。

AlmAck();

AlmAckAll

语法

说明

AlmAckAll(DataSourceNo,AreaNo)

对数据库中某一区域报警进行确认。

DataSourceNo数据源号，类型为整型，序号从0开始。

AreaNo指定区域号,-1表示所有区域。

参数

返回值

备注

示例

AlmAckAll(0,-1);//对整个数据库报警进行确

第三章 脚本函数 397

认。

Beep

语法

说明

参数

beep(number)

蜂鸣器发出叫声。

参数number用于指定不同的音响。

-1,0:为两种报警声。

1~7对应乐谱的中音1至7。

返回值

备注

示例

8~14对应乐谱的高音1至7。

beep(-1); //标准报警声。

ChangeGroup

语法

说明

参数

返回值

备注

示例

ChangeGroup（GroupNumber）

该函数用于历史趋势、实时趋势、模板中的变量成组替换，替换量一般为DB变量。

为数值常量或数值表达式，该参数的值表示变量组的组号。

对于模板对象，只是替换位号名，参数部份保留不变。

ChangeGroup（2）;//该函数将实时趋势、历史趋势和模板中的变量分别替换成序号为2的变量组中的变量。

ChangeTag

语法

说明

ChangeTag(OldTag,NewTag)

替换位号,该函数用于模板变量的替换，替换量一般为ＤＢ变量．注意这里只是替换位号名，参数

参数部分保留不变。

OldTag 为字符串常量或字符串表达式，该参数为被替换量．

NewTag 为字符串常量或字符串表达式，该参

398 第三部分 参考手册

数为替换量．

返回值

备注

示例

ChangeTag("T1","LIC504") //该函数将模板中的位号Ｔ１，替换成数据库中的实际位号ＬＩＣ５０４．如模板中有如下变量,,,等，替换后将变为,,,.

ChangeTagByNo

语法

说明

ChangeTagByNo(no,"NEWTAG")

该函数用于模板变量的替换，替换量一般为ＤＢ变量．注意这里只是替换位号名，参数部分保留不变．

no为数字常量或数字表达式，为在实时趋势，历史趋势中变量的序号与组号相同，模板中变量的序号与在模板变量替换框中所看到的顺序相同．双击模板对象便出现模板变量替换框

NewTag 为字符串常量或字符串表达式，该参返回值

备注

示例

数为替换量．

ChangeTagByNo(1,＂ＬＩＣ５０４＂)//该函数将趋势／模板中的序号为１的变量替换成数据库中的实际位号ＬＩＣ５０４．

参数

CloseWindow

语法

说明

参数

返回值

备注

示例

CloseWindow（）

关闭当前窗口，一般用于弹出式窗口的关闭。

CloseWindow（）;

第三章 脚本函数 399

Delay

语法

说明

参数

返回值

备注

示例

Delay(millionsec)

时间延迟

millionsec: 数值常量或数值表达式，表示延迟的毫秒数。

Delay(1000);//延迟１秒。

DisableOperate

语法

说明

参数

DisableOperate (flag)

禁止用户对变量的操作。

flag禁止标志。取值含义：0：允许操作；1：表示禁止操作；2：除了禁止用户操作外，还将禁止任何脚本中向DB设置数据请求。

返回值

备注

示例

DisableOperate (1);//禁止操作

DisableOperate (0);//允许操作

Display

语法

说明

参数

返回值

备注

示例

Display(WinName)

显示名字为WinNamede的窗口。

显示名字为WinName的窗口。如果该窗口已经运行，则该窗口将成为当前活动窗口。

Display(“Win01”); //显示窗口Win01。

EventDisp

语法

说明

EventDisp()

显示系统事件．

系统事件包括程序起停信息，操作记录，系统错误信息等．

400 第三部分 参考手册

参数

返回值

备注

示例

EventDisp()//调用该函数将出现一事件显示框．

Exit

语法

说明

参数

Exit(code)

code取值为０，１，２，３，４。

０表示退出程序。

１表示窗口最小化。

２表示退出所有力控程序。

３表示重新启动系统。

４表示关闭系统。

返回值

备注

示例

Exit(0);// 退出应用程序

FileCopy

语法

说明

FileCopy(SourFileName,DestFileName

Overwrite )

,

文件复制。复制已有文件（由文件名SourFileName指定）到一新文件（由文件名DestFileName指定）

SourFileName：字符串常量，或字符串表达式，为源文件名（完整的路径），即已存在文件。

DestFileName：字符串常量，或字符串表达式，为新文件名（完整的路径）。

Overwrite：整型量，覆盖标志。该量如果为0，如果同名文件已经存在，那么复制失败；非0将覆盖已有文件

返回值

备注

示例

为1成功；为0失败。

FileCopy("c:",

c:, 0);

//将c:盘下abc目录下的文件，复参数

第三章 脚本函数 401

制到根目录，并命名为。如果存在，复制失败。

FileDelete

语法

说明

参数

返回值

备注

示例

FileDelete(FileName)

删除指定的文件。

FileName：文件名。

FileDelete("dat01")//删除文件。

FileMove

语法

说明

FileMove(SourFileName,DestFileName )

文件/目录改名或移动。将已有文件/目录（由文件名SourFileName指定或目录）改名，或移动到一新的位置（由文件名DestFileName指定）。

SourFileName：字符串常量，或字符串表达式，为源文件名或目录名（完整的路径），即已存在文件或目录。

DestFileName：字符串常量，或字符串表达式，为新文件名或目录名（完整的路径）。

返回值

备注

示例

为1成功；为0失败。

如果移动到不同的驱动器上，将进行文件、目录复制。

FileMove("c:",

c:);

//将文件改名为。

FileMove("c:",

c:);

//将c:盘下doc1目录下的文件，移动到到目录doc2下。

FileMove("c:doc1, c:doc2);

//将c:盘下目录doc1改名为doc2。

参数

402 第三部分 参考手册

FileRead

语法

说明

参数

FileRead(FileName,VarName,Offset,Num)

从指定的文件中回读数据。

FileName：文件名。

Offset: 偏置。从该偏置开始读。偏置以0为基准。

Num:要读取的数据个数。

VarName:从该变量开始写，按照变量的名称中的数字顺序依次访问。

如变量为返回值

备注

示例

var01,其后变量依次为。

FileRead("dat01",var01,0,10)//从文件dat01中读取10个数据,结果放入var01

开始的变量中。

FileWrite

语法

说明

参数

FileWrite(FileName, VarName,Offset ,Num)

往指定的文件中写数据。

FileName：文件名。

VarName:从该变量开始写，按照变量的名称中的数字顺序依次访问。

如变量为var01,其后变量依次为。

Num:要写的数据个数。

返回值

备注

示例

FileWrite("dat01",var01, 0,10)//从var01开始依次向文件dat01写入10个数据。

GetAppPath

语法

说明

参数

返回值

GetAppPath()

取得当前应用目录。

类型为字符串，完整的应用路径字符串。

第三章 脚本函数 403

备注

示例

StrPath = GetAppPath()

GetCurAlm

语法

说明

参数

GetCurAlm(alminfor,VAR$)

返回值为当前报警优先级.若报警已经确认则返回值为０．

alminfor为某一区域的当前最新报警信息

$ALARMTXT00为区域０当前最新报警信息

$ALARMTXT01为区域1当前最新报警信息．

$ALARMTXT02为区域０当前最新报警信息．

.

.

$ALARMTXT为整个数据库当前最新报警信息．

VAR$ 为字符型变量，函数返回时保存当前发生报警位号名．

返回值

备注

示例

IF (GetCurAlm($ALARMTXT00,S1) > 0) THEN

MsgBox("DB Area 0 is alarming

TAG="+S1);

ENDIF

// 如果ＤＢ区域０中出现报警，假设报警位号是LIC504，将出现一信息框，内容为：＂DB Area 0 is alarming Tag=LIC504＂

GetDataSourceStat

语法

说明

参数

返回值

备注

示例

GetDataSourceStat（DataSourceNo）

取得数据源状态

DataSourceNo 数据源序号，序号从0开始。

0 表示数据源状态正常，否则故障。

404 第三部分 参考手册

GetHisData

语法

说明

参数

GetHisData(Var,Year,

Hour,Minute,Second)

Month, Day,

Var 欲存取的变量，该变量必须是DB变量，该参数不能包含在""中。

Year :整型，表示年,范围1999~2037 。0表示当年。

Month: 整型，表示月, 范围1~12。0表示当月。

Day: 整型，表示日, 范围1~31。0表示当天，负值表示前多少天，如-1 表示前1天，-2 表示前2天„。

Hour: 整型，表示时, 范围0~23。 负值表示前多少小时，如-1 表

示前1小时，-2 表示前2小时„。

Minute: 整型， 表示分, 范围0~59。负值表示前多少分钟，如-1 表

示前1分钟，-2 表示前2分钟„。

Second:表示秒, 范围0~59。负值表示前多少秒，如-1 表

示前1秒，-2 表示前2秒„。

实型，该点在指定时刻的历史值。

1)val =

GetHisData(,2000,12,21,10,0,0);

取数据库中的点在2000年12月21日10时00分00秒的历史数据。

2)val

GetHisData(,0,0,-1,10,0,0);

取数据库中的点在本年本月昨日10时00分00秒的历史数据。

=

返回值

备注

示例

GetStatisData

语法

说明

参数

GetStatisData(Var,Year,

Hour,TimeSpan,Type,Time)

Year, Month, Day, Hour指定的是开始时间，Month, Day,

第三章 脚本函数 405

TimeSpan指定的是时间长度。

Var 欲存取的变量，该变量必须是DB变量，该参数不能包含在""中。

Year :整型，表示年,范围1999~2037 。0表示当年。

Month: 整型，表示月, 范围1~12。0表示当月。

Day: 整型，表示日, 范围1~31。0表示当天，负值表示前多少天，如-1 表

示前1天，-2 表示前2天„。

Hour: 整型，表示时, 范围0~23。 负值表示前多少小时，如-1 表

示前1小时，-2 表示前2小时„。

TimeSpan:整型，为时间范围，单位为小时。前多少小时内的统计数据。

如果Hour为8，TimeSpan为1，表示8点~9点的统计数据（注意：对应于数据表中9点的数据）；TimeSpan为2，表示6点~8点的统计数据。

Flag: 表示取何种统计数据。0：表示Aver；

1: 最大值 2: 最小值。

Time: 字符型变量，为达到最大/最小值返回值

备注

示例

的时间。

实型，该点在指定时间段的统计值。

1)val = GetStatisData

(,2000,12,21,10, 1，0,strTime);

取数据库中的点在2000年12月21日10~11时的平均值。

2)val = GetStatisData (,0,0,-1,10,

2，1,strTime);

取数据库中的点在本年本月昨日10~12时的最大值。

3)val = GetStatisData (,0,0,-1,18,

3，2,strTime);

取数据库中的点在本年本月昨日18~21时的最小值。

GetTagKind

语法 GetTagKind("TagName",nDataSource)

406 第三部分 参考手册

说明

参数

得到点类型，即得到点在实时数据库中点的类型号。

TagName: 点名称，字符串变量或常量。

nDataSource : 整型，数据源序号，数据源序号以0开始，注意该序号会因数据源的删减而变动。

点类型号，整型。

KIND = GetTagKind("FI1001",0)

返回值

备注

示例

Hide

语法

说明

参数

返回值

备注

示例

Hide()

隐藏图形目标。如果目标处于隐藏状态，它将不接受鼠标动作。但可以执行杂项/一般动作。

该函数只对图元对象起作用。

Hide();

HideWindow

语法

说明

HideWindow(WinNamede)

隐藏名字为WinNamede的窗口。如果窗口处于隐藏状态，它将不接受鼠标动作。但可以执行杂项/一般动作。

参数

返回值

备注

示例

字符串

HideWindow(“aaa”);

IntoConfig

语法

说明

参数

返回值

IntoConfig()

进入组态状态．

第三章 脚本函数 407

备注

示例

IntoConfig()

LayerToBottom

语法

说明

参数

返回值

备注

示例

LayerToBottom()

调用该函数将图元排列到最后面，即被其它任何叠加图元覆盖

LayerToBottom()

LayerToTop

语法

说明

参数

返回值

备注

示例

LayerToTop()

调用该函数将图元排列到最前面，即不被其它任何图元覆盖

LayerToTop()

Login

语法

说明

参数

返回值

备注

示例

Login()

用户注册，调用该函数将出现用户注册对话框。

Login()

Logout

语法

说明

参数

返回值

Logout()

用户注消，调用该函数将出现用户注消对话框。

408 第三部分 参考手册

备注

示例

Logout()

LongTime

语法

说明

参数

LongTime(String)

将字符串形式表示的时间转成整型数。

String：要转换的字符格式的时间，类型为为字符串常量、变量或字符串表达式。

时间格式规定如下：YYYY/MM/DD hh:mm:ss

YYYY为年；MM为月；DD为日；hh为时;mm为分；返回值

备注

示例

ss为秒

为整型数表示的时间，该数值为自1970年1月1日零时逝去的秒数。

n = LongTime("2002/1/8 16:50:00")

MsgBox

语法

说明

参数

返回值

备注

示例

MsgBox(Message)

显示一提示框

Message 为字符串常量或字符串表达式．其值为提示框中显示的信息

返回值为1表示选择了“是”，0表示选择了“否”。

Message("System Alarm");

RTN = Message("System Alarm");

PlaySound

语法

说明

参数

PlaySound(AviName,flag)

播放一段由文件名AviName指定的音乐

AviName：Avi文件名。

flag：播放方式取值为0或1。0:代表异步;1:返回值

备注

代表同步。

示例

Print

语法

说明

参数

返回值

备注

示例

PrintEX

语法

说明

参数

返回值

备注

示例

Rand

语法

说明

参数

返回值

备注

示例

第三章 脚本函数 409

PlaySound(“Avi01”,0); //异步方式播放AVI文件Avi01。

print(WinName)

打印名称为“WinName”的窗口内容。

字符串

Print(“Win01”); //打印窗口Win01。

PrintEx(WindowName,left,top,right,bottom);

打印窗口的特定区域。

WindowName: 窗口名称，字符串变量或常量。

left,top,right,bottom均为为整型，指定的是要打印的矩形区域。其中left，top分别为矩形区域左上角横坐标和左上角纵坐标；right，bottom分别为矩形区域右上角横坐标和右上角纵坐标。左右上角坐标可以通过将光标移至相应位置，并记录光标当前位置而得到。

PrintEx("",50, 50, 550, 650);

rand(number)

产生随机数

number为随机数的上界，下界为0。

Rand(100) 会产生0~100之间的随机数（不包括100）

410 第三部分 参考手册

ReachTime

语法

说明

参数

ReachTime(hour,minute)

定时器

hour小时值，取值为０～２３，－１表示任何一小时

minute分钟值，取值为０～５９

返回值

备注

示例

当时间到达后返回值为真,否则为假

IF (ReachTime(8,30)) THEN

BEEP(1);

ENDIF;

//每天上午８时３０分该函数取值为真,这时将发出一声．

Show()

语法

说明

参数

返回值

备注

示例

Show()

如果目标处于隐藏状态，执行该动作后图元恢复显示。

该函数只对图元对象起作用。

Show();

ShowEx()

语法

说明

参数

返回值

备注

示例

ShowEx(flag)

显示或隐藏图形目标。

flag为０时图形目标被隐藏，否则将显示该图形目标．

该函数只对图元对象起作用。

ShowEx(0);// 目标被隐藏.

SnapShotView

语法 SnapShotView()

说明

参数

返回值

备注

示例

StartApp

语法

说明

参数

返回值

备注

示例

StrTime

语法

说明

参数

返回值

备注

示例

SubWin

语法

说明

参数

返回值

第三章 脚本函数 411

快照浏览,若不选择浏览文件，浏览窗口将自动顺序播放．

SnapShotView()

StartApp(AppName)

启动应用程序，应用程序的名称和路径由AppName指定。

字符串

StartApp(“c:”); //启动画笔程序。

StrTime(time, format)

将整型时间转成字符串形式．

time 自1970年1月1日零时逝去的秒数。

format 要转成的时间格式标识，规定如下：

0：yyyy/mm/dd hh:mm:ss

1：yyyy-mm-dd hh:mm:ss

2：yyyy年mm月dd日 hh:mm:ss

StrTime(curtim, 0);将整型变量curtim中的时间值转成字符串形式

SubWin（WinName）

调用子窗口

WinName 为窗口名称。

412 第三部分 参考手册

备注

示例

SubWin（“SubWin01”）;

SubWinEx

语法

说明

参数

返回值

备注

示例

TipDisp

语法

说明

参数

返回值

备注

示例

ToPrint

语法

SubWinEx(WinName,left,top,width,height,flag)

调用子窗口

WinName 为窗口名称。

left 为窗口左上角横坐标。

top为窗口左上角纵坐标。

width为窗口宽度。值为0表示按窗口设计宽度。height为窗口高度。值为0表示按窗口设计高度。flag为窗口定位方式，其取值为0~2

0: 表示按参数left,top,windth,height指定位置定位;

1: 表示按窗口设计位置定位；

2: 表示按调用窗口的目标位置就近定位。

SubWinEx（“SubWin01”,10,10,100,100）;

TipDisp(Prompt,Delay,StayTime)

信息提示

Prompt字符串常量或字符表达式

Delay 延迟显示时间，即只有鼠标在对象上停留时间超过该值后，才会显示提示信息。

StayTime 提示框逗留时间，超过该时间后，信息消失。

TipDisp("This is reactor-R101",500,3000)

ToPrint()

第三章 脚本函数 413

说明

参数

返回值

备注

示例

打印当前窗口

ToPrint();

TrendTimeSet

语法

说明

参数

TrendTimeSet(StartTime, TimeSpan)

历史趋势时间设置。

StartTime：趋势开始时间，类型为数值型常量、变量或数值型表达式。该数值为自1970年1月1日零时逝去的秒数

TimeSpan：趋势时间长度，单位为秒，类型为数值型常量、变量或数值型表达式。

返回值

备注

示例

TrendTimeSet ($CurTime - 7200, 3600);//趋势时间为前2小时~前1 小时。

TrendTimeSet(LongTime("2002/1/8

16:50:00"), 3600);

UserMan

语法

说明

UserMan ()

增加或删除用户。调用该函数时将出现一用户管理对话框，在该对话框中，用户可以添加新的用户或删除已有用户。注意：只有权限为工程师级以上的用户才能掉出该用户管理对话框，并且其只能增加或删除比自己权限低的用参数

返回值

备注

示例

户。

UserMan()

414 第三部分 参考手册

UserPass

语法

说明

UserPass(UserName)

修改用户口令，调用该函数时将出现一用户口令修改对话框，在该对话框中，用户可以改变参数

由参数UserName所指定的用户名的口令。

UserName字符串常量或字符表达式，为用户名称。如果该参数为空值，当前注册用户的口令将被修改。

返回值

备注

示例

UserPass ("User1")

ValInputAni

语法

说明

ValInputAni（VarName,Prompt,password,promt）

模拟量输入，调用该函数将出现一模拟输入框，通过该输入框可以修改模拟量的值。VarName为一数值变量，输入框确认后变量的值将被修改。

参数 Prompt为字符串常量或字符串表达式，Prompt为1时，该提示信息将被显示在输入框中。

password为一数值常量，0表示不显示输入信息，否则显示输入信息。 promto为一数值常量，表示是否出现提示信息，0表示不显示提示信息，否则显示提示信息。

返回值

备注

示例

ValInputAna(var1,"Please Input A

Value",0,1);//该函数调用后将出现一模拟输入框，提示

信息为Please Input A Value．

ValInputDis

语法 ValInputDis（VarName,Prompt, ONPrompt，OFFPrompt）

第三章 脚本函数 415

说明 调用该函数将出现一开关选择框，通过该选择框可以修改开关量的值。 VarName 为一数值变量，输入框确认后改变量的值将被修改。

Prompt为字符串常量或字符串表达式，prompt为１时．该提示信息将被显示在输入框中，

ONPrompt为字符串常量或字符串表达式，该提示信息将被显示在选择框状态为真

的按钮上。

OFFPrompt为字符串常量或字符串表达式，该提示信息将被显示在选择框状态为假

的按钮上。

参数

返回值

备注

示例

ValInputDis(var1,"Please Set Switch

Status","ON","OFF");//该函数调用后将出现一开关选择框输入框. 信息为Please Set

Switch Status,＂真＂提示信息为ON；＂假＂提示信息为OFF。

ValInputEnum

语法

说明

参数

ValInputEnum(VarName,Prompt,Prom1,Prom2,Prom3,Prom4,Prom5, Prom6,Prom7,Prom8);

枚举量输入，调用该函数将出现一枚举选择框，通过该选择框可以选择枚举量的值。

VarName为一数值变量，选择框确认后改变量的值将被修改。

Prompt 为字符串常量或字符串表达式，该提示信息将被显示在选择框中，

Prom1 为数值0的提示信息，该项将被显示在选择框中的第1项中。

Prom2 为数值1的提示信息，该项将被显示在选择框中的第2项中。

Prom3 为数值2的提示信息，该项将被显示在选择框中的第3项中。

Prom4 为数值3的提示信息，该项将被显示在选择框中的第4项中。

416 第三部分 参考手册

Prom5 为数值4的提示信息，该项将被显示在选择框中的第5项中。

Prom6 为数值5的提示信息，该项将被显示在选择框中的第6项中。

Prom7 为数值6的提示信息，该项将被显示在选择框中的第7项中。

Prom8 为数值7的提示信息，该项将被显示在选择框中的第8项中。

返回值

备注

示例

ValInputEnum(var1,"Please Select PID

Control mode

","AUTO","MAN","CASE","","","","","");

//该函数调用后将出现一字符输入框，

提示信息为Please Select PID Control

mode．提示0~7信息依次为AUTO,MAN,CASE。

ValInputStr

语法

说明

参数

ValInputStr(VarName,Prompt,password,prompt)

调用该函数将出现一字符输入框，通过该输入框可以修改变量的值。

VarName为一字符变量，输入框确认后改变量的值将被修改。 Prompt 为字符串常量或字符串表达式。

prompt为１时，该提示信息将被显示在输入框中。

password 为一数值常量，0表示不显示输入信息，否则显示输入信息。

prompt 为一数值常量，表示是否出现提示信息。0表示不显示提示信息，否则显

返回值

备注

示例

示提示信息。

ValInputStr(var1,"Please Input A

Value",0,1);//该函数调用后将出现一字符输

第三章 脚本函数 417

入框，提示信息为Please Input A Value。

2、数学函数

Abs

语法

说明

参数

返回值

备注

示例

ArcCos

语法

说明

参数

返回值

备注

示例

ArcSin

语法

说明

参数

返回值

备注

示例

abs(number)

返回number 的绝对值

实型、整型

与number类型相同

一个数的绝对值是将正负号去掉以后的值

例如，ABS(-1) 和ABS(1) 都返回1

arccos (number)

返回number 的反余弦值

实型、整型，值的范围在0和1之间

与number类型相同, 值的范围在 -90 和 90度之间

arccos函数的参数值 (number) 为直角三角形两边的比值并返回以角度为单位的角。

这个比值是角的邻边长度除以角的斜边长度之商。

Arccos (1); //返回结果为0。

arcsin(number)

返回number 的反正弦值

实型、整型，值的范围在-1和1之间

与number类型相同, 值的范围在 -90 和90度之间

arcsin函数的参数值 (number) 为直角三角形两边的比值并返回以角度为单位的角。

这个比值是角的对边长度除以角的斜边长度之商。

Arcsin(1); //返回结果为90。

418 第三部分 参考手册

ArcTan

语法

说明

参数

返回值

备注

示例

ArcTan2

语法

说明

参数

返回值

备注

示例

Cos

语法

说明

参数

返回值

备注

示例

Arcctan(number)

返回number 的反余切值

实型、整型

与number类型相同, 值的范围在 -90 和 90度之间

arctan 函数的参数值 (number) 为直角三角形两边的比值并返回以角度为单位的角。

这个比值是角的邻边长度除以角的对边长度之商。

arctan (1); //返回结果为45。

atan2(y,x)

求y/x的反正切值

x,y为任意数值。

返回值为-180~180

g = atan(0, 0); g的值将为0；g =

atan(-1,-1); g的值将为-135；

Cos(number)

返回number 的余弦值

实型、整型, 以角度为单位

返回值为实型, 值的范围在 -1 和 1之间

Cos 函数取一角度为参数值，并返回（直角三角形中）角的邻边长度除以斜边长度的比值。

结果的取值范围在 -1 到 1 之间

Cos (60); //返回结果为0.5

Exp

语法

说明

参数

返回值

备注

示例

Int

语法

说明

参数

返回值

备注

示例

Log

语法

说明

参数

返回值

备注

示例

Logn

语法

说明

第三章 脚本函数 419

Exp(number)

返回e 的number次方

实型数或任何有效的数值表达式

返回值为实型，指定 e（自然对数的底）的number次方

如果number 的值超过 709.782712893，则会导致错误发生。常数 e 的值大约是 2.718282。

Exp 函数的作用和 Log 的作用互补，所以有时也称做反对数。

Myvar = Exp(2.0); //返回结果为7.3891。

Int(number)

返回小于等于指定数字 number 的最大整数。

实型数据或任何有效的数值表达式。

与number类型相同，返回小于该数的最大整数。

Int(6.6);// 返回结果为6。

Int(-6.6);// 返回结果为-7。

Log(number)

返回 number 的自然对数值。

大于 0 的实型数或任何有效的数值表达式。

返回一个实数，指定参数的自然对数值。

自然对数是以 e 为底的对数。常数 e 的值大约是 2.718282。

MyVar = Log(10);//返回结果为2.30259

logn(number1,number2)

返回 以number1为底number2的对数

420 第三部分 参考手册

参数

返回值

备注

示例

Max

语法

说明

参数

返回值

备注

示例

Min

语法

说明

参数

返回值

备注

示例

Pow

语法

说明

参数

返回值

备注

示例

大于 0 的实型数或任何有效的数值表达式

返回一个实数，指定参数的自然对数值

以number1为底nuber2的对数

MyVar = Logn(10,100);//返回结果为2

Max(expr1，expr2)

返回expr1，expr2中的最大值

实型参数或任何有效的数值表达式。

返回expr1，expr2中的最大值

A = 5;B = 10;

C = Max(A,B); //返回结果为10。

Min(expr1，expr2)

返回 expr1，expr2中的最小值

实型数或任何有效的数值表达式

实型数

A = 5; B = 10

C = Min(A,B); //返回结果为5。

pow(number1,numer2)

幂运算

实型数或任何有效的数值表达式。

返回值为实型。

计算以number1为底number2次幂。

VAR= pow（2，3）;//返回结果为8。

Sin

语法

说明

参数

返回值

备注

示例

Sqrt

语法

说明

参数

返回值

备注

示例

Tan

语法

说明

参数

返回值

备注

示例

Trunc语法

说明

参数

返回值

第三章 脚本函数 421

Sin(number)

求指定参数的正弦值。

实型、整型, 以角度为单位

返回值为实型，取值范围在 -1 到 1 之间。

以角度为参数，并返回(直角三角形中)角的对边长度除以斜边长度的比值。结果的取值范围在 -1 到 1 之间。

Sin(30); //返回结果为0.5。

Sqrt(number)

求指定参数的平方根。

实型数或任何有效的大于或等于0的数值表达式。

返回值为实型

参数为大于或等于0的实数。

MyVar = Sqrt(100);//返回结果为10.0。

Tan(number)

求指定参数的正切值。

实型数或任何有效的数值表达式，以度为单位。

返回值为实型

以角度为参数，并返回直角的两条邻边的比值。该比值是直角三角形中角的对边长度除以角的邻边长度的商。

Tan(45);//返回结果为1.0。

trunc（number）

返回一个整数。

实型数或任何有效的数值表达式。

返回值为实型

422 第三部分 参考手册

备注

示例

通过截去number小数据点右边部份得到一个整数。

var1=turnc(6.8);//返回结果为6

var2=turnc(-6.8);//返回结果为-6

3、配方类函数

RecipeLoad

语法

说明

参数

返回值

备注

示例

RecipeLoad（RecipeGroupName，RecipeName）

装入配方组中指定的配方

RecipeGroupName 配方组名称,为字符串常量或变量RecipeName 配方名,为字符串常量或变量

RecipeLoad("Recipe1",RecipeNameVar);

RecipeModify

语法

说明

参数

RecipeModify(RecipeGroupName, RecipeName)

用当前变量值来修改对应配方组中的配方

RecipeGroupName 配方组名称,为字符串常量或变量RecipeName 配方名,选择框确认后的返回值，必须为一字符串变量

返回值

备注

示例

RecipeModify("Recipe1",RecipeNameVar);

RecipeSelect

语法

说明

参数

RecipeSelect(RecipeGroupName, RecipeName)

配方选择框，在该对话框中可以选择配方。

RecipeGroupName 配方组名称,为字符串常量或变量RecipeName 配方名,选择框确认后的返回值，必须为一字符串变量

返回值

备注

第三章 脚本函数 423

示例 RecipeSelect("Recipe1",RecipeNameVar);

RecipeSelNext

语法

说明

参数

RecipeSelNext(RecipeGroupName,

RecipeName)

选定指定配方的下一个配方。

RecipeGroupName 配方组名称,为字符串常量或变量RecipeName 配方名，为字符串常量或变量.

返回值

备注

示例

RecipeSelNext("Recipe1","RecipeNameVar")

RecipeSelPrev

语法

说明

参数

返回值

备注

示例

RecipeSelPrev(RecipeGroupName,

RecipeName)

配方选择框，在该对话框中可以选择配方。

RecipeGroupName 配方组名称,为字符串常量或变量RecipeName 配方名，为字符串常量或变量.

RecipeSelPrev("Recipe1","RecipeNameVar");

4、SQL函数

SQLClearTable

语法

说明

参数

返回值

备注

示例

SQLClearTable(ConnectID, DataTableName)

删除数据表中所有记录，但不删除数据表

ConnectID 数据源标识，由SQLConnect调用返回。DataTableName 字符串，新建的数据表名称。

该函数只删除记录，不删表。

SQLClearTable(ConnectID,"Tab1");

424 第三部分 参考手册

参数ConnectID由SQLConnect调用得到。数据表名为"TAB1"。

SQLConnect

语法

说明

参数

SQLConnect( ConnectID,DataSourceDesc)

连接到指定的数据库

ConnectID 整型，数据源标识，为返回值，该值将用于其它SQL函数。DataSourceDesc 字符串，数据源描述。数据源描述可以通过"数据源"按钮返回值

备注

示例

得到。

数据源使用完后，使用SQLDisconnect来断开连接

SQLConnect(ConnectID,"DSN=MS Access 97

Database;DBQ=c:;DefaultDir=c:FCSqltest;DriverId=25;

FIL=MSAccess;MaxBufferSize=512;PageTimeout=5;UID=admin;");

SQLCreateTable

语法

说明

参数

SQLCreateTable(ConnectID, DataTableName,

TableTemplateName)

使用表格模板在数据库中创建数据表。

ConnectID 数据源标识，由SQLConnect调用返回。DataTableName 字符串，新建的数据表名称。TableTemplateName字符串，使用的数据表模板名称。数据表模板规定了数据表中各字段名称及属性。

返回值

备注

示例

SQLCreateTable(ConnectID,"TAB1", "A");参数ConnectID由SQLConnect调用得到。数据表名为"TAB1"据表模板为"A"，数据表模板"A"必须在SQL管理器中事先建立。

第三章 脚本函数 425

SQLDelete

语法

说明

参数

SQLDelete(ConnectID,DataTableName,WhereExpr)

删除一个或多个记录。

ConnectID 数据源标识，由SQLConnect调用返回。DataTableName 字符串，数据表名称。

WhereExpr字符串，选择表达式，只对符合该条件的记录进行操作。

返回值

备注

示例

WhereExpr 参数为空" ",时将删除所有记录。

SQLDelete(ConnectID,"Tab1", "");参数ConnectID由SQLConnect调用得到。数据表名为"Tab1"。条件为空""表示删除所有记录。

SQLDelete (ConnectID,"Tab1","A = 50");

只删除字段A等于50的记录。

SQLDisconnect

语法

说明

参数

返回值

备注

示例

SQLDisconnect(ConnectID)

关闭数据库连接。

ConnectID 整型，数据源标识。由SQLDisconnect调用返回。

数据源使用完后，应该使用该函数来断开连接。

SQLDisconnect(ConnectID);

参数ConnectID由SQLConnect调用得到。

SQLDisplay

语法

说明

参数

返回值

备注

示例

SQLDisplay(nLineCount)

查看由SQLSelect()选择的数据集中的记录。

RowNum要查看的记录数

SQLDisplay(10);显示从当前光标位置以下10条记录。

426 第三部分 参考手册

SQLDisplayToGrid

语法

说明

参数

返回值

备注

SQLDisplayToGrid(GridObjName)

查看由SQLSelect()选择的数据集中的记录，将记录显示到GridObjName所指定的表格对象中。

GridObjName 为表格对象名称，字符串类型。

如果表格中的列数少于数据集中的列数，只显示表格中有的列。如果表格中有多余的列，其内容将为空。

示例 SQLDisplayToGrid ("MyGrid");//Mytab为数据表名称。

SQLDropTable

语法

说明

参数

返回值

备注

示例

SQLDropTable(ConnectID, DataTableName)

删除数据表

ConnectID 数据源标识，由SQLConnect调用返回。DataTableName 字符串，新建的数据表名称。

如果表中记录不为空，操作将失败。

SQLDropTable(ConnectID,"Tab1");参数ConnectID由SQLConnect调用得到。删除的数据表名为"Tab1"

SQLExecute

语法

说明

参数

返回值

备注

示例

SQLExecute(ConnectID ,SqlCommand)

执行一条SQL语句。

ConnectID 数据源标识，由SQLConnect调用返回。SqlCommand 字符串，SQL命令。

选择的数据集不能被显示，遍历。

SQLExecute(ConnectID,"Select

到。删除的数据表名为"Tab1"

* From

tab1");参数ConnectID由SQLConnect调用得

第三章 脚本函数 427

SQLFirst

语法

说明

参数

返回值

备注

示例

SQLFirst()

选择由SQLSelect()选择的数据集中的第一条记录。

SQLFirst();

SQLGet

语法

说明

SQLGet(BindTableName )

从当前数据表中当前记录（当前光标位置）获取数据。当前记录行中各字段的值将赋给对应的力控变量，字段与力控变量的对应关系由绑定表BindTableName决定。如果当前记录集中有多条记录，检取的记录为当前记录，为了检取其他记录，可以通过SQLNext,SQLPrev重新定位当前记录，然后再调用SQLGet。

参数

返回值

备注

BindTableName字符串，使用的捆绑表名称。

捆绑数据表定义了DRAW变量和数据库表中的字段间的对应关系。WhereExpr 参数为空" ",时示例

将更新所有记录。

SQLGet("A");数据捆绑表为"A"， 捆绑表"A"必须在SQL管理器中事先建立。

SQLInsert

语法

说明

参数

SQLInsert(ConnectID,DataTableName,BindTableName)

使用捆绑数据表中指定的变量的当前值在数据表中插入一个新记录。

ConnectID 数据源标识，由SQLConnect调用返回。DataTableName 字符串，数据表名称。

428 第三部分 参考手册

BindTableName字符串，使用的捆绑表名称。

返回值

备注

示例

捆绑数据表定义了DRAW变量和数据库表中的字段间的对应关系。

SQLInsert(ConnectID,"Tab1", "A");参数ConnectID由SQLConnect调用得到。数据表名为"TAB1"。数据捆绑表为"A"， 捆绑表"A"必须在SQL管理器中事先建立。

SQLLast

语法

说明

参数

返回值

备注

示例

SQLLast()

选择由SQLSelect()选择的数据集中的最后一条记录

SQLLast()

SQLLastError

语法

说明

参数

返回值

备注

示例

SQLLastError(strErrorDesc)

取得SQL函数的最后一条错误信息。

strErrorDesc字符串，错误描述。

QLExecute(ErrorMes);

返回的错误信息在参数ErrorMes中。

SQLMoveTo

语法

说明

参数

返回值

备注

示例

SQLMoveTo(RowNum)

移动到当前记录集中指定的记录。

RowNum记录号。

SQLMoveTo(2);

第三章 脚本函数 429

SQLNex

语法

说明

参数

返回值

备注

示例

SQLNext()

选择由SQLSelect()选择的数据集中的下一条记录

SQLNext();

SQLPrev

语法

说明

参数

返回值

备注

示例

SQLPrev()

选择由SQLSelect()选择的数据集中的上一条记录

SQLPrev();

SQLRowCount

语法

说明

参数

返回值

备注

示例

SQLRowCount(RowCount)

SQLSelect()选择的数据表中记录总数

RowCount 整型，返回的记录数。

SQLRowCount(RowCount);返回的行数（记录个数）在RowCount中。

SQLSelDatSour

语法

说明

参数

返回值

备注

SQLSelDatSour(DataSourceDesc)

用于运行时动态得到数据源描述。执行该函数时会出现数据源选择框

DataSourceDesc 字符串变量，为返回的数据源描述。该描述可以用于SQLConnect。

返回值 1表示成功，0 失败。

430 第三部分 参考手册

示例

SQLSelDatSour(DataSource);

SQLSelect

语法

说明

SQLSelect(ConnectID,DataTableName,WhereExpr)

在数据库中选择符合条件的记录，该函数返回一数据集，可以使用如下函数SQLFirst()，SQLLast()，SQLNext()，SQLPrev()遍历该数据集中的记录。

参数 ConnectID 数据源标识，由SQLConnect调用返回。DataTableName 字符串，数据表名称。

WhereExpr字符串，选择表达式，只有符合该条返回值

备注

示例

件的记录被选中

1)SQLSelect(ConnectID,"Tab1","");参数ConnectID由SQLConnect调用得到。数据表名为"Tab1"。条件为空""表示选择所有记录。

2)SQLSelect (ConnectID,"Tab1","A = 50");

只选择字段A等于50的记录。

3)SQLSelect(ConnectID,"Tab1" ,"A > 50 ORDER

BY A DESC");选择字段A大于50的记录，并以降序排序。

SQLStatistics

语法

说明

参数

SQLStatistics(ConnectID,DataTableName, Flag,

Field, Value, WhereExpr)

在数据库中选择符合条件的记录的统计信息。

ConnectID 数据源标识，由SQLConnect调用返回。ataTableName 字符串，数据表名称。Field

字符串，欲求统计值的字段名称。Flag 统计标识符，含义如下：

0：平均值。

1：合计。

2：最小值。

第三章 脚本函数 431

3：最大值。

4：记录总数。

Value 浮点数，返回的统计信息。WhereExpr字符串，选择表达式，只有符合该条件的记录被选中示信息将被显示在选择框状态为假

的按钮上。

返回值

备注

示例

返回值 1表示成功，0 失败。

欲求统计值的字段必须为数值型值。

1)SQLStatistics(ConnectID,"Tab1",0,"A",RtnValue,"");参数ConnectID由SQLConnect调用得到。数据表名为"Tab1"。0:表示平均值。条件为空""表示选择所有记录。返回的平均值在变量RtnValue中。

2)SQLStatistics(ConnectID,"Tab1",1,"A",RtnValue," ");字段A的合计值。1:表示合计值。

返回的合计值在变量RtnValue中。

SQLUpdate

语法

说明

参数

SQLUpdate(ConnectID,DataTableName,BindTableName, WhereExpr )

使用捆绑数据表中指定的变量的当前值更新数据表中当前记录。

ConnectID 数据源标识，由SQLConnect调用返回。DataTableName 字符串，数据表名称。

BindTableName字符串，使用的捆绑表名称。

WhereExpr字符串，选择表达式，只有符合该条件的记录被更新。

返回值

备注

捆绑数据表定义了DRAW变量和数据库表中的字段间的对应关系。WhereExpr 参数为空" ",时示例

将更新所有记录。

1) SQLUpdate(ConnectID,"Tab1", "A","");

参数ConnectID由SQLConnect调用得到。数据表名为"Tab1"。数据捆绑表为"A"， 捆绑表"A"必须在SQL管理器中事先建立。条件为空""表示更新所有记录。

432 第三部分 参考手册

2) SQLUpdate(ConnectID,"Tab1", "A","A =

50");只更新字段A等于50的记录。

SQLUse

语法

说明

参数

返回值

备注

SQLUse(ConnectID,DataTableName)

在数据库中选择一数据集, 数据集是曾经用SQLSelect函数生成的.

ConnectID 数据源标识，由SQLConnect调用返回。DataTableName 字符串，数据表名称。

该函数改变当前使用的数据集。该函数返回后，所要的记录移动操作，都变成对该数据集的操示例

备注

作。

SQLUse(ConnectID,"Tab1");参数ConnectID由SQLConnect调用得到。数据表名为"Tab1"。

捆绑数据表定义了DRAW变量和数据库表中的字段间的对应关系。WhereExpr 参数为空" ",时将更新所有记录。

取得SQL函数的最后一条错误信息

说明

数据类型

备注

5、设备操作函数

InPortB

语法

说明

参数

返回值

备注

示例

InPortB(PortAddress,InData)

从指定端口读一字节

PortAddress 端口地址InData 从端口读取的数据

InPortB(97,InData);

第三章 脚本函数 433

InPortD

语法

说明

参数

返回值

备注

示例

InPortD(PortAddress,InData)

从指定端口读一个双字

PortAddress 端口地址InData 从端口读取的数据

以为力控 DRAW中的整数为有符号数，读出的数据高位为1将作为负数。

InPortD(97,InData);

InPortW

语法

说明

参数

返回值

备注

示例

InPortW(PortAddress,InData)

从指定端口读一个字

PortAddress 端口地址InData 从端口读取的数据

InPortW(97,InData);

OutPortB

语法

说明

参数

返回值

备注

示例

OutPortB(PortAddress,OutData)

向指定端口写一字节

PortAddress 端口地址InData 要写的数据

OutPortB(97,12345);

OutPortD

语法

说明

参数

返回值

备注

OutPortD(PortAddress,OutData)

向指定端口写一双字。

PortAddress 端口地址InData 要写的数据

数据源使用完后，应该使用该函数来断开连接。

434 第三部分 参考手册

示例

OutPortD(97,12345);

OutPortW

语法

说明

参数

返回值

备注

示例

OutPortW(PortAddress,OutData)

向指定端口写一个字

PortAddress 端口地址InData 要写的数据

OutPortW(97,12345);

6、字符串操作

AscToChar

语法

说明

参数

返回值

备注

示例

AscToChar (ASCII)

取得指定ASCII码所对应的字符。

ASCII：ASCII值，为数值型常量、变量或表达式。返回值：类型为字符串。

str = AscToChar (49) ;//str的值将为"1"

str = AscToChar (65) + AscToChar (66) +

AscToChar (67) +AscToChar (10) + AscToChar

(13);//str的值将为"ABC[LF][CR]", [LF]为换行符，[CR]为回车。

CharToAsc

语法

说明

参数

返回值

备注

示例

CharToAsc (String)

得到指定的字符串变量首字符的ASCII值。

String：字符串常量、变量或表达式。返回值：类型为整型，为String首字符的ASCII值。

n = CharToAsc ("1");//n的值将为49

n = CharToAsc ("ABC");//n的值将为65

第三章 脚本函数 435

IntToStr

语法

说明

参数

IntToStr(Number, Base)

将整数转化为字符串。

Number为要转化的数值型变量或表达式。

Base为进制数，整型常量或变量， 其取值范围为10, 16, 8。

返回值

备注

示例

为转化出的字符串

str = IntToStr (32, 10);//str结果为"32"

str = IntToStr (32, 16);//str结果为"20"

str = IntToStr (32, 8);//str结果为"40"。

RealToString

语法

说明

参数

RealToString(number,m,n)

将实型变量转化成字符串。

number:要转化的实型变量或表达式。

m:字符串长度。

n:小数位数

返回值

备注

示例

结果为字符串

RealToStr(123.456,5,2)//返回结果为123.45。

StrInStr

语法

说明

参数

StrInStr(StringSource, SearchFor, StartPos)

在字符串中查找匹配的子串位置

StringSource:搜索字符串。类型为字符串常量、变量或字符串表达式。SearchFor: 要搜索的子串。类型为字符串常量、变量或字符串表达式。StartPos:搜索开始位置索引，索引号从0开始。

返回值

备注

返回值为找到的第一个匹配子串的开始位置索引值。返回值为-1表示未找到。

子串大小写敏感。

436 第三部分 参考手册

示例 pos= StrInStr("ABCDEF", "CD", 0);//pos的结果将为2。

pos= StrInStr("ABCDEF", "cd", 0);//pos的结果将为-1。

StrLeft

语法

说明

参数

返回值

备注

示例

StrLen

语法

说明

参数

返回值

备注

示例

StrLower

语法

说明

参数

返回值

备注

示例

StrLeft (String, Count)

截取字符串左边Count个字符。

String:要截取的字符串。类型为字符串常量、变量或字符串表达式。Count:要截取的字符串长度，为整型。

为截取的字符串

str = StrLeft ("ABCDEF", 3); //str的结果将为"ABC"。

StrLen (String)

得到字符串的长度。

String:要操作的字符串。类型为字符串常量、变量或字符串表达式。返回值为字符串的长度，类型为整型。

len = StrLen ("ABCDEF"); //len的结果将为6。StrLower(str)

将字符串中所有的大写字符转换成小写字符。

str: 将要处理的字符串。

转换后的字符串

str = StrLower("ABC")str的值将为"abc"。

第三章 脚本函数 437

StrMid

语法

说明

参数

StrMid (String, First, Count)

截取由First开始Count个字符组成的字符串。

String:要截取的字符串。类型为字符串常量、变量或字符串表达式。First: 要截取的第一个字符的位置序号，序号从0开始。Count:要截取的字返回值

备注

示例

符串长度，为整型。

为截取的字符串

str = StrMid ("ABCDEF", 1, 3); //str的结果将为"BCD"。

StrRepeate

语法

说明

参数

返回值

备注

示例

StrRepeate(str, num)

重复复制字符串

str： 要替换的字符串。OldStr 要替换的字符串。NewStr: 替换字符串。

str = StrRepeate(" ", 5);//str为5个空格组成的字符串。

str = StrRepeate("ABC", 2);//str的值将为"ABCABC"。

StrReplace

语法

说明

参数

StrReplace(str, OldStr,NewStr)

子串替换，即替换字符串中与OldStr匹配的子串为新的子串NewStr。

String:要截取的字符串。类型为字符串常量、变量或字符串表达式。Count:要截取的字符串长度，为整型。

返回值

备注

示例

为截取的字符串

str = StrReplace("ABCDEF CDEF", "CD",

"XY");//str的值将为"ABXYEF XYEF";

438 第三部分 参考手册

StrRight

语法

说明

参数

StrRight (String, Count)

截取字符串右边Count个字符。

String:要截取的字符串。类型为字符串常量、变量或字符串表达式。Count:要截取的字符串长度，为整型。

为截取的字符串

str = StrRight ("ABCDEF", 3); //str的结果将为"DEF"。

返回值

备注

示例

StrToInt

语法

说明

参数

返回值

备注

示例

StrToInt(String)

将字符串转换成整型数。

String要转换的字符串。类型为字符串变量或常量。

为转化出的整型数

n = StrToInt("50");//n的值将为50；

StrToReal

语法

说明

参数

返回值

备注

示例

StrToReal(String)

字符串转化成实型数

String为字符型变量或表达式。

结果为实型数

StrToReal("123.456")//返回结果为123.456。

StrTrimLeft

语法

说明

参数

返回值

StrTrimLeft(String)

滤掉字符串中左边无用的空格

String：将处理的字符串。

返回值类型为字符串，为处理后的字符串。

第三章 脚本函数 439

备注

示例

str = StrTrimLeft(" ABC");//str的值将为"ABC"

StrTrimRight

语法

说明

参数

返回值

备注

示例

StrTrimRight(String)

滤掉字符串中右边无用的空格。

String：将处理的字符串。

返回值类型为字符串，为处理后的字符串。

str = StrTrimRight(" ABC ");//str的值将为" ABC"

StrUpper

语法

说明

参数

返回值

备注

示例

StrUpper(str)

将字符串中所有的小写字符转换成大写字符。

str将处理的字符串。

转换后的字符串。

str = StrUpper("abc") str的值将为"ABC"。

7、Windows控件

GridBind

语法

说明

GridBind(TableName)

捆绑数据表。将表格与某一数据表相绑定。绑定后，表格原有的内容将被清除，新的内容将参数

返回值

备注

与绑定的数据表中的内容一致。

1） 一般用一张空表来捆绑数据表，以便显示数据表的内容， 以及动态变化情况。

2）数据表只能被一个表格绑定。

3）绑定后的表格不能执行表格的所有函数。

示例 #nd("MyDataTable")

#tab1为表格对象名称（'#'为对象名标识）。

440 第三部分 参考手册

//MyDataTable为数据表名称。

GridDeleteLine

语法

说明

参数

返回值

备注

示例

GridDeleteLine（）

删除当前选中行。

GridDeleteRecord

语法

说明

参数

GridDeleteRecord(FileName, FilterNo)

删除记录。从指定的文件中删除符合条件"Condition"的记录。

FileName 字符串类型，文件路径名。可以是绝对路径，也可以 为相对路径。缺省路径名为应用目录下的UserDat子目录。

FilterNo 过滤条件号，为整型。只有符合该条返回值

备注

示例

件的记录，才会 被删除。

GridDeleteRecord ("MyTab",2)

GridGetColSum

语法

说明

参数

返回值

备注

示例

GridGetColSum(FiledName)

求某一列的合计值。

FiledName 列名称, 为字符串类型。

列的合计值。

sum = #tColSum("Weight")

GridGetRowCount

语法

说明

GridGetRowCount()

取得表格中的记录个数。

第三章 脚本函数 441

参数

返回值

备注

示例

记录个数为整型。

count = #tRowCount()

#tab1为表格对象名称（'#'为对象名标识）。

GridInsertLine

语法

说明

参数

GridInsertLine（BindTableName）

插入一行。

BindTableName：绑定表名称，为字符串类型。绑定表指定了插入行中每一列与力控变量的对应关系。对应的力控变量的当前值将作为插入行中对应列的值。如果绑定表名称为空，将插返回值

备注

示例

入一条空记录。

1) #tab1. GridInsertLine ("");

2) #tab1. GridInsertLine ("MyBindTab");

GridLoad

语法

说明

GridLoad (FileName,FilterNumber)

装载表格。从指定的文件中装载表格，文件中的记录将按条件"Condition"过滤。表中原有内容将被删除。

参数 FileName 字符串类型，文件路径名。可以是绝对路径，也可以为相对路径。缺省路径名为应用目录下的UserDat子目录。

FilterNumber 过滤条件序号，为整型。只有符合该条件的记录，才会被装载。过滤条件在表格属性中定义。

返回值

备注

如果表格中的列数少于文件中的列数，只显示表格中有的列。如果表格中有多余的列，其内容将为空。

442 第三部分 参考手册

示例

#tab1. GridLoad ("MyTab", 0)

GridOpen

语法

说明

GridOpen(nAccessMode, nDataSource)

打开表格, 在对远程数据表操作前，首先必须打开表格。以便建立远程连接。不执行该操作，数据源默认为本地。

nAccessMode为整型，为打开方式，0，表示允许读写，1表示只读。

nDataSour为整型，为数据源序号，-1表示数据表在本地。

返回值

备注

数据源序号与数据源定义列表中所看到的顺序相同，序号从0开始。其他数据表操作中所用到的文件名称，都在该数据源所指定的机器上。

示例

#en (0，-1); //以可"读写"方式打开表格。

参数

GridSave

语法

说明

参数

GridSave(FileName)

保存表格。将表格的数据保存到指定的文件中。

FileName 字符串类型，文件路径名。可以是绝对路径，也可以为相对路径。缺省路径名为应用目录下的UserDat子目录。

返回值

备注

示例

#tab1 GridSave ("MyTab2");#tab1为表格对象名称（'#'为对象名标识）。

ListAddItem

语法

说明

参数

返回值

备注

ListAddItem(Text)

添加一行文本。

Text为字符串，要添加的项目的文本串。

第三章 脚本函数 443

示例

#dItem ("abc")

ListClear

语法

说明

参数

返回值

备注

示例

ListClear()

删除列表框中所有项。删除后列表框中内容将为空。

#ear()

ListDeleteItem

语法

说明

参数

返回值

备注

示例

ListDeleteItem(index)

删除列表框中指定的项。

index为整型，成员项索引号，索引号从0开始。

#leteItem(0)

ListFindItem

语法

说明

参数

ListFindItem (Text)

查找与文本串Text相匹配的索引项

Text为字符串，要查找的文本串。

返回值为找到的项目的索引号，类型为整型。索引号从0开始，-1表示未找到

返回值

备注

示例

nFind = #Comb1. ListFindItem ("abc");

//nFind为整型变量

ListGetItemData

语法

说明

ListGetItemData(Index)

获取索引号为Index的成员项相关联的的数据

444 第三部分 参考手册

值。该数据值由ListSetItemData函数设置。

参数 index为整型，要获取的成员项索引号，索引号从0开始。返回值为索引号为Index的成员项的数据值，类型为整型。索引号从0开始。

返回值

备注

示例

nData = #Comb1. ListGetItemData (0);//

nData为整型变量。

ListGetSelection

语法

说明

参数

返回值

备注

示例

ListGetSelection()

获取当前选择项的索引号。

返回值为当前选择项的索引号，类型为整型。索引号从0 开始，-1表示无选择项。

nSelection=

#tSelection();//nSelection为整型变量。

ListLoad

语法

说明

ListLoad(FileName)

从指定的文件中装载列表框。该文件可能是上次用ListSave保存的文件。文件格式参见ListSave。

FileName为字符串，要装载的文件名称，缺省文件路径为应用目录下的UserData子目录。

返回值

备注

示例

#Comb1. ListLoad ("FileName1");

//Comb1为下拉框对象名称。

参数

ListSave(FileName)

语法

说明

ListSave(FileName)

将列表框中的内容存盘。存储的内容包括列表