PowerBuilder函数大全
- 1、下载文档前请自行甄别文档内容的完整性,平台不提供额外的编辑、内容补充、找答案等附加服务。
- 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
- 3、如文档侵犯您的权益,请联系客服反馈,我们会尽快为您处理(人工客服工作时间:9:00-18:30)。
PB函数大全
∙Abs()
功能计算绝对值。
语法Abs( n )
参数n:要得到绝对值的数值型变量或表达式返回值返回值的数据类型与n的数据类型相同,函数执行成功时返回n的绝对值。
如果参数n的值为NUL L,Abs()函数返回NU LL。
∙Ceilin g()
功能返回大于n的最小整数。
语法Ceil ing ( n )
参数n:数值型变量或表达式返回值返回值的数据类型与n的数据类型相同。
函数执行成功时返回大于n的最小整数。
如果参数n的值为NUL L,Ceilin g()函数返回NU LL。
∙Cos()
功能计算余弦,其中参数以弧度为单位。
语法Cos( n )
参数n:数值型变量或表达式返回值Doub le。
函数执行成功时返回n的余弦。
如果参数n的
值为NUL L,Cos()函数返回NU LL。
∙Exp()
功能计算e的n次方。
语法Exp( n )
参数n:指定幂值返回值Doub le。
函数执行成功时返回e(约等于2.71828)的n次方。
如果参数n的值为NUL L,Exp()函数返回NU LL。
∙Fact()
功能计算n的阶乘。
语法Fact ( n )
参数n:数值型变量或表达式返回值Doub le。
函数执行成功时返回n的阶乘。
如果参数n的
值为NUL L,Fact()函数返回NU LL。
∙Int()
功能得到小于等于n的最大整数。
语法Int( n )
参数n:数值型变量或表达式返回值Inte ger。
函数执行成功时返回小于等于n的最大整数。
如果n的值太小或太大,超过了整数的表示范围,则函数返回0。
如果参数n的值为NUL L,Int()函数返回NU LL。
∙Log()
功能计算n的自然对数。
语法Log( n )
参数n:数值型变量或表达式,其值必须大于0返回值D ouble。
函数执行成功时返回n的自然对数。
如果n小于等于0,将导致运行错误。
如果参数n的值为NUL L,Log()函数返回NU LL。
∙LogTen()
功能计算n的常用对数(以10为底)。
语法LogT en ( n )
参数n:数值型变量或表达式,其值必须大于0返回值D ouble。
函数执行成功时返回n的常用对数。
如果n小于等于0,将导致运行错误。
如果参数n的值为NUL L,LogTen()函数返回NU LL。
∙Max()
功能求两个数中的最大值。
语法Max( x, y )
参数x:数值型变量或表达式,参加比较的第一个数y:数值型变量或表达式,参加比较的第二个数返回值以x、y中数据类型更精确的数据类型作为该函数的返回值数据类型。
函数执行成功时返回参数比较的两个数中更大者。
如果任何参数的值为NU LL,Max()函数返回NU LL。
∙Min()
功能求两个数中的最小值。
语法Min( x, y )
参数x:数值型变量或表达式,参加比较的第一个数y:数值型变量或表达式,参加比较的第二个数返回值以x、y中数据类型更精确的数据类型作为该函数的返回值数据类型。
函数执行成功时返回参数比较的两个数中较小者。
如果任何参数的值为NU LL,Min()函数返回NU LL。
∙Mod()
功能求余数。
语法Mod( x, y )
参数x:数值型变量或表达式,被除数y :数值型变量或表达式,除数返回值以x、y中数据类型更精确的数据类型作为该函数的返回值数据类型。
函数执行成功时返回x除以y所得的余数。
如果任何参数的值为NU LL,Mod()函数返回NU LL。
∙Pi()
功能计算n与Pi(3.14159265358979323...)的乘积。
语法Pi ( n )
参数n:数值型变量或表达式返回值Doub le。
函数执行成功时返回n与
Pi(3.14159265358979323...)的乘积。
发生错误时返回-1。
如果参数n的值为NUL L,Pi()函数
返回NU LL。
∙Rand()
功能得到1与n之间的一个伪随机数。
语法Rand ( n )
参数n:数值型变量或表达式,指定要产生的伪随机数的上界。
有效值在1到32,767之间返
回值与n的数据类型相同。
函数执行成功时返回1与n之间的一个伪随机数,包括1和n在内。
如果参数n的值为NUL L,Rand()函数返回NU LL。
Random ize()
功能初始化伪随机数发生器,这样让应用程序每次使用不同的伪随机数序列。
语法Rand omize ( n )
参数n:数值型变量或表达式,指定伪随机数生成器使用的起始值,不同的起始值可以生成不同的伪随机数序列。
当n的值为0时,该函数把系统时钟作为伪随机数生成器的起始值,这样可以生成不可重复的伪随机数序列。
当n的值不为0时,可以产生不同的伪随机数序列,但是,如果两次使用相同的伪随机数生成器起始值,那么两次生成的伪随机数序列相同。
n的值在0到32,767之间返回值Int eger。
极少使用该函数的返回值。
Round()
功能将x四舍五入到n位。
语法Roun d ( x, n )参数x:要四舍五入的数值型数据n:整数类型,指定从哪个小数位上四舍五入x。
有效值在0到18之间返回值Dec imal。
函数执行成功时返回将x四舍五入到小数点后第n位的数值,如果函数执行失败或任何参数的值为NULL,Round()函数返回NU LL。
Sign()
功能确定n是整数、负数还是零。
语法Sign ( n )
参数n:数值型变量或表达式,指定要测试符号的值返回值Inte ger。
当n大于0时返回1;当n小于0时返回-1;当n等于0时返回0。
如果参数n的值为NUL L,Sign()函数返回NU LL。
Sin()
功能计算正弦,其中参数以弧度为单位。
语法Sin( n )
参数n:数值型变量或表达式返回值Doub le。
函数执行成功时返回n的正弦。
如果参数n的值为NUL L,Sin()函数返回NU LL。
Sqrt()
功能计算平方根。
语法Sqrt ( n )
参数n:数值型变量或表达式,指定要计算平方根的数据返回值Do uble。
函数执行成功时返回n的平方根。
如果n是负数,则执行该函数时引发运行错误。
如果参数n的值为NUL L,Sqrt()函数返回NU LL。
Tan()
功能计算正切,其中参数以弧度为单位。
语法Tan( n )
参数n:数值型变量或表达式返回值Doub le。
函数执行成功时返回n的正切。
如果参数n的值为NUL L,Tan()函数返回NU LL。
Trunca te()
功能截断数值到指定的小数位。
语法Trun cate( x, n )
参数x:要截断的数值型数据n:整数类型,指定从哪个小数位上截断x。
有效值在0到18
之间返回值Dec imal。
函数执行成功时返回将x截断到小数点后第n位的数值,如果函数执行
失败或任何参数的值为NULL,Trunca te()函数返回NU LL。
所谓截断就是舍弃指定位之后的
数值。
Asc()
功能得到字符串第一个字符的ASC II码整数值。
语法Asc( string )
参数stri ng:要得到第一个字符ASC II值的字符串返回值Integ er。
函数执行成功时返回st ring参数第一个字符的ASC II值,如果stri ng参数的值为NUL L,则Asc()函数返回NU LL。
Char()
功能将字符串的第一个字符、Blob变量的第一个值、或一个整数转换成字符。
语法Char ( n )
参数n:字符串、Blob变量或整数,也可以是包含上述类型数据的Any类型变量返回值Cha r。
返回参数n的第一个字符。
如果n参数的值为NUL L,则Char()函数返回NU LL。
Dec()
功能将字符串或Blob值转换成D ecima l类型的值。
语法Dec( string orblo b )
参数stri ngorb lob:string类型变量或Blob类型变量。
Blob类型变量时,把该变量第一个值转换为Decim al 类型的值,其余部分被忽略。
string orblo b参数也可以是包含上述类型数据的Any类型变量返回值Deci mal。
函数执行成功时返回相应的Deci mal类型值。
如果stri ngorb lob参数中的值不是有效的Po werSc ript数字或数据类型不兼容,那么Dec()函数返回0。
如果stri ngorb lob参数的值为NU LL,则Dec()函数返回NU LL。
Double()
功能将字符串或Blob值转换成D ouble类型的值。
语法Doub le(string orblo b)
参数stri ngorb lob:string类型变量或Blob类型变量。
Blob类型变量时,把该变量第一个值转换为Doubl e 类型的值,其余部分被忽略。
string orblo b参数也可以是包含上述类型数据的Any类型变量返回值Doub le。
函数执行成功时返回相应的Doub le类型值。
如果stri ngorb lob参数中的值不是有效的Po werSc ript数字或数据类型不兼容,那么Doub le()函数返回0。
如果stri ngorb lob参数的值为NU LL,则Doubl e()函数返回
NU LL。
Intege r()
功能将字符串或B lob值转换成Int eger类型的值。
语法Inte ger ( string orblo b )
参数stri ngorb lob:string类型变量或Blob类型变量。
Blob类型变量时,把该变量第一个值转换为Integ er 类型的值,其余部分被忽略。
string orblo b参数也可以是包含上述类型数据的Any类型变量返回值Inte ger。
函数执行成功时返回相应的Inte ger类型值。
如果stri ngorb lob参数中的值不是有效的Po werSc ript数字或数据类型不兼容,那么Inte ger()函数返回0。
如果stri ngorb lob参数的值为NU LL,则Integ er()函数返回
NU LL。
Long()
功能将其它类型的数据转换为Lon g类型的值。
该函数有两种语法格式:
语法一、将两个无符号整数组合成一个长整数值;
语法二、将字符串或B lob值转换成Lon g类型的值。
下面分别予以介绍:
语法一、将两个无符号整数组合成一个长整数值
语法Long ( lowwor d, highwo rd )
参数loww ord:Unsign edInt eger类型,指定长整数中的低位值h ighwo rd:Unsign edInt eger类型,指定长
整数中的高位值返回值Lon g。
函数执行成功时返回由低位值和高位值组合后的长整数值,发生错误时返回-1。
如果任何参数的值为NU LL,则Long()函数返回NU LL。
语法二、将字符串或B lob值转换成Lon g类型的值
语法Long ( string orblo b )
参数stri ngorb lob:string类型变量或Blob类型变量。
Blob类型变量时,把该变量第一个值转换为Long类型的值,其余部分被忽略。
string orblo b参数也可以是包含上述类型数据的Any类型变量返回值Long。
函数执行成功时返回相应的Long类型值。
如果stri ngorb lob参数中的值不是有效的Po werSc ript数字或数据类型不兼容,那么Long()函数返回0。
如果stri ngorb lob参数的值为NU LL,则Long()函数返回NU LL。
Real()
功能将字符串或Blob值转换成R eal类型的值。
语法Real ( string orblo b )
参数stri ngorb lob:string类型变量或Blob类型变量。
当该参数是B lob类型变量时,把该变量第一个值转换为Real类型的值,其余部分被忽略。
string orblo b参数也可以是包含上述类型数据的Any类型变量返回值Real。
函数执行成功时返回相应的Real类型值。
如果stri ngorb lob参数中的值不是有效的Po werSc ript数字或数据类型不兼容,那么Real()函数返回0。
如果stri ngorb lob参数的值为NU LL,则Real()函数返回
NU LL。
Date()功能将其它类型的数据转换为Date类型的数据。
该函数有三种语法格式:
语法一、将DateT ime类型或第一个值是Date Time或Date的Blob值转换成Da te类型的值;
语法二、将其值是个有效日期的字符串转换成Date类型的值;
语法三、将三个整数组合成一个日期。
下面分别予以介绍:
语法一、将DateT ime类型或第一个值是Date Time或Date的Blob值转换成Da te类型的值
语法Date ( dateti me )
参数date time:DateTi me类型的值或第一个值是Dat eTime或Date的Blob类型的值。
当该参数是B lob 类型变量时,把该变量第一个值转换为Date类型的值,其余部分被忽略。
dateti me参数也可以是包含上述类型数据的Any类型变量返回值Dat e。
函数执行成功时返回相应的Date类型值。
如果date time参数中的值不是有效的P owerS cript日期或数据类型不兼容,那么Date()函数返回1900-01-01。
如果date time参数的值为N ULL,则Date()函数返回NU LL。
语法二、将其值是个有效日期的字符串转换成Date类型的值
语法Date ( string )
参数stri ng:string类型,其值包括一个有效的以字符串形式表示的日期(比如Janu ary 1, 1998或12-31-99),string参数也可以是包含字符串类型数据的Any类型变量返回值Date。
函数执行成功时返回相应的Date
类型值。
如果stri ng参数中的值不是有效的Pow erScr ipt日期或数据类型不兼容,那么Date()函数返回
1900-01-01。
如果stri ng参数的值为NUL L,则Date()函数返回NU LL。
语法三、将三个表示年、月、日的整数组合成一个日期
语法Date ( year, month, day )
参数year:intege r类型,指定日期中的年份,用四位数字表示,从0到9999mont h:intege r类型,指定日期中的月份,用一位或两位数字表示,从1到12d ay:intege r类型,指定日期中的号数,用一位或两位数字表示,从1到31返回值Dat e。
函数执行成功时返回由y ear、month、day三个参数确定的日期。
如果这三个参数中任何一个参数使用了无效值(比如月份指定为14),则Date()函数返回1900-01-01。
如果任何参数的值为NU LL,则Date()函数返回NU LL。
DateTi me()
功能将其它类型的数据转换为DateT ime类型的数据。
该函数有两种语法格式:语法一、把日期和时间值组合成D ateTi me类型的值;语法二、将Blob类型的值转换成Date Time类型的值。
下面分别予以介绍:语法一、把日期和时间值组合成D ateTi me类型的值
语法Date Time( date {, time } )
参数date:Date类型的日期值t ime:可选参数,Time类型的时间值,省略该参数时,PowerB uilde r把时间设置为午夜(00:00:00.000000)。
当指定该参数时,可以仅仅指定小时值返回值Date Time。
函数执行成功时返回日期和时间组合而成的Da teTim e类型的值。
如果任何参数的值为NU LL,则DateT ime()函数返回NU LL。
语法二、将Blob类型的值转换成Date Time类型的值
语法Date Time( blob )
参数blob:Blob类型变量,把该变量第一个值转换为DateT ime类型的值,其余部分被忽略。
blob参数也可以是包含blob类型数据的Any类型变量返回值DateT ime。
函数执行成功时返回相应的Date Time类型值。
如果blob参数的值为NULL,则DateT ime()函数返回NU LL。
IsDate()
功能检测指定的字符串是否包含有效的日期。
语法IsDa te ( dateva lue )
参数date value:string类型,指定要检测的字符串返回值Bool ean。
如果date value包含了有效的日期,则IsDat e()函数返回TR UE,否则返回FA LSE。
如果date value参数的值为NULL,则IsDat e()函数返回NU LL。
IsNull()
功能测试变量或表达式的值是否是N ULL。
语法IsNu ll ( any )
参数any:要测试的变量或表达式返回值Boo lean:如果any的值为NUL L,函数返回TR UE,否则函数返回FALSE。
IsNumb er()
功能测试字符串是否是有效的数值。
语法IsNu mber( string )
参数stri ng:string类型,要测试的字符串返回值B oolea n:如果stri ng的值为有效的Po werSc ript数字,函数返回TR UE,否则函数返回FALSE。
如果stri ng参数的值为NUL L,则IsNum ber()函数返回NU LL。
IsTime()
功能测试字符串的值是否是有效的时间。
语法IsTi me ( timeva lue )
参数time value:string类型,要测试的字符串返回值B oolea n:如果time value的值为有效的时间,函数返回TR UE,否则函数返回FALSE。
如果time value参数的值为N ULL,则IsTim e()函数返回NU LL。
String()
功能按指定格式将数据转换成字符串。
String()可以把Dat e、DateTi me、数值类型、Time、String类型的数据转换成指定格式的字符串。
语法Stri ng(data,{format})
参数data:指定要转换格式的数据,其数据类型可以是Dat e、DateTi me、数值类型、Time、String,也可以是包含上述类型数据的Any类型变量f ormat:可选项,string类型,其值指定数据格式。
如果data参数的类型为stri ng,则必须指定f ormat参数返回值Strin g。
函数执行成功时返回以字符串方式表示的指定数据,如果data参数的数据类型与fo rmat参数指定的格式不匹配、format参数指定的格式无效、或data参数不是前面提到的适宜数据类型时,String()函数返回空字符串("")。
用法:
format是个用掩码表示的字符串,对data参数为数值类型的情况来说,格式为:正数格式;负数格式;零的显示格式;空的显示格式除第一部分必须提供外,其它部分可以省略。
数值型显示格式中使用两个掩码字符:#和0,其中,使用#代表0~9之间的任意数字,0代表每个零都要显示。
另外,货币符号($或¥)、百分号(%)、小数点(.)、逗号(,)等字符也可以出现在格式字符串中,但是,除小数点(.)、逗号(,)能够出现在格式字符#和0之间外,其它字符只能放置在格式串的前面或后面,例如,###,###$###是个错误的格式串,¥###,###,###是个正确的格式串。
省略form at参数时,String()函数使用Po werBu ilder 缺省格式。
注意,如果显示格式有多个部分,各部分之间的分号(;)不能省略。
其它字符也可以出现在显示格式字符串中(只能放在格式串的开头和末尾),但它们没有特殊意义,系统只是照原样显示。
例如,用显示格式字符串“收入##”格式化数值12时,显示结果为“收入12”。
对data参数为字符串(String)类型的情况来说,format参数的语法格式为:正常字符串格式;空值时格式在“正常字符串格式”中,@代表字
符串中的任意字符,除此之外的任何字符照原样显示,例如,如果定义了下面的格式:(@@)
@@@@-@@@@则字符串0166767593显示为:(01)6676-7593对d ata参数为日期(Date)类型的情况来说,format参数的语法格式为:正常日期格式;日期为空值时的格式日期格式中格式字符意义如下:d棗开头不带0的日数(如8)dd棗开头带0的日数(如08)ddd棗星期的英文缩写(如Mon、Tue)dddd 棗星期的英文全称(如Monda y、Tuesda y)m棗开头不带0的月份(如8)mm棗开头带0的月份(如08)mmm棗月份的英文缩写(如Jan、Feb)mmmm棗月份的英文全称(如Janua ry、Februa ry)yy棗两位数字表示的年份(如97)yyyy棗四位数字表示的年份(如1997)另外,还可以使用下面的关键字作为日期的显示格式:[Genera l] Window s系统中定义的短日期格式[LongDa te] Window s系统中定义的长日期格式[ShortD ate] Window s系统中定义的短日期格式对da ta参数为时间(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代表一部分微秒A M/PM棗用AM/PM显示上、下午时间,12小时制a m/pm棗用am/pm显示上、下午时间,12小时制A/P棗用A/P显示上、下午时间,12小时制a/p棗用a/p显示上、下午时间,12小时制另外,显示格式中还可以使用关键字[Time],它表示按当前Windo ws系统定义的格式显示时间。
对data参数为日期时间(DateTi me)类型的情况来说,语法格式为:正常日期时间格式;日期时间为空值时的格式日期时间类型使用的掩码就是把日期掩码和时间掩码结合起来即可。
Time()
功能把其它类型的数据转换为Time类型的值。
该函数有三种语法格式:语法一、将DateT ime
类型或第一个值是Date Time或Time的Blob值转换成Ti me类型的值;语法二、将其值是个有
效时间的字符串转换成Time类型的值;语法三、将表示时、分、秒、以及微秒的整数组合成
一个时间值。
下面分别予以介绍:
语法一、将DateT ime类型或第一个值是Date Time或Time的Blob值转换成Ti me类型的值
语法Time ( dateti me )
参数date time:DateTi me类型的值或第一个值是Dat eTime或Time的Blob类型的值。
当该
参数是B lob类型变量时,把该变量第一个值转换为Time类型的值,其余部分被忽略。
dateti me
参数也可以是包含上述类型数据的Any类型变量返回值Tim e。
函数执行成功时返回相应的
Time类型值。
如果date time参数中的值不是有效的P owerS cript时间或数据类型不兼容,那
么Time()函数返回00:00:00.000000。
如果date time参数的值为N ULL,则Time()函数返回
NU LL。
语法二、将其值是个有效时间的字符串转换成Time类型的值
语法Time ( string )
参数stri ng:string类型,其值包括一个有效的以字符串形式表示的时间(比如9am或10:25),
string参数也可以是包含时间类型数据的Any类型变量返回值Time。
函数执行成功时返回相
应的Time类型值。
如果stri ng参数中的值不是有效的Pow erScr ipt时间或数据类型不兼容,
那么Time()函数返回00:00:00.000000。
如果stri ng参数的值为NUL L,则Time()函数返回
NU LL。
语法三、将表示时、分、秒、以及微秒的整数组合成一个时间值
语法Time ( hour, minute, second {, micros econd } )
参数hour:intege r类型,指定时间中的小时,从0到23m inute:intege r类型,指定时间中
的分钟,从0到59s econd:intege r类型,指定时间中的秒,从0到59m icros econd:intege r
类型,可选项,指定时间中的微秒,从0到32767返回值Time。
函数执行成功时返回由h our、
minute、second、micros econd四个参数确定的时间。
如果这四个参数中任何一个参数使用
了无效值(比如小时指定为44),则Time()函数返回NU LL。
Beep()
功能响铃n次(n超过10时只响10次)。
语法Beep ( n )
参数n:数值类型,指定需要的响铃次数。
如果n的值大于10,那么计算机只响铃10次返回值In teger。
函数执行成功时返回1,发生错误时返回-1。
如果参数n的值为NUL L,Beep()函数返回NU LL。
ClassN ame()
功能确定指定变量的类(数据类型)。
语法Clas sName(variab le)
参数vari able:指定要确定其数据类型的变量返回值Strin g。
函数执行成功时返回指定变量的数据类型,发生错误时返回空字符串。
如果参数va riabl e的值为N ULL,ClassN ame()函数返回NU LL。
用法需要注意的是,ClassN ame()函数不能确定枚举类型变量的类型,此时,ClassN ame()函数返回空字符串("")。
DebugB reak()
功能暂停程序执行,打开调试器,进入调试模式。
语法Debu gBrea k ( )
返回值无用法 DebugB reak()函数可以帮助你调试应用程序。
如果你希望应用程序执行某条语句后暂停执
行,然后进入调试模式,那么可以在该语句后面放上Debu gBrea k()函数,应用程序执行到Debu gBrea k()
函数后,打开Debu g(调试)窗口,并在其中显示当前上下文信息。
这种方式实现了应用程序在Powe rBuil der 开发环境中的即时调试功能。
IntHig h()
功能得到Lo ng型值的高位字。
语法IntH igh ( long )
参数long:long型值或变量返回值 Intege r。
函数执行成功时返回参数long的高位字,发生错误时返回-1。
如果参数lo ng的值为NULL,IntHig h()函数返回NU LL。
用法IntH igh()函数通常用于分解外部C或C++语言函数的返回值和Wi ndows消息。
IntLow()
功能得到Lo ng型值的低位字。
语法IntL ow ( long )
参数long:long型值或变量返回值Inte ger。
函数执行成功时返回参数long的低位字,发生错误时返回-1。
如果参数lo ng的值为NULL,IntLow()函数返回NU LL。
用法IntL ow()函数通常用于分解外部C或C++语言函数的返回值和Wi ndows消息。
示例请参看I ntHig h()函数。
IsVali d()
功能检查对象变量是否已经实例化,即实例变量的值是否是个有效的对象句柄。
语法IsVa lid ( object name)
参数obje ctnam e:要检测的对象名返回值B oolea n。
如果指定对象已经创建了对象实例,那么IsVa lid()函数返回TR UE,否则返回FA LSE。
如果参数ob jectn ame的值为NULL,IsVali d()函数返回NU LL。
KeyDow n()
功能检查用户是否按了键盘上指定的键。
语法KeyD own ( keycod e )
参数 keycod e:KeyCod e枚举类型或inte ger类型,指明要检测的按键或某个键的ASC II值返回值Bool ean。
如果用户按了keyco de参数指定的按键,函数返回TR UE,否则返回FA LSE。
如果参数ke ycode的值为NU LL,KeyDow n()函数返回NU LL。
用法KeyD own()函数通常在某个事件的事件处理程序中调用,它并不指明用户键入了哪个字符,而是说明当前事件(即事件处理程序中调用K eyDow n()函数的事件)发生时用户正按着哪个按键。
一般来说,应用程序在窗口的Key事件或控件的按键事件中调用Ke yDown()函数,以检测用户是否按了某个特殊键。
对控件来说,PowerB uilde r没有定义预定义的K ey事件,这也没有关系,如果在控件得到焦点后希望应用程序检测用户的按键,只要对该控件定义一个用户事件,并把
pbm_keydo wn (其它控件)或pbm_d wnkey(数据窗口控件)映射到该用户事件上即可。
Messag eBox()
功能显示一个消息对话框。
语法Mess ageBo x(title,text{,icon{,button{,defaul t}}})
参数titl e:string类型,指定消息对话框的标题t ext:指定消息对话框中显示的消息,该参数可以是数值数据类型、字符串或bo olean值icon:Icon枚举类型,可选项,指定要在该对话框左侧显示的图标b utton:Button 枚举类型,可选项,指定显示在该对话框底部的按钮de fault:数值型,可选项,指定作为缺省按钮的按钮编号,按钮编号自左向右依次计数,缺省值为1,如果该参数指定的编号超过了显示的按钮个数,那么Mess ageBo x()函数将使用缺省值返回值Integ er。
函数执行成功时返回用户选择的按钮编号(例如1、2、3等),发生错误时返回-1。
如果任何参数的值为NU LL,Messag eBox()函数返回NU LL。
用法当你的应用程序需要显示一段简短信息(比如显示出错、警告等信息)时,没有必要自己从头创建窗口、安排控件,使用Mess ageBo x()函数既简单又方便。
用户只有响应该窗口后,程序才能继续运行下去。
Messag eBox()函数的ico n参数指定显示在窗口中的图标,它是枚举类型,可能取值为:取值图标
Info rmati on! StopSi gn! Exclam ation! Questi on! None! 无图标其中I nform ation!是Icon参数的缺省值。
Button参数指定在窗口中显示哪些按钮,有效取值为:取值中文Wi ndows 95下显示O K!“确定”按钮
OKCa ncel!“确定”、“取消”按钮YesN o!“是”、“否”按钮 YesNoC ancel!“是”、“否”、“取消”按钮Retr yCanc el!“重试”、“取消”按钮Abor tRetr yIgno re!“终止”、“重试”、“忽略”按钮
Pixels ToUni ts()
功能将像素值转换为Powe rBuil der单位PBU。
语法Pixe lsToU nits( pixels, type )
参数pixe ls:intege r类型,指定要转换为Power Build er单位的像素数ty pe:Conver tType枚举类型,指定按哪个方向进行转换。
有效取值为:XPixel sToUn its! - 按水平方向转换像素;YPixel sToUn its! - 按垂直方向转换像素返回值Inte ger。
函数执行成功时返回pi xels参数指定像素数按指定方向转换成的
Power Build er单位数,发生错误时返回-1。
如果任何参数的值为NU LL,Pixels ToUni ts()函数返回NU LL。
用法窗口中水平方向和垂直方向相同的像素数表示的距离并不相同。
如果你使用水平方向和垂直方向相同的像素数绘制一个方框,那么你会看到,该方框不是正方形而是个矩形,而使用PBU计量的相同单位数将绘出正方形。
因此,在进行单位转换时,需要指明按那么方向进行转换。
Popula teErr or()
功能以应用程序定制的错误号和错误信息填充E rror对象,该函数不触发应用对象的Syste mErro r事件。
语法Popu lateE rror( number, text )
参数numb er:intege r类型,指定要保存到Error对象num ber属性中的值te xt:string类型,指定要保存到Error对象tex t属性中的值返回值I ntege r。
函数执行成功时返回1,发生错误时返回-1。
用法当应用程序需要根据变量的当前取值来定制Error对象时,可以使用Po pulat eErro r()函数来填充E rror对象的num ber和t ext属性,同时该函数根据上下文自动填充Er ror对象的其它属性。
定制了Err or对象后,应用程序可以使用不带参数的Sig nalEr ror()函数触发应用对象的Sy stemE rror事件。
这样,在Syste mErro r。