PowerBuilder函数大全

PB函数大全

?Abs()

功能计算绝对值。

语法Abs ( n )

参数n：要得到绝对值的数值型变量或表达式返回值返回值的数据类型与n的数据类型相同，函数执行成功时返回n的绝对值。如果参数n的值为NULL，Abs()函数返回NULL。

?Ceiling()

功能返回大于n的最小整数。

语法Ceiling ( n )

参数n：数值型变量或表达式返回值返回值的数据类型与n的数据类型相同。函数执行成功

时返回大于n的最小整数。如果参数n的值为NULL，Ceiling()函数返回NULL。

?Cos()

功能计算余弦，其中参数以弧度为单位。

语法Cos ( n )

参数n：数值型变量或表达式返回值Double。函数执行成功时返回n的余弦。如果参数n的值为NULL，Cos()函数返回NULL。

?Exp()

功能计算e的n次方。

语法Exp ( n )

参数n：指定幂值返回值Double。函数执行成功时返回e（约等于2.71828）的n次方。如果参数n的值为NULL，Exp()函数返回NULL。

?Fact()

功能计算n的阶乘。

语法Fact ( n )

参数n：数值型变量或表达式返回值Double。函数执行成功时返回n的阶乘。如果参数n的值为NULL，Fact()函数返回NULL。

?Int()

功能得到小于等于n的最大整数。

语法Int ( n )

参数n：数值型变量或表达式返回值Integer。函数执行成功时返回小于等于n的最大整数。

如果n的值太小或太大，超过了整数的表示范围，则函数返回0。如果参数n的值为NULL，Int()函数返回NULL。

?Log()

功能计算n的自然对数。

语法Log ( n )

参数n：数值型变量或表达式，其值必须大于0返回值Double。函数执行成功时返回n的自然对数。如果n小于等于0，将导致运行错误。如果参数n的值为NULL，Log()函数返回NULL。?LogTen()

功能计算n的常用对数（以10为底）。

语法LogTen ( n )

参数n：数值型变量或表达式，其值必须大于0返回值Double。函数执行成功时返回n的常用对数。如果n小于等于0，将导致运行错误。如果参数n的值为NULL，LogTen()函数返回NULL。

?Max()

功能求两个数中的最大值。

语法Max ( x, y )

参数x：数值型变量或表达式，参加比较的第一个数y ：数值型变量或表达式，参加比较的第二个数返回值以x、y中数据类型更精确的数据类型作为该函数的返回值数据类型。函数执行成功时返回参数比较的两个数中更大者。如果任何参数的值为NULL，Max()函数返回

NULL。

?Min()

功能求两个数中的最小值。

语法Min( x, y )

参数x：数值型变量或表达式，参加比较的第一个数y ：数值型变量或表达式，参加比较的第二个数返回值以x、y中数据类型更精确的数据类型作为该函数的返回值数据类型。函数执行成功时返回参数比较的两个数中较小者。如果任何参数的值为NULL，Min()函数返回NULL。?Mod()

功能求余数。

语法Mod ( x, y )

参数x：数值型变量或表达式，被除数y ：数值型变量或表达式，除数返回值以x、y中数据类型更精确的数据类型作为该函数的返回值数据类型。函数执行成功时返回x除以y所得的余数。如果任何参数的值为NULL，Mod()函数返回NULL。

?Pi()

功能计算n与Pi(3.14159265358979323...)的乘积。

语法Pi ( n )

参数n：数值型变量或表达式返回值Double。函数执行成功时返回n与

Pi(3.14159265358979323...)的乘积。发生错误时返回-1。如果参数n的值为NULL，Pi()函

数返回NULL。

?Rand()

功能得到1与n之间的一个伪随机数。

语法Rand ( n )

参数n：数值型变量或表达式，指定要产生的伪随机数的上界。有效值在1到32,767之间返

回值与n的数据类型相同。函数执行成功时返回1与n之间的一个伪随机数，包括1和n在

内。如果参数n的值为NULL，Rand()函数返回NULL。

Randomize()

功能初始化伪随机数发生器，这样让应用程序每次使用不同的伪随机数序列。

语法Randomize ( n )

参数n：数值型变量或表达式，指定伪随机数生成器使用的起始值，不同的起始值可以生成不同的伪随机数序列。当n的值为0时，该函数把系统时钟作为伪随机数生成器的起始值，这样可以生成不可重复的伪随机数序列。当n的值不为0时，可以产生不同的伪随机数序列，但是，如果两次使用相同的伪随机数生成器起始值，那么两次生成的伪随机数序列相同。n的值在0到32,767之间返回值Integer。极少使用该函数的返回值。

Round()

功能将x四舍五入到n位。

语法Round ( x, n )参数x：要四舍五入的数值型数据n：整数类型，指定从哪个小数位上四舍五入x。有效值在0到18之间返回值Decimal。函数执行成功时返回将x四舍五入到小数点后第n位的数值，如果函数执行失败或任何参数的值为NULL，Round()函数返回NULL。

Sign()

功能确定n是整数、负数还是零。

语法Sign ( n )

参数n：数值型变量或表达式，指定要测试符号的值返回值Integer。当n大于0时返回1；当n小于0时返回-1；当n等于0时返回0。如果参数n的值为NULL，Sign()函数返回NULL。

Sin()

功能计算正弦，其中参数以弧度为单位。

语法Sin( n )

参数n：数值型变量或表达式返回值Double。函数执行成功时返回n的正弦。如果参数n的值为NULL，Sin()函数返回NULL。

Sqrt()

功能计算平方根。

语法Sqrt ( n )

参数n：数值型变量或表达式，指定要计算平方根的数据返回值Double。函数执行成功时返回n的平方根。如果n是负数，则执行该函数时引发运行错误。如果参数n的值为NULL，Sqrt()函数返回NULL。

Tan()

功能计算正切，其中参数以弧度为单位。

语法Tan( n )

参数n：数值型变量或表达式返回值Double。函数执行成功时返回n的正切。如果参数n的值为NULL，Tan()函数返回NULL。

Truncate()

功能截断数值到指定的小数位。

语法Truncate ( x, n )

参数x：要截断的数值型数据n：整数类型，指定从哪个小数位上截断x。有效值在0到18

之间返回值Decimal。函数执行成功时返回将x截断到小数点后第n位的数值，如果函数执

行失败或任何参数的值为NULL，Truncate()函数返回NULL。所谓截断就是舍弃指定位之后

的数值。

Asc()

功能得到字符串第一个字符的ASCII码整数值。

语法Asc ( string )

参数string：要得到第一个字符ASCII值的字符串返回值Integer。函数执行成功时返回string参数第一个字符的ASCII值，如果string参数的值为NULL，则Asc()函数返回NULL。

Char()

功能将字符串的第一个字符、Blob变量的第一个值、或一个整数转换成字符。

语法Char ( n )

参数n：字符串、Blob变量或整数，也可以是包含上述类型数据的Any类型变量返回值Char。返回参数n 的第一个字符。如果n参数的值为NULL，则Char()函数返回NULL。

Dec()

功能将字符串或Blob值转换成Decimal类型的值。

语法Dec ( stringorblob )

参数stringorblob：string类型变量或Blob类型变量。Blob类型变量时，把该变量第一个值转换为Decimal 类型的值，其余部分被忽略。stringorblob参数也可以是包含上述类型数据的Any类型变量返回值Decimal。函数执行成功时返回相应的Decimal类型值。如果stringorblob参数中的值不是有效的PowerScript数字或数据类型不兼容，那么Dec()函数返回0。如果stringorblob参数的值为NULL，则Dec()函数返回NULL。Double()

功能将字符串或Blob值转换成Double类型的值。

语法Double(stringorblob)

参数stringorblob：string类型变量或Blob类型变量。Blob类型变量时，把该变量第一个值转换为Double 类型的值，其余部分被忽略。stringorblob参数也可以是包含上述类型数据的Any类型变量返回值Double。函数执行成功时返回相应的Double类型值。如果stringorblob参数中的值不是有效的PowerScript数字或数据类型不兼容，那么Double()函数返回0。如果stringorblob参数的值为NULL，则Double()函数返回NULL。

Integer()

功能将字符串或Blob值转换成Integer类型的值。

语法Integer ( stringorblob )

参数stringorblob：string类型变量或Blob类型变量。Blob类型变量时，把该变量第一个值转换为Integer 类型的值，其余部分被忽略。stringorblob参数也可以是包含上述类型数据的Any类型变量返回值Integer。函数执行成功时返回相应的Integer类型值。如果stringorblob参数中的值不是有效的PowerScript数字或数据类型不兼容，那么Integer()函数返回0。如果stringorblob参数的值为NULL，则Integer()函数返回NULL。

Long()

功能将其它类型的数据转换为Long类型的值。该函数有两种语法格式：

语法一、将两个无符号整数组合成一个长整数值；

语法二、将字符串或Blob值转换成Long类型的值。下面分别予以介绍：

语法一、将两个无符号整数组合成一个长整数值

语法Long ( lowword, highword )

参数lowword：UnsignedInteger类型，指定长整数中的低位值highword：UnsignedInteger类型，指定长

整数中的高位值返回值Long。函数执行成功时返回由低位值和高位值组合后的长整数值，发生错误时返回-1。如果任何参数的值为NULL，则Long()函数返回NULL。

语法二、将字符串或Blob值转换成Long类型的值

语法Long ( stringorblob )

参数stringorblob：string类型变量或Blob类型变量。Blob类型变量时，把该变量第一个值转换为Long

类型的值，其余部分被忽略。stringorblob参数也可以是包含上述类型数据的Any类型变量返回值Long。函数执行成功时返回相应的Long类型值。如果stringorblob参数中的值不是有效的PowerScript数字或数据类型不兼容，那么Long()函数返回0。如果stringorblob参数的值为NULL，则Long()函数返回NULL。Real()

功能将字符串或Blob值转换成Real类型的值。

语法Real ( stringorblob )

参数stringorblob：string类型变量或Blob类型变量。当该参数是Blob类型变量时，把该变量第一个值转换为Real类型的值，其余部分被忽略。stringorblob参数也可以是包含上述类型数据的Any类型变量返回值Real。函数执行成功时返回相应的Real类型值。如果stringorblob参数中的值不是有效的PowerScript 数字或数据类型不兼容，那么Real()函数返回0。如果stringorblob参数的值为NULL,则Real()函数返回NULL。

Date()功能将其它类型的数据转换为Date类型的数据。该函数有三种语法格式：

语法一、将DateTime类型或第一个值是DateTime或Date的Blob值转换成Date类型的值；

语法二、将其值是个有效日期的字符串转换成Date类型的值；

语法三、将三个整数组合成一个日期。下面分别予以介绍：

语法一、将DateTime类型或第一个值是DateTime或Date的Blob值转换成Date类型的值

语法Date ( datetime )

参数datetime：DateTime类型的值或第一个值是DateTime或Date的Blob类型的值。当该参数是Blob 类型变量时，把该变量第一个值转换为Date类型的值，其余部分被忽略。datetime参数也可以是包含上述类型数据的Any类型变量返回值Date。函数执行成功时返回相应的Date类型值。如果datetime参数中的值不是有效的PowerScript日期或数据类型不兼容，那么Date()函数返回1900-01-01。如果datetime

参数的值为NULL，则Date()函数返回NULL。

语法二、将其值是个有效日期的字符串转换成Date类型的值

语法Date ( string )

参数string：string类型，其值包括一个有效的以字符串形式表示的日期（比如January 1, 1998或12-31-99），string参数也可以是包含字符串类型数据的Any类型变量返回值Date。函数执行成功时返回相应的Date 类型值。如果string参数中的值不是有效的PowerScript日期或数据类型不兼容，那么Date()函数返回

1900-01-01。如果string参数的值为NULL，则Date()函数返回NULL。

语法三、将三个表示年、月、日的整数组合成一个日期

语法Date ( year, month, day )

参数year：integer类型，指定日期中的年份，用四位数字表示，从0到9999month：integer类型，指定日期中的月份，用一位或两位数字表示，从1到12day：integer类型，指定日期中的号数，用一位或两位数字表示，从1到31返回值Date。函数执行成功时返回由year、month、day三个参数确定的日期。如果这三个参数中任何一个参数使用了无效值（比如月份指定为14），则Date()函数返回1900-01-01。如果任何参数的值为NULL，则Date()函数返回NULL。

DateTime()

功能将其它类型的数据转换为DateTime类型的数据。该函数有两种语法格式：语法一、把日期和时间值组合成DateTime类型的值；语法二、将Blob类型的值转换成DateTime类型的值。下面分别予以介绍：语法一、把日期和时间值组合成DateTime类型的值

语法DateTime ( date {, time } )

参数date：Date类型的日期值time：可选参数，Time类型的时间值，省略该参数时，PowerBuilder把时间设置为午夜（00:00:00.000000）。当指定该参数时，可以仅仅指定小时值返回值DateTime。函数执行成功时返回日期和时间组合而成的DateTime类型的值。如果任何参数的值为NULL，则DateTime()函数返回NULL。

语法二、将Blob类型的值转换成DateTime类型的值

语法DateTime ( blob )

参数blob：Blob类型变量，把该变量第一个值转换为DateTime类型的值，其余部分被忽略。blob参数也可以是包含blob类型数据的Any类型变量返回值DateTime。函数执行成功时返回相应的DateTime类型值。如果blob参数的值为NULL,则DateTime()函数返回NULL。

IsDate()

功能检测指定的字符串是否包含有效的日期。

语法IsDate ( datevalue )

参数datevalue：string类型，指定要检测的字符串返回值Boolean。如果datevalue包含了有效的日期，则IsDate()函数返回TRUE，否则返回FALSE。如果datevalue参数的值为NULL，则IsDate()函数返回NULL。

IsNull()

功能测试变量或表达式的值是否是NULL。

语法IsNull ( any )

参数any：要测试的变量或表达式返回值Boolean：如果any的值为NULL，函数返回TRUE，否则函数返回FALSE。

IsNumber()

功能测试字符串是否是有效的数值。

语法IsNumber ( string )

参数string：string类型，要测试的字符串返回值Boolean：如果string的值为有效的PowerScript数字，函数返回TRUE，否则函数返回FALSE。如果string参数的值为NULL，则IsNumber()函数返回NULL。IsTime()

功能测试字符串的值是否是有效的时间。

语法IsTime ( timevalue )

参数timevalue：string类型，要测试的字符串返回值Boolean：如果timevalue的值为有效的时间，函数返回TRUE，否则函数返回FALSE。如果timevalue 参数的值为NULL，则IsTime()函数返回NULL。String()

功能按指定格式将数据转换成字符串。String()可以把Date、DateTime、数值类型、Time、String类型的数据转换成指定格式的字符串。

语法String(data,{format})

参数data：指定要转换格式的数据，其数据类型可以是Date、DateTime、数值类型、Time、String，也可以是包含上述类型数据的Any类型变量format：可选项，string类型，其值指定数据格式。如果data参数的类型为string，则必须指定format参数返回值String。函数执行成功时返回以字符串方式表示的指定数据，如果data参数的数据类型与format参数指定的格式不匹配、format参数指定的格式无效、或data 参数不是前面提到的适宜数据类型时，String()函数返回空字符串（""）。

用法:

format是个用掩码表示的字符串，对data参数为数值类型的情况来说，格式为：正数格式；负数格式；零的显示格式；空的显示格式除第一部分必须提供外，其它部分可以省略。数值型显示格式中使用两个掩码字符：#和0，其中，使用#代表0~9之间的任意数字，0代表每个零都要显示。另外，货币符号（$或￥）、百分号（%）、小数点（.）、逗号（，）等字符也可以出现在格式字符串中，但是，除小数点（.）、逗号（，）能够出现在格式字符#和0之间外，其它字符只能放置在格式串的前面或后面，例如，###,###$###是个错误的格式串，￥###,###,###是个正确的格式串。省略format参数时，String()函数使用PowerBuilder 缺省格式。注意，如果显示格式有多个部分，各部分之间的分号（；）不能省略。其它字符也可以出现在显示格式字符串中（只能放在格式串的开头和末尾），但它们没有特殊意义，系统只是照原样显示。例如，用显示格式字符串“收入##”格式化数值12时，显示结果为“收入12”。对data参数为字符串（String）类型的情况来说，format参数的语法格式为：正常字符串格式；空值时格式在“正常字符串格式”中，@代表字

符串中的任意字符，除此之外的任何字符照原样显示，例如，如果定义了下面的格式：（@@）

@@@@-@@@@则字符串0166767593显示为：（01）6676-7593对data参数为日期（Date）类型的情况来说，format参数的语法格式为：正常日期格式；日期为空值时的格式日期格式中格式字符意义如下：d棗开头不带0的日数（如8）dd棗开头带0的日数（如08）ddd棗星期的英文缩写（如Mon、Tue）dddd 棗星期的英文全称（如Monday、Tuesday）m棗开头不带0的月份（如8）mm棗开头带0的月份（如08）mmm棗月份的英文缩写（如Jan、Feb）mmmm棗月份的英文全称（如January、February）yy棗两位数字表示的年份（如97）yyyy棗四位数字表示的年份（如1997）另外，还可以使用下面的关键字作为日期的显示格式：[General] Windows系统中定义的短日期格式[LongDate] Windows系统中定义的长日期格式[ShortDate] Windows系统中定义的短日期格式对data参数为时间（Time）类型的情况来说，语法格式为：正常时间格式；时间为空值时的格式时间格式中格式字符意义如下：h开头不带0的小时（比如6）hh棗开头带0的小时（比如06）m棗开头不带0的分钟（比如6）mm棗开头带0的分钟（比如06）s 棗开头不带0的秒（比如6）ss棗开头带0的秒（比如06）f棗开头不带0的微秒，可以指定1~6个f，每个f代表一部分微秒AM/PM棗用AM/PM显示上、下午时间，12小时制am/pm棗用am/pm显示上、下午时间，12小时制A/P棗用A/P显示上、下午时间，12小时制a/p棗用a/p显示上、下午时间，12小时制另外，显示格式中还可以使用关键字[Time]，它表示按当前Windows系统定义的格式显示时间。对data 参数为日期时间（DateTime）类型的情况来说，语法格式为：正常日期时间格式；日期时间为空值时的格式日期时间类型使用的掩码就是把日期掩码和时间掩码结合起来即可。

Time()

功能把其它类型的数据转换为Time类型的值。该函数有三种语法格式：语法一、将DateTime

类型或第一个值是DateTime或Time的Blob值转换成Time类型的值；语法二、将其值是个

有效时间的字符串转换成Time类型的值；语法三、将表示时、分、秒、以及微秒的整数组合

成一个时间值。下面分别予以介绍：

语法一、将DateTime类型或第一个值是DateTime或Time的Blob值转换成Time类型的值

语法Time ( datetime )

参数datetime：DateTime类型的值或第一个值是DateTime或Time的Blob类型的值。当该

参数是Blob类型变量时，把该变量第一个值转换为Time类型的值，其余部分被忽略。datetime

参数也可以是包含上述类型数据的Any类型变量返回值Time。函数执行成功时返回相应的

Time类型值。如果datetime参数中的值不是有效的PowerScript时间或数据类型不兼容，那

么Time()函数返回00:00:00.000000。如果datetime参数的值为NULL，则Time()函数返回

NULL。

语法二、将其值是个有效时间的字符串转换成Time类型的值

语法Time ( string )

参数string：string类型，其值包括一个有效的以字符串形式表示的时间（比如9am或10:25），

string参数也可以是包含时间类型数据的Any类型变量返回值Time。函数执行成功时返回相

应的Time类型值。如果string参数中的值不是有效的PowerScript时间或数据类型不兼容，

那么Time()函数返回00:00:00.000000。如果string参数的值为NULL，则Time()函数返回

NULL。

语法三、将表示时、分、秒、以及微秒的整数组合成一个时间值

语法Time ( hour, minute, second {, microsecond } )

参数hour：integer类型，指定时间中的小时，从0到23minute：integer类型，指定时间中

的分钟，从0到59second：integer类型，指定时间中的秒，从0到59microsecond：integer

类型，可选项，指定时间中的微秒，从0到32767返回值Time。函数执行成功时返回由hour、

minute、second、microsecond 四个参数确定的时间。如果这四个参数中任何一个参数使用

了无效值（比如小时指定为44），则Time()函数返回NULL。

Beep()

功能响铃n次（n超过10时只响10次）。

语法Beep ( n )

参数n：数值类型，指定需要的响铃次数。如果n的值大于10，那么计算机只响铃10次返回值Integer。函数执行成功时返回1，发生错误时返回-1。如果参数n的值为NULL，Beep()函数返回NULL。ClassName()

功能确定指定变量的类（数据类型）。

语法ClassName(variable)

参数variable：指定要确定其数据类型的变量返回值String。函数执行成功时返回指定变量的数据类型，发生错误时返回空字符串。如果参数variable的值为NULL，ClassName()函数返回NULL。用法需要注意的是，ClassName()函数不能确定枚举类型变量的类型，此时，ClassName()函数返回空字符串（""）。DebugBreak()

功能暂停程序执行，打开调试器，进入调试模式。

语法DebugBreak ( )

返回值无用法DebugBreak()函数可以帮助你调试应用程序。如果你希望应用程序执行某条语句后暂停执行，然后进入调试模式，那么可以在该语句后面放上DebugBreak()函数，应用程序执行到DebugBreak()

函数后，打开Debug（调试）窗口，并在其中显示当前上下文信息。这种方式实现了应用程序在PowerBuilder 开发环境中的即时调试功能。

IntHigh()

功能得到Long型值的高位字。

语法IntHigh ( long )

参数long：long型值或变量返回值Integer。函数执行成功时返回参数long的高位字，发生错误时返回-1。如果参数long的值为NULL，IntHigh()函数返回NULL。用法IntHigh()函数通常用于分解外部C或C++语言函数的返回值和Windows消息。

IntLow()

功能得到Long型值的低位字。

语法IntLow ( long )

参数long：long型值或变量返回值Integer。函数执行成功时返回参数long的低位字，发生错误时返回-1。如果参数long的值为NULL，IntLow()函数返回NULL。用法IntLow()函数通常用于分解外部C或C++语言函数的返回值和Windows消息。示例请参看IntHigh()函数。

IsValid()

功能检查对象变量是否已经实例化，即实例变量的值是否是个有效的对象句柄。

语法IsValid ( objectname )

参数objectname：要检测的对象名返回值Boolean。如果指定对象已经创建了对象实例，那么IsValid()函数返回TRUE，否则返回FALSE。如果参数objectname的值为NULL，IsValid()函数返回NULL。KeyDown()

功能检查用户是否按了键盘上指定的键。

语法KeyDown ( keycode )

参数keycode：KeyCode枚举类型或integer类型，指明要检测的按键或某个键的ASCII值返回值Boolean。如果用户按了keycode参数指定的按键，函数返回TRUE，否则返回FALSE。如果参数keycode的值为NULL，KeyDown()函数返回NULL。用法KeyDown()函数通常在某个事件的事件处理程序中调用，它并不指明用户键入了哪个字符，而是说明当前事件（即事件处理程序中调用KeyDown()函数的事件）发生时用户正按着哪个按键。一般来说，应用程序在窗口的Key事件或控件的按键事件中调用KeyDown()函数，以检测用户是否按了某个特殊键。对控件来说，PowerBuilder没有定义预定义的Key事件，这也没有关系，如果在控件得到焦点后希望应用程序检测用户的按键，只要对该控件定义一个用户事件，并把

pbm_keydown （其它控件）或pbm_dwnkey（数据窗口控件）映射到该用户事件上即可。MessageBox()

功能显示一个消息对话框。

语法MessageBox(title,text{,icon{,button{,default}}})

参数title：string类型，指定消息对话框的标题text：指定消息对话框中显示的消息，该参数可以是数值数据类型、字符串或boolean值icon：Icon枚举类型，可选项，指定要在该对话框左侧显示的图标button：Button枚举类型，可选项，指定显示在该对话框底部的按钮default：数值型，可选项，指定作为缺省按钮的按钮编号，按钮编号自左向右依次计数，缺省值为1，如果该参数指定的编号超过了显示的按钮个数，那么MessageBox()函数将使用缺省值返回值Integer。函数执行成功时返回用户选择的按钮编号（例如1、2、3等），发生错误时返回-1。如果任何参数的值为NULL，MessageBox()函数返回NULL。

用法当你的应用程序需要显示一段简短信息（比如显示出错、警告等信息）时，没有必要自己从头创建窗口、安排控件，使用MessageBox()函数既简单又方便。用户只有响应该窗口后，程序才能继续运行下去。MessageBox()函数的icon参数指定显示在窗口中的图标，它是枚举类型，可能取值为：取值图标Information! StopSign! Exclamation! Question! None! 无图标其中Information!是Icon参数的缺省值。Button参数指定在窗口中显示哪些按钮，有效取值为：取值中文Windows 95下显示OK!“确定”按钮OKCancel!“确定”、“取消”按钮YesNo!“是”、“否”按钮YesNoCancel!“是”、“否”、“取消”按钮RetryCancel!“重试”、“取消”按钮AbortRetryIgnore!“终止”、“重试”、“忽略”按钮

PixelsToUnits()

功能将像素值转换为PowerBuilder单位PBU。

语法PixelsToUnits ( pixels, type )

参数pixels：integer类型，指定要转换为PowerBuilder单位的像素数type：ConvertType枚举类型，指定按哪个方向进行转换。有效取值为：XPixelsToUnits! - 按水平方向转换像素；YPixelsToUnits! - 按垂直方向转换像素返回值Integer。函数执行成功时返回pixels参数指定像素数按指定方向转换成的PowerBuilder单位数，发生错误时返回-1。如果任何参数的值为NULL，PixelsToUnits()函数返回NULL。用法窗口中水平方向和垂直方向相同的像素数表示的距离并不相同。如果你使用水平方向和垂直方向相同的像素数绘制一个方框，那么你会看到，该方框不是正方形而是个矩形，而使用PBU计量的相同单位数将绘出正方形。因此，在进行单位转换时，需要指明按那么方向进行转换。

PopulateError()

功能以应用程序定制的错误号和错误信息填充Error对象，该函数不触发应用对象的SystemError事件。语法PopulateError ( number, text )

参数number：integer类型，指定要保存到Error对象number属性中的值text：string类型，指定要保存到Error对象text属性中的值返回值Integer。函数执行成功时返回1，发生错误时返回-1。

用法当应用程序需要根据变量的当前取值来定制Error对象时，可以使用PopulateError()函数来填充Error 对象的number和text属性，同时该函数根据上下文自动填充Error对象的其它属性。定制了Error对象后，应用程序可以使用不带参数的SignalError()函数触发应用对象的SystemError事件。这样，在SystemError

事件的事件处理程序中可以编写处理定制错误和系统错误的通用代码。如果应用程序没有对SystemError 事件编写事件处理程序，那么SignalError()函数什么也不做。

RGB()

功能将代表红、绿、蓝三原色的三个整数组合成一个表示颜色的长整数。

语法RGB ( red, green, blue )

参数red：integer类型，指定颜色中的红色分量强度，有效值在0到255之间green：integer类型，指定颜色中的绿色分量强度，有效值在0到255之间blue：integer类型，指定颜色中的蓝色分量强度，有效值在0到255之间返回值Long。函数执行成功时返回由指定分量确定的颜色，用长整数表示。发生错误时返回-1。如果任何参数的值为NULL，RGB()函数返回NULL。

用法RGB()函数使用下述公式计算表示颜色的长整数：65536 * Blue+ 256 * Green+ Red其中，Blue代表蓝色分量，Green代表绿色分量，Red代表红色分量。各分量中，数值越小，亮度越低，数值越大，亮度越高。例如，RGB ( 0, 0, 0 )为黑色（亮度最低），RGB ( 255, 255,255 )为白色（亮度最高）。

SetNull()

功能将指定变量的值设置为NULL。这里的变量可以是除数组、结构、自动实例化对象之外的任何数据类型。

语法SetNull ( anyvariable )

参数anyvariable：要将其值设置为NULL的变量返回值Integer。函数执行成功时返回1，发生错误时返回-1。如果任何参数的值为NULL，SetNull()函数返回NULL。用法PowerBuilder应用程序在说明变量时，并不自动地将其初值设置为NULL，而是根据类型的不同而设置不同的初值，比如，数值类型的变量自动初始化为0，字符串型变量自动初始化为空字符串（""）。因此，如果需要将某个变量的值设置为NULL，就需要使用SetNull()函数来完成任务了。一般来说，NULL值往往应用在数据库值未确定的列上。SetPointer()

功能设置鼠标指针。

语法SetPointer ( type )

参数type：Pointer枚举类型，指明要设置为哪种鼠标指针返回值Pointer。返回更换前的鼠标指针，以便于应用程序恢复原有指针。如果参数type的值为NULL，SetPointer()函数返回NULL。用法type参数的可能取值为：Arrow!、Cross!、Beam!、HourGlass!、SizeNS!、SizeNESW!、SizeWE!、SizeNWSE!、UpArrow!。

SignalError()

功能以编程方式触发应用对象的SystemError事件。

语法SignalError ( { number }, { text } )

参数number：integer类型，可选项，指定出错编号，该编号将保存到Error对象的number属性中text：

string类型，可选项，指定出错信息，该信息将保存到Error对象的text属性中返回值Integer。函数执行成功时返回1，发生错误时返回-1。用法SignalError()函数通常用于测试应用程序的出错处理代码，它以人工方式产生错误，以此模拟应用程序运行过程中可能出现的错误。我们知道，应用程序本身产生错误的条件往往不容易在测试时遇到。当应用程序使用PopulateError()函数定制了Error对象后，可以以不带参数的方式调用SignalError()函数，由该函数触发应用对象的SystemError事件。如果我们在调用SignalError()函数时指定了参数number和text，那么SignalError()函数将根据上下文填充Error对象的所有属性，然后触发应用对象的SystemError事件。如果应用程序没有对应用对象的SystemError事件编写事件处理程序，那么SignalError()函数什么也不做。

UnitsToPixels()

功能将PowerBuilder单位（PBU）转换为像素。

语法UnitsToPixels ( units, type )

参数units：integer类型，指定要转换为像素的PowerBuilder单位（PBU）数type：ConvertType

枚举类型，指定按哪个方向进行转换。有效取值为：XUnitsToPixels! - 按水平方向转换PBU；

YUnitsToPixels! - 按垂直方向转换PBU返回值Integer。函数执行成功时返回units参数指定

PBU数按指定方向转换成的像素数，发生错误时返回-1。如果任何参数的值为NULL，

UnitsToPixels()函数返回NULL。用法窗口中水平方向和垂直方向相同的像素数表示的距离并

不相同。如果你使用水平方向和垂直方向相同的像素数绘制一个方框，那么你会看到，该方

框不是正方形而是个矩形，而使用PBU计量的相同单位数将绘出正方形。因此，在进行单位

转换时，需要指明按那么方向进行转换。

Blob()

Blob()功能将字符串转换成Blob类型数据。

语法Blob ( text )

参数text：string类型，指定要转换的数据返回值Blob。函数执行成功时返回转换后的Blob类型数据；如果text参数的值为NULL，则Blob()函数返回NULL。

BlobEdit()

功能将任意类型的数据插入到Blob类型变量的指定位置。

语法BlobEdit ( blobvariable, n, data )

参数blobvariable：Blob类型的已初始化变量，将向该变量中插入数据n：指定插入位置，有效值在1到4,294,967,295之间data：要插入到Blob类型变量中的数据，其数据类型可以是任何有效的PowerBuilder

数据类型返回值Unsigned long。函数执行成功时返回下次可以插入数据的位置；如果blobvariable变量中空间不够或任何参数的值为NULL，则BlobEdit()函数返回NULL。

BlobMid()

功能从Blob变量中提取出一段数据。提取之后，原Blob变量内容不变。

语法BlobMid ( data, n {, length } )

参数data：Blob类型的数据n：指定要提取数据的起始位置，有效值在1到4,294,967,295之间length：可选项，指定要提取数据的长度，以字节为单位，有效值在1到4,294,967,295之间。缺省时提取从指定位置n到末尾的所有数据返回值Blob。函数执行成功时返回指定字节数的数据。如果n的值大于data的字节数，函数返回空。如果n与length的和超过了data数据的字节数，那么BlobMid()函数返回剩下的数据，数据长度将小于参数length的值。如果任何参数的值为NULL，则BlobMid()函数返回NULL。

?Len()

功能得到Blob类型变量的数据长度，以字节为单位。

语法Len ( blob )

参数blob：Blob类型变量返回值Long。函数执行成功时返回blob变量的长度，发生错误时

返回-1。如果任何参数的值为NULL，则Len()函数返回NULL。用法如果在说明Blob类型的

变量时指定了变量长度，那么对该变量来说，Len()函数得到的就是这个指定的长度。如果在

变量说明时未指定变量长度，那么PowerBuilder在赋值时调整长度，未赋值Blob类型变量

的长度为0。

?String()

功能将Blob类型变量的值转换成字符串类型。如果Blob类型变量的值不是文本型数据，

String()函数将其值解释成字符。

语法String ( blob )

参数blob：要对其值进行类型转换的Blob类型变量返回值String。函数执行成功时返回转换

后的数据，失败时返回空字符串（""）。如果blob变量中包含的数据不是字符串类型的数据，

那么String()函数尽可能把数据解释为字符，并返回字符串类型数据。如果blob参数的值为

NULL，则String()函数返回NULL。

Clipboard()

功能提取或替换Windows系统剪贴板的文本内容。

语法Clipboard ( { string } )

参数string：string类型，可选项，指定要复制到系统剪贴板上的文本。如果剪贴板上已有内容的话，该文

本将取代剪贴板的当前内容返回值String。函数执行成功时，如果剪贴板上包含文本数据，那么函数返回剪贴板的当前内容；如果剪贴板上包含非文本数据（比如位图）或不包含任何数据，那么函数返回空字符串（""）。如果string参数的值为NULL，Clipboard()函数返回NULL。用法无论是否指定string参数，Clipboard()都将返回剪贴板的当前内容。当指定string参数时，剪贴板的原有内容被string参数的值取代；省略string 参数时，仅仅得到剪贴板的内容。

CommandParm()

功能得到应用程序运行时指定的命令参数。

语法CommandParm ( )

返回值String。函数执行成功时返回应用程序运行时的命令行参数，函数执行错误或没有命令行参数时函数返回空字符串（""）。用法命令行参数是应用程序启动时跟在应用程序名称后面的任何参数，比如，在运行窗口中输入了下述命令：MyAppl C:/EMPLOYEE/EMPLIST.TXT那么MyAppl应用程序中使用CommandParm()函数得到的命令行参数为：C:/EMPLOYEE/EMPLIST.TXT当应用程序的命令行中包含几个参数时，CommandParm()函数作为一个字符串返回所有参数。利用字符串操作函数可以分离各参数。在应用对象的Open事件中没有必要执行CommandParm()函数。此时，Open事件的argument参数中包含了命令行参数。

DoScript()

功能执行AppleScript程序段，该函数只在Macintosh平台上有效。

语法DoScript ( script, result )

参数script：string类型，指定要运行的程序段（script）result：string类型，由AppleScript程序段返回的结果信息或出错信息返回值Integer。返回由AppleScript返回的结果代码。如果任何参数的值为NULL，DoScript()函数返回NULL。

GetApplication()

功能得到当前应用对象的句柄，这样你可以查询或设置应用对象的属性（通常用于编写通用代码）。

语法GetApplication ( )

返回值Application。返回当前应用对象的句柄。

GetEnvironment()

功能得到操作系统、处理器、屏幕显示等与系统相关的信息。

语法GetEnvironment ( environmentinfo )

参数environmentinfo：Environment对象名，用于保存系统环境信息返回值Integer。函数执行成功时返回1，发生错误时返回-1。如果参数environmentinfo的值为NULL，GetEnvironment()函数返回NULL。用法当开发交叉平台项目时，利用GetEnvironment()函数，应用程序能够得到当前运行的操作系统、使用的CPU

类型、操作系统的版本、屏幕的大小以及颜色数等信息，这些信息的具体表示请参阅本书环境对象（Environment Object）的介绍。

GetFocus()

功能确定当前焦点位于哪个控件上。

语法GetFocus ( )

返回值GraphicObject。函数执行成功时返回当前得到焦点控件的引用，发生错误时返回无效引用。用法应用程序利用IsValid()函数可以检测GetFocus()是否返回有效的控件引用。同时，使用TypeOf()函数可以确定控件的类型。

Post()

功能将指定消息加入到某个窗口的消息队列中，这个窗口既可以是PowerBuilder应用的窗口，也可以是其它应用的窗口。

语法Post( handle, messageno, word, long )

参数handle：long类型，指定窗口的系统句柄，将向该窗口邮寄消息messageno：UnsignedInteger类型，指定要邮寄的消息号word：long类型，指定与消息一起邮寄的word类参数值。如果messageno参数指定的消息不使用该参数，那么将这个参数的值设置为0long：long类型或string，指定与消息一起邮寄的long 型参数值或字符串返回值Boolean。如果任何参数的值为NULL，Post()函数返回NULL。

用法Post()函数用于向窗口发送非PowerBuilder预定义事件的消息，这个窗口可以是PowerBuilder应用的窗口，也可以是其它应用的窗口。Post()函数把发送的消息放置在指定窗口消息队列的尾部，然后返回到应用程序中，它并不等待相应事件事件处理程序的执行。这一点与Send()函数不同，Send()函数直接触发指定窗口相应的事件，执行事件处理程序后返回到调用应用中。因此，我们说Post()函数采用的是异步方式，Send()函数采用的是同步方式。Post()函数的参数handle指定接收消息的窗口句柄，对PowerBuilder 窗口来说，使用Handle()函数可以得到该句柄。对其它应用程序的窗口来说，可以调用系统API函数查找窗口并得到相应窗口的句柄。如果应用程序要邮寄PowerBuilder定义事件（包括预定义事件和用户定义事件），那么使用PostEvent()函数既简单有方便。当应用程序在long参数位置指定一个字符串时，Post()函数复制一个该字符串的副本，然后将副本的地址传送给指定窗口。

ProfileInt()

功能从初始化文件（.ini）中读取整型设置值。

语法ProfileInt ( filename, section, key, default )

参数filename：string类型，指定初始化文件的名称，可以包括路径，省略路径时，该函数按操作系统的标准路径搜索指定文件section：string类型，指定要得到的值所在的节（Section）key：string类型，指定要得到的值的名称，不用区分大小写default：integer类型，当指定的文件、节名、项目名不存在或不能转换为整数时，函数返回该参数指定的值返回值Integer。函数执行成功时，在指定的文件、节名、项目名

不存在任何错误的情况下，函数返回相应项的值；如果指定的文件、节名、项目名不存在或不能转换为整数时，函数返回default参数指定的缺省值。如果发生错误，函数返回-1。如果任何参数的值为NULL，ProfileInt()函数返回NULL。

ProfileString()

功能从初始化文件（.ini）中读取字符串型设置值。

语法ProfileString ( filename, section, key, default )

参数filename：string类型，指定初始化文件的名称，可以包括路径，省略路径时，该函数按操作系统的标准路径搜索指定文件section：string类型，指定要得到的值所在的节（Section）key：string类型，指定要得到的值的名称，不用区分大小写default：string类型，当指定的文件、节名、项目名不存在时，函数返回该参数指定的值返回值String。函数执行成功时，在指定的文件、节名、项目名不存在任何错误的情况下，函数返回相应项的值；如果指定的文件、节名、项目名不存在，函数返回default参数指定的缺省值。如果发生错误，函数返回空字符串。如果任何参数的值为NULL，ProfileString()函数返回NULL。Restart()

功能停止所有程序段的执行、关闭所有窗口、提交事务、断开与数据库的连接，然后重新启动应用程序。语法Restart()

返回值Integer。函数执行成功时返回1，发生错误时返回-1。

Run()

功能运行指定的应用程序。

语法Run ( string {, windowstate } )

参数string：string类型，指定要运行的应用程序的名称，其中可以包括路径以及相应的参数，就像在命令行中键入的那样windowstate：WindowState枚举类型，可选项，指定程序运行时的窗口状态。有效取值为：Maximized! - 最大化窗口；Minimized! - 最小化窗口；Normal! - 缺省值，正常窗口返回值Integer。函数执行成功时返回1，发生错误时返回-1。如果任何参数的值为NULL，Run()函数返回NULL。

用法使用Run()函数，应用程序能够启动操作系统中的任何程序。当在Run()参数中指定了要启动应用程序的参数时，参数的意义、格式、个数等由具体的应用程序确定。如果在Run()函数的string参数中指定了文件名但没有给出扩展名时，PowerBuilder认为该文件的扩展名为.EXE。要运行扩展名不是.EXE的应用程序（比如.BAT, .COM, 或.PIF），必须在Run()函数的参数中指定文件的扩展名。

Send()

功能向窗口发送指定的消息并立即执行相应的事件处理程序。

语法Send( handle, messageno, word, long )

参数handle：long类型，指定窗口的系统句柄，将向该窗口发送消息messageno：UnsignedInteger类型，指定要发送的消息号word：long类型，指定与消息一起发送的word类参数值。如果messageno参数指

定的消息不使用该参数，那么将这个参数的值设置为0long：long类型或string，指定与消息一起发送的long 型参数值或字符串返回值Long。函数执行成功时返回Windows系统调用SendMessage()的返回值，发生错误时返回-1。如果任何参数的值为NULL，Send()函数返回NULL。

用法Send()函数用于向窗口发送非PowerBuilder预定义事件的消息，这个窗口可以是PowerBuilder应用的窗口，也可以是其它应用的窗口。Send()函数直接触发指定窗口相应的事件，执行事件处理程序后返回到调用应用中，这一点与Post()函数不同，Post()函数把发送的消息放置在指定窗口消息队列的尾部，然后返回到应用程序中，它并不等待相应事件事件处理程序的执行。因此，我们说Post()函数采用的是异步方式，Send()函数采用的是同步方式。Send()函数的参数handle指定接收消息的窗口句柄，对PowerBuilder 窗口来说，使用Handle()函数可以得到该句柄。对其它应用程序的窗口来说，可以调用系统API函数查找窗口并得到相应窗口的句柄。实际上，Send()函数把它的各个参数直接传送给Windows的系统调用SendMessage()。在各种C++开发工具的WINDOWS.H文件中可以查到各消息编号。如果应用程序要发送PowerBuilder定义事件（包括预定义事件和用户定义事件），那么使用TriggerEvent()函数既简单有方便。当应用程序在long参数位置指定一个字符串时，Send()函数复制一个该字符串的副本，然后将副本的地址传送给指定窗口。

SetProfileString()

功能设置初始化文件中指定项的值。

语法SetProfileString ( filename, section, key, value )

参数filename：string类型，指定初始化文件的名称，可以包括路径，省略路径时，该函数按操作系统的标准路径搜索指定文件section：string类型，指定要设置的值所在的节（Section）key：string类型，指定要设置的值的名称，不用区分大小写default：string类型，指定要设置项的值返回值Integer。函数执行成功时返回1，指定的文件未找到或指定的文件不能访问时函数返回-1。如果任何参数的值为NULL，SetProfileString()函数返回NULL。

ShowHelp()

功能显示应用程序帮助，该帮助使用Microsoft Windows帮助系统进行操作。

语法ShowHelp ( helpfile, helpcommand {, typeid } )

参数helpfile：string类型，指定帮助文件的名称helpcommand：HelpCommand枚举类型，指定显示帮助的格式。有效取值为：Index! - 显示目录主题，使用该值时不要指定typeid参数；Keyword! - 转移到由指定关键字确定的主题；Topic! - 显示指定主题的帮助typeid：可选项，指定帮助主题返回值Integer。函数执行成功时返回1，发生错误时返回-1。如果任何参数的值为NULL，ShowHelp()函数返回NULL。SignalError()

功能触发应用对象的SystemError事件，通常用于代码调试。

语法SignalError ( { number }, { text } )

参数number：integer类型，可选项，其值将保存到Error对象的number属性中text：string类型，可选项，其值将保存到Error对象的text属性中返回值Integer。函数执行成功时返回1，发生错误时返回-1。

Yield()

功能将控制权转移给其它图形对象，包括非PowerBuilder对象。该函数检测消息队列，如果

有消息，就把消息取出。利用该函数可以在执行耗时较长的操作时把控制权转让给其它应用。

语法Yield()

返回值Boolean。如果在消息队列中提取到了消息，那么函数返回TRUE，否则返回FALSE。

用法正常情况下，PowerBuilder应用程序在执行一段代码（比如函数或事件处理程序）的过

程中不响应用户的操作。对耗时短暂的代码段来说，这种处理方式没有什么不妥的地方，但

是，如果某个代码段的执行耗时较长，应用程序又希望为用户提供更多的控制权，那么需要

在这段代码中插入Yield()函数，让用户能够进行其它操作，特别在循环执行的代码中更应该

如此。应用程序执行Yield()函数后，如果发现消息队列中存在消息，它将允许对象处理这些

消息，处理之后，继续Yield()函数后面代码的执行。因此，代码中插入Yield()函数将降低应

用程序的运行效率。

Close()

功能关闭窗口并释放窗口以及窗口上的控件所占据的内存。

语法Close(windowname)

参数windowname：要关闭窗口的名称返回值Integer。函数执行成功时返回1，发生错误时返回-1。如果参数windowname的值为NULL，Close()函数返回NULL。

用法应用程序使用Open()或其它Open簇函数打开窗口后，不需要窗口时，可以使用Close()关闭窗口并释放窗口以及窗口上所有控件占据的内存。Close()函数的执行过程为：如果要关闭窗口的CloseQuery和/或Close事件已经编写了事件处理程序，那么执行这些事件处理程序，从屏幕上删除要关闭的窗口、关闭窗口、之后执行调用Close()函数语句后面的语句。当窗口被关闭后，应用程序就不能再访问已经关闭窗口的属性、实例变量、对象函数、以及窗口上的控件了。如果关闭窗口后应用程序依然访问上述特性，那么将引发运行错误。当然，应用程序也可以阻止窗口被关闭，方法很简单，只要在欲阻止关闭窗口的CloseQuery事件处理程序中使用RETURN语句返回1即可，格式为：RETURN1

CloseWithReturn()

功能关闭窗口并将返回值保存在Message对象中，该函数只能对响应窗口使用。

语法CloseWithReturn ( windowname, returnvalue)

参数windowname：要关闭窗口的名称returnvalue：指定关闭窗口时保存到Message对象中的值，调用