pb函数大全

pb函数库之日期、时间函数

?Day()

功能得到日期型数据中的号数(1到31之间的整数值)。

语法Day ( date )

参数date：要得到号数的日期值返回值 Integer。函数执行成功时返回号数(1到31之间的整数值)。如果date参数的值为NULL，则Day()函数返回NULL。

?DayName()

功能得到指定日期是一周中的星期几(例如，Sunday, Monday...)。

语法DayName ( date )

参数date：date类型值或变量返回值String。函数执行成功时返回指定日期的星期表示(例如，Sunday, Monday...)。如果date参数的值为NULL，则DayName()函数返回NULL。

?DayNumber()

功能得到日期型数据是一星期中的第几天(用1到7之间的整数表示，星期天为1，星期一为2，...)。

语法DayNumber ( date )

参数date：date类型值或变量返回值Integer。函数执行成功时返回指定日期是一星期中的第几天(用1~7表示，星期天为1，星期一为2，...)。

如果date参数的值为NULL，则DayNumber()函数返回NULL。

?DaysAfter()

功能得到两个日期间的天数。

语法DaysAfter ( date1, date2 )

参数date1：date类型，指定起始日期date2：date类型，指定终止日期返回值Long。函数执行成功时得到两个日期之间的天数。如果date2的日期在date1的前面，那么DaysAfter()函数返回负值。如果任何参数的值为NULL，则DaysAfter()函数返回NULL。

?Hour()

功能得到时间值中的小时，采用24小时制。

语法Hour ( time )

参数time：time类型的值返回值Integer。函数执行成功时得到time 参数中的小时（00到23之间）。如果time参数的值为NULL，则Hour()

函数返回NULL。

?Minute()

功能得到时间值中的分钟，有效值在00～59之间。

语法Minute ( time )

参数time：time类型的值返回值Integer。函数执行成功时得到time 参数中的分钟（00到59之间）。如果time参数的值为NULL，则Minute()函数返回NULL。

?Month()

功能得到日期值中的月份，有效值在1～12之间。

语法Month ( date )

参数date：date类型的值返回值Integer。函数执行成功时得到date 参数中的月份（1到12之间）。如果date参数的值为NULL，则Month()函数返回NULL。

?Now()

功能得到客户机的当前系统时间，返回值为Time类型。

语法Now()返回值Time。该函数返回客户机的当前系统时间。

?RelativeDate()

功能得到指定日期前多少天或后多少天的日期。

语法RelativeDate(date,n)

参数date：Date类型，指定基准日期n：integer类型，指定天数返回值Date。当n的值大于0时返回参数date指定日期后第n天的日期；

当n的值小于0时返回参数date指定日期前第n天的日期。如果任何参数的值为NULL，则RelativeDate()函数返回NULL。

?RelativeTime()

功能得到指定时间前多少秒或后多少秒的时间，采用24小时制。

语法RelativeTime ( time, n )参数time：time类型，指定基准时间n：long类型，指定秒数返回值Time。当n的值大于0时返回参数time 指定时间后第n秒的时间；当n的值小于0时返回参数time指定时间前第n秒的时间。如果任何参数的值为NULL，则RelativeTime()函数

返回NULL。

?Second()

功能得到时间值中的秒，有效值在00～59之间。

语法Second ( time )

参数time：time类型的值返回值Integer。函数执行成功时得到time

参数中的秒（00到59之间）。如果time参数的值为NULL，则Second()函数返回NULL。

?Today()

功能得到当前系统日期，在某些情况下，同时得到当前系统时间。

语法Today()返回值Date。该函数返回当前系统日期。用法单独调用

Today()函数时，该函数总是返回当前系统日期，但是，虽然Today()

函数的返回值类型为Date，在该函数用做某些函数的参数、而该参数要求DateTime类型的值时，Today()函数也能够在返回当前系统日期的同时返回当前系统时间。再如，Today()函数作为数据窗口控件SetItem()函数的参数，该函数参数中指定的数据窗口列的数据类型为DateTime，那么当前系统日期和时间将同时设置到数据窗口指定项中。

?Year()

功能得到日期值中的年度(有效取值1000到3000)。

语法Year(date)

参数date：date类型的值返回值Integer。函数执行成功时得到date

参数中的年份（采用四位数字），发生错误时返回1900，如果date参

数的值为NULL，则Year()函数返回NULL。用法当应用程序把有两位数

字表示年份的字符串转换成日期时，PowerBuilder根据下述规则选择世纪：如果年份值在00到49之间，PowerBuilder将年份中的世纪（前两位数字）当作20；如果年份值在50到99之间，PowerBuilder将年份

中的世纪（前两位数字）当作19。比如，字符串"20-10-25"被

PowerBuilder转换为2020-10-25；字符串"98-10-25"被PowerBuilder

转换为1998-10-25。因此，如果应用程序中需要指定1950年之前的日

期，应该使用四位数字表示年份，以避免引起歧义。PowerBuilder能够处理的年份从1000到3000之间。

2009-04-06 18:31

系统与环境函数

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()函数将降低应用程序的运行效率。

日期、时间函数

Day()

功能得到日期型数据中的号数(1到31之间的整数值)。

语法Day ( date )

参数date：要得到号数的日期值返回值 Integer。函数执行成功时返回号数(1到31之间的整数值)。如果date参数的值为NULL，则Day()函数返回NULL。

--------------------------------------------------------------------------------

DayName()

功能得到指定日期是一周中的星期几(例如，Sunday, Monday...)。

语法DayName ( date )

参数date：date类型值或变量返回值String。函数执行成功时返回指定日期的星期表示(例如，Sunday, Monday...)。如果date参数的值为NULL，则DayName()函数返回NULL。

--------------------------------------------------------------------------------

DayNumber()

功能得到日期型数据是一星期中的第几天(用1到7之间的整数表示，星期天为1，星期一为2，...)。

语法DayNumber ( date )

参数date：date类型值或变量返回值Integer。函数执行成功时返回指定日期是一星期中的第几天(用1~7表示，星期天为1，星期一为2，...)。如果date 参数的值为NULL，则DayNumber()函数返回NULL。

--------------------------------------------------------------------------------

DaysAfter()

功能得到两个日期间的天数。

语法DaysAfter ( date1, date2 )

参数date1：date类型，指定起始日期date2：date类型，指定终止日期返回值Long。函数执行成功时得到两个日期之间的天数。如果date2的日期在date1

的前面，那么DaysAfter()函数返回负值。如果任何参数的值为NULL，则DaysAfter()函数返回NULL。

--------------------------------------------------------------------------------

Hour()

功能得到时间值中的小时，采用24小时制。

语法Hour ( time )

参数time：time类型的值返回值Integer。函数执行成功时得到time参数中的小时（00到23之间）。如果time参数的值为NULL，则Hour()函数返回NULL。

--------------------------------------------------------------------------------

Minute()

功能得到时间值中的分钟，有效值在00～59之间。

语法Minute ( time )

参数time：time类型的值返回值Integer。函数执行成功时得到time参数中的分钟（00到59之间）。如果time参数的值为NULL，则Minute()函数返回NULL。--------------------------------------------------------------------------------

Month()

功能得到日期值中的月份，有效值在1～12之间。

语法Month ( date )

参数date：date类型的值返回值Integer。函数执行成功时得到date参数中的月份（1到12之间）。如果date参数的值为NULL，则Month()函数返回NULL。--------------------------------------------------------------------------------

Now()

功能得到客户机的当前系统时间，返回值为Time类型。

语法Now()返回值Time。该函数返回客户机的当前系统时间。

--------------------------------------------------------------------------------

RelativeDate()

功能得到指定日期前多少天或后多少天的日期。

语法RelativeDate(date,n)

参数date：Date类型，指定基准日期n：integer类型，指定天数返回值Date。当n的值大于0时返回参数date指定日期后第n天的日期；当n的值小于0时返回参数date指定日期前第n天的日期。如果任何参数的值为NULL，则RelativeDate()函数返回NULL。

--------------------------------------------------------------------------------

RelativeTime()

功能得到指定时间前多少秒或后多少秒的时间，采用24小时制。

语法RelativeTime ( time, n )参数time：time类型，指定基准时间n：long 类型，指定秒数返回值Time。当n的值大于0时返回参数time指定时间后第n 秒的时间；当n的值小于0时返回参数time指定时间前第n秒的时间。如果任何参数的值为NULL，则RelativeTime()函数返回NULL。

--------------------------------------------------------------------------------

Second()

功能得到时间值中的秒，有效值在00～59之间。

语法Second ( time )

参数time：time类型的值返回值Integer。函数执行成功时得到time参数中的秒（00到59之间）。如果time参数的值为NULL，则Second()函数返回NULL。--------------------------------------------------------------------------------

Today()

功能得到当前系统日期，在某些情况下，同时得到当前系统时间。

语法Today()返回值Date。该函数返回当前系统日期。用法单独调用Today()函数时，该函数总是返回当前系统日期，但是，虽然Today()函数的返回值类型为Date，在该函数用做某些函数的参数、而该参数要求DateTime类型的值时，Today()函数也能够在返回当前系统日期的同时返回当前系统时间。再如，Today()函数作为数据窗口控件SetItem()函数的参数，该函数参数中指定的数据窗口列的数据类型为DateTime，那么当前系统日期和时间将同时设置到数据窗口指定项中。

--------------------------------------------------------------------------------

Year()

功能得到日期值中的年度(有效取值1000到3000)。

语法Year(date)

参数date：date类型的值返回值Integer。函数执行成功时得到date参数中的年份（采用四位数字），发生错误时返回1900，如果date参数的值为NULL，则Year()函数返回NULL。用法当应用程序把有两位数字表示年份的字符串转换成日期时，PowerBuilder根据下述规则选择世纪：如果年份值在00到49之间，PowerBuilder将年份中的世纪（前两位数字）当作20；如果年份值在50到99之间，PowerBuilder将年份中的世纪（前两位数字）当作19。比如，字符串"20-10-25"被PowerBuilder转换为2020-10-25；字符串"98-10-25"被PowerBuilder转换为1998-10-25。因此，如果应用程序中需要指定1950年之前的日期，应该使用四位数字表示年份，以避免引起歧义。PowerBuilder能够处理的年份从1000到3000之间。

注册（Registry)函数

RegistryDelete()

功能删除Windows系统注册库中的一个键或键的某个值。

语法RegistryDelete ( key, valuename )

参数key：string类型，指定键名，将删除该键或删除该键的某个值valuename：string类型，指定要删除的值的名称。如果想删除键、键的值、以及其下的所有子键，那么将该参数指定为空字符串返回值Integer。函数执行成功时返回1，发生错误时返回-1。用法为了唯一地标识某个键，在key参数中，可以从根键开

始依次指定各级父键，各键之间使用反斜杠（\）分隔。

--------------------------------------------------------------------------------

RegistryGet()

功能从系统注册库中得到指定键的值。

语法RegistryGet ( key, valuename, valuetype, valuevariable )

参数key：string类型，指定键名valuename：string类型，指定要访问值的名称。每个键可以有一个未命名的值和多个命名的值。要访问未命名的值，把该参数指定为空字符串（""）valuetype:RegistryValueType枚举类型，指定值的数据类型。有效取值请参看用法valuevariable:用于保存键值的变量，其数据类型应该与valuetype参数指定的类型相匹配返回值Integer。函数执行成功时返回1，发生错误时返回-1。如果valuevariable的数据类型与valuetype参数指定的类型不匹配，将引发运行错误。

用法valuetype的可能取值为：RegString!以空字符结束的字符串RegExpandString!以空字符结束的字符串，其中包括了对环境变量的非扩展应用RegBinary!二进制数据ReguLong!32位数据ReguLongBigEndian!32位大数据RegLink!Unicode符号链RegMultiString!动态字符串数组为了唯一地标识某个键，在key参数中，可以从根键开始依次指定各级父键，各键之间使用反斜杠（\）分隔。

--------------------------------------------------------------------------------

RegistryKeys()

功能从系统注册库中得到指定键的有效子键。

语法RegistryKeys ( key, subkeys )

参数key：string类型，指定键名subkeys：字符串数组变量，用于保存各子键返回值Integer。函数执行成功时返回1，发生错误时返回-1。用法在subkeys 参数中可以使用定长数组，也可以使用动态数组。使用动态数组时，数组的上界反映了能够得到的子键个数。当使用定长数组时，其数组元素个数必须足够多，保证能够容纳所有子键，但是，在具体得到子键之前，没有办法能够预先知道实际子键个数。为了唯一地标识某个键，在key参数中，可以从根键开始依次指定各级父键，各键之间使用反斜杠（\）分隔。

--------------------------------------------------------------------------------

RegistrySet()

功能在系统注册库中设置或创建指定键。

语法RegistrySet ( key, valuename, valuetype, value )

参数key：string类型，指定键名valuename：string类型，指定要访问值的名称。每个键可以有一个未命名的值和多个命名的值。要访问未命名的值，把该参数指定为空字符串（""）。如果注册库中不存在指定值名，该函数将创建新的值名valuetype：RegistryValueType枚举类型，指定值的数据类型。有效取值请参看用法value：要设置的值，其数据类型应该与valuetype参数指定的类型相

匹配返回值Integer。函数执行成功时返回1，发生错误时返回-1。如果valuevariable的数据类型与valuetype参数指定的类型不匹配，将引发运行错误。用法valuetype的可能取值为：RegString!以空字符结束的字符串RegExpandString!以空字符结束的字符串，其中包括了对环境变量的非扩展应用RegBinary!二进制数据ReguLong!32位数据ReguLongBigEndian!32位大数据RegLink!Unicode符号链RegMultiString!动态字符串数组为了唯一地标识某个键，在key参数中，可以从根键开始依次指定各级父键，各键之间使用反斜杠（\）分隔。

--------------------------------------------------------------------------------

RegistryValues()

功能得到与指定键相关的一组值名。该函数在Windows 3.1中无效。

语法RegistryValues ( key, valuename )

参数key：string类型，指定键名valuename：字符串数组变量，用于保存值名返回值Integer。函数执行成功时返回1，发生错误时返回-1。用法在valuename 参数中可以使用定长数组，也可以使用动态数组。使用动态数组时，数组的上界反映了能够得到的值名个数。当使用定长数组时，其数组元素个数必须足够多，保证能够容纳所有值名，但是，在具体得到值名之前，没有办法能够预先知道实际值名个数。为了唯一地标识某个键，在key参数中，可以从根键开始依次指定各级父键，各键之间使用反斜杠（\）分隔。

定时函数

CPU()

功能得到自当前应用程序启动后开始CPU所消耗的时间，以毫秒为单位。

语法CPU()

返回值Long。返回自当前应用程序启动后开始CPU所消耗的时间，以毫秒为单位。

--------------------------------------------------------------------------------

Idle()

功能该函数在用户每次活动（例如，按键盘、移动鼠标等）后重置定时器，n秒后触发应用对象的Idle事件。

语法Idle ( n )

参数n：指定空闲时间间隔，以秒为单位。该参数的值设置为0时，停止空闲检测，不再触发应用对象的Idle事件返回值Integer。函数执行成功时返回1，此时启动定时器。如果不能启动定时器或定时器未启动而n的值指定为0时，函数返回-1。如果任何参数的值为NULL，Idle()函数返回NULL。用法利用Idle()函数，应用程序可以构造自己的屏幕保护程序，避免安全数据的泄露。当使用

Idle()函数已经启动了定时器后，如果再次以非0参数调用Idle()函数，那么该函数重设时间间隔，但并不启动新的定时器。Idle()函数启动定时器后，如果

在指定的时间间隔（从用户最近一次操作算起）内没有操作应用程序，那么就触发应用对象的Idle事件，在这个事件中可以编写关闭窗口、退出数据库登录等一系列代码，然后使用Restart()函数重新启动应用程序，起到保密的目的。发生下述任何情况时，系统自动重置定时器（即重新开始计时）：n 用户在该应用程序的任何窗口内移动鼠标或单击鼠标（双击鼠标时首先触发单击事件）n 在该应用程序的某个窗口是当前窗口时用户按下了任意一个或多个键n 在该应用程序的窗口最小化时，用户在该应用的图标上单击鼠标或移动鼠标n 在该应用程序的窗口最小化并且该应用程序是当前应用程序（应用名称被加亮显示）时，用户按了任何按键n 可视数据窗口检索数据时引起的编辑控件（指漂浮在数据窗口当前行/列上的编辑控件）重绘操作

--------------------------------------------------------------------------------

Timer()

功能在指定的时间间隔内反复触发指定窗口的定时器事件。

语法Timer ( interval {, windowname } )

参数interval：指定两次触发Timer事件之间的时间间隔，有效值在0到65之间。如果该参数的值指定为0，那么关闭定时器，不再触发指定窗口的Timer事件windowname：窗口名，指定时间间隔到时要触发哪个窗口的Timer事件。省略该参数时，触发当前窗口的Timer事件返回值Integer。函数执行成功时返回1，发生错误时返回-1。如果任何参数的值为NULL，Timer()函数返回NULL。用法使用Timer()函数可以周期性地触发指定窗口的Timer事件，这样，每当时间间隔过去时，应用程序都可以完成一些周期性的工作，比如绘制简单动画等。将Timer()的interval参数设置为非0值时启动定时器并开始计时；将该函数的interval参数设置为0时关闭定时器，终止计时任务。需要注意的是，在Microsoft Windows系统中，该函数能够计时的最小时间间隔为0.055秒（约1/18秒），如果把interval参数的值设置小于0.055，那么该定时器将每隔0.055秒触发一次窗口的Timer事件。Microsoft Windows 3.x最多只支持系统中同时启动16个定时器。

DDE客户函数

CloseChannel()

功能关闭先前用OpenChannel()函数打开的DDE服务器的通道。

语法CloseChannel ( handle {, windowhandle } )

参数handle：long类型，通道句柄，指明要关闭的DDE通道windowhandle：long 类型，可选项，指明用做DDE客户的PowerBuilder窗口的窗口句柄返回值Integer。函数执行成功时返回1，发生错误时返回下述值之一：-2通道不能被关闭-3不能确认服务器-9Handle参数的值为NULL

--------------------------------------------------------------------------------

ExecRemote()

功能请求DDE服务器应用程序执行命令。该函数有两种语法格式：语法一、直接向DDE服务器应用发送一条命令（冷连接方式）；语法二、应用程序打开某个通道后向DDE服务器应用发送命令（热连接方式）。下面分别予以介绍。

语法一、直接向DDE服务器应用发送一条命令（冷连接方式）；

语法ExecRemote ( command, applname, topicname )

参数command：string类型，其值为希望DDE服务器应用执行的命令，命令格式和语法需要参看DDE服务器应用的文档applname：string类型，指定服务器应用的DDE名称topicname：string类型，指定命令中要使用的DDE应用的数据或实例返回值Integer。函数执行成功时返回1，发生错误时返回下述值之一：-1未启动连接-2请求被拒绝-3不能终止服务器如果任何参数的值为NULL，ExecRemote()函数返回NULL。

语法二、应用程序打开某个通道后向DDE服务器应用发送命令（热连接方式）语法ExecRemote ( command, handle {, windowhandle } )

参数command：string类型，其值为希望DDE服务器应用执行的命令，命令格式和语法需要参看DDE服务器应用的文档handle：long类型，指定使用的DDE通道句柄windowhandle：long类型，可选项，指明用做DDE客户的PowerBuilder 窗口的窗口句柄。省略该参数时，当前应用中的活动窗口用做DDE客户返回值Integer。函数执行成功时返回1，发生错误时返回下述值之一：-1未启动连接-2请求被拒绝-9handle参数的值为NULL

--------------------------------------------------------------------------------

GetDataDDE()

功能从热连接服务器应用中获取数据，并将其保存到指定的字符串变量中。

语法GetDataDDE ( string )

参数string：string类型变量，用于保存接收到的数据返回值Integer。函数执行成功时返回1，发生错误时返回-1。如果任何参数的值为NULL，GetDataDDE()函数返回NULL。

--------------------------------------------------------------------------------

GetDataDDEOrigin()

功能确定来自热连接DDE服务器应用的数据源，成功时将应用的DDE标识保存在参数指定的变量中。

语法GetDataDDEOrigin ( applstring, topicstring, itemstring )

参数applstring：string类型变量，用于保存服务器应用的名称topicstring：string类型变量，用于保存主题（比如，在Excel中，主题可以是REGION.XLS）itemstring：string类型变量，用于保存数据项标识（比如，在Excel中，数据项标识可以是R1C2）返回值Integer。函数执行成功时返回1，发生错误时返回-1。如果任何参数的值为NULL，GetDataDDEOrigin()函数返回NULL。

--------------------------------------------------------------------------------

GetRemote()

功能请求服务器应用传送数据，该函数有两种格式：语法一、请求DDE服务器应用提供数据并将数据保存在变量中，该格式不要求事先打开通道，适用于仅发出少数几个请求的情况；语法二、请求DDE服务器应用提供数据并将数据保存在变量中，该格式适用于热连接的情况，即应用程序已经与服务器建立通道。下面分别予以介绍。

语法一、请求DDE服务器应用提供数据并将数据保存在变量中，该格式不要求事先打开通道，适用于仅发出少数几个请求的情况。

语法GetRemote ( location, target, applname, topicname )

参数location：string类型，指明要从DDE服务器的哪个位置返回数据。位置的表达方式由具体的DDE服务器决定target：string类型变量，用于保存返回的数据applname：string类型，指定DDE服务器应用的DDE名称topicname：string类型，指定命令中要使用的DDE应用的数据或实例返回值Integer。函数执行成功时返回1，发生错误时返回下述值之一：-1未启动连接-2请求被拒绝如果任何参数的值为NULL，GetRemote()函数返回NULL。

语法二、请求DDE服务器应用提供数据并将数据保存在变量中，该格式适用于热连接的情况，即应用程序已经与服务器建立通道。语法GetRemote ( location, target, handle {, windowhandle } )参数location：string类型，指明要从DDE服务器的哪个位置返回数据。位置的表达方式由具体的DDE服务器决定target：string类型变量，用于保存返回的数据handle：long类型，指定使用的DDE通道句柄 windowhandle：long类型，可选项，指明用做DDE客户的PowerBuilder窗口的窗口句柄。省略该参数时，当前应用中的活动窗口用做DDE 客户。使用handle()函数可以得到窗口句柄。返回值Integer。函数执行成功时返回1，发生错误时返回下述值之一：-1未启动连接-2请求被拒绝-9Handle参数的值为NULL

--------------------------------------------------------------------------------

OpenChannel()

功能打开连接DDE服务器的通道。

语法OpenChannel ( applname, topicname {, windowhandle } )applname：string 类型，指定DDE服务器应用的DDE名称topicname：string类型，指定命令中要使用的DDE应用的数据或实例windowhandle：long类型，可选项，指明用做DDE 客户的PowerBuilder窗口的窗口句柄。省略该参数时，当前应用中的活动窗口用做DDE客户返回值Long。函数执行成功时返回一个正数作为已打开通道的句柄，发生错误时返回下述值之一：-1打开失败-9句柄为NULL

--------------------------------------------------------------------------------

RespondRemote()

功能发送一条DDE消息，指示是否接受来自远程DDE应用的命令或数据。

语法RespondRemote ( boolean )

参数boolean：其值为boolean量的逻辑表达式，TRUE表示接收先前收到的命令或数据，FALSE表示不接收先前收到的命令或数据返回值Integer。函数执行成功时返回1，发生错误时返回-1。如果boolean参数的值为NULL，RespondRemote()

函数返回NULL。

--------------------------------------------------------------------------------

SetRemote()

功能请求服务器应用把指定项设置为指定值。该函数有两种语法格式：语法一、请求DDE服务器应用接收保存在指定位置的数据，该格式不要求事先打开通道，适用于仅发出少数几个请求的情况；语法二、请求DDE服务器应用接收保存在指定位置的数据，该格式适用于热连接的情况，即应用程序已经与服务器建立通道。下面分别予以介绍。

语法一、请求DDE服务器应用接收保存在指定位置的数据，该格式不要求事先打开通道，适用于仅发出少数几个请求的情况。

语法SetRemote ( location, value, applname, topicname )

参数location：string类型，指明要DDE服务器的哪一部分接收数据。位置的表达方式由具体的DDE服务器决定value：string类型变量，指定发送给DDE

服务器的数据applname：string类型，指定DDE服务器应用的DDE名称topicname：string类型，指定要接收数据的DDE应用的数据或实例返回值Integer。函数执行成功时返回1，发生错误时返回下述值之一：-1未启动连接-2请求被拒绝如果任何参数的值为NULL，SetRemote()函数返回NULL。

语法二、请求DDE服务器应用接收保存在指定位置的数据，该格式适用于热连接的情况，即应用程序已经与服务器建立通道。

语法SetRemote ( location, value, handle {, windowhandle } )

参数location：string类型，指明要DDE服务器的哪一部分接收数据。位置的表达方式由具体的DDE服务器决定value：string类型变量，指定发送给DDE

服务器的数据handle：long类型，指定使用的DDE通道句柄windowhandle：long 类型，可选项，指明用做DDE客户的PowerBuilder窗口的窗口句柄。省略该参数时，当前应用中的活动窗口用做DDE客户返回值Integer。函数执行成功时返回1，发生错误时返回下述值之一：-1未启动连接-2请求被拒绝-9Handle参数的值为NULL

--------------------------------------------------------------------------------

StartHotLink()

功能建立与DDE服务器应用的热连接，热连接建立之后，DDE服务器端相关数据的变化会立即触发PowerBuilder应用相关窗口的HotLinkAlarm事件。

语法StartHotLink ( location, applname, topic )

参数location：string类型，指明DDE服务器哪一部分数据变化时触发窗口的HotLinkAlarm事件。位置的表达方式由具体的DDE服务器决定applname：string 类型，指定DDE服务器应用的DDE名称topicname：string类型，指定数据改变将触发窗口的HotLinkAlarm事件的DDE应用的数据或实例返回值Integer。函数执行成功时返回1，发生错误时返回下述值之一：-1无指定服务器-2请求被拒绝如果任何参数的值为NULL，StartHotLink()函数返回NULL。

--------------------------------------------------------------------------------

StopHotLink()

功能关闭与DDE服务器应用的热连接。

语法StopHotLink ( location, applname, topic )

参数location：string类型，指明要终止DDE服务器哪一部分的热连接。位置的表达方式由具体的DDE服务器决定applname：string类型，指定DDE服务器应用的DDE名称topicname：string类型，指定要终止热连接的DDE应用的数据或实例返回值Integer。函数执行成功时返回1，发生错误时返回下述值之一：-1连接未曾启动-2请求被拒绝-3不能终止服务器如果任何参数的值为NULL，StopHotLink()函数返回NULL。

DDE服务器函数

GetCommandDDE()

功能得到DDE客户应用发送的命令。

语法GetCommandDDE ( string )

参数string：string类型的变量，用于保存DDE客户应用发送的命令返回值Integer。函数执行成功时返回1，发生错误时返回-1。如果string参数的值为NULL， GetCommandDDE()函数返回NULL。用法当DDE客户应用向DDE服务器应用发送一条命令时，这个动作将触发DDE服务器应用活动窗口的RemoteExec事件，在这个事件的事件处理程序中，可以使用GetCommandDDE()函数得到DDE客户应用发送的命令。

--------------------------------------------------------------------------------

GetCommandDDEOrigin()

功能确定哪一个DDE客户应用向服务器发送了命令。

语法GetCommandDDEOrigin ( applstring )

参数applstring：string变量，用于保存发送命令的DDE客户应用的名称返回值Integer。函数执行成功时返回1，发生错误时返回-1。如果applstring参数的值为 NULL，GetCommandDDEOrigin()函数返回NULL。

--------------------------------------------------------------------------------

GetDataDDE()

功能得到DDE客户应用发送的数据。

语法GetDataDDE ( string )

参数string：string类型变量，用于保存接收到的数据返回值Integer。函数执行成功时返回1，发生错误时返回-1。如果任何参数的值为NULL，GetDataDDE()函数返回NULL。

--------------------------------------------------------------------------------

GetDataDDEOrigin()功能确定哪个DDE客户应用发送了数据。

语法GetDataDDEOrigin ( applstring, topicstring, itemstring )

参数applstring：string类型变量，用于保存客户应用的名称topicstring：string类型变量，用于保存主题（比如，在Excel中，主题可以是REGION.XLS）itemstring：string类型变量，用于保存数据项标识（比如，在Excel中，数据项标识可能是R1C2）返回值Integer。函数执行成功时返回1，发生错误时返回-1。如果任何参数的值为NULL，GetDataDDEOrigin()函数返回NULL。

--------------------------------------------------------------------------------

RespondRemote()

功能向客户端应用指明最近的命令或数据是否已经接收。

语法RespondRemote ( boolean )

参数boolean：其值为boolean量的逻辑表达式，TRUE表示接收先前收到的命令或数据，FALSE表示不接收先前收到的命令或数据返回值Integer。函数执行成功时返回1，发生错误时返回-1。如果boolean参数的值为NULL，RespondRemote()函数返回NULL。

--------------------------------------------------------------------------------

SetDataDDE()

功能向DDE客户应用发送数据。

语法SetDataDDE ( string {, applname, topic, item } )

参数string：指定要发送到DDE客户应用的数据applname：string类型，可选项，指定接收数据的客户应用的DDE名称topic：string类型，可选项，指定基础数据组item：string类型，可选项，指定基础数据组中的数据项返回值Integer。函数执行成功时返回1，发生错误时返回下述值之一：-1函数调用的环境不对-2数据未被接收如果任何参数的值为NULL，SetDataDDE()函数返回NULL。

--------------------------------------------------------------------------------

StartServerDDE()

功能将当前应用设置为DDE服务器。

语法StartServerDDE ( { windowname, } applname, topic {, item } )

参数windowname：可选项，指定服务器窗口名，缺省值为当前窗口applname：当前应用的DDE名称topic：string类型，指定DDE客户应用能够引用的基本数据组item：由逗号（,）分隔的一个或多个字符串，指定服务器应用支持的数据项返回值Integer。函数执行成功时返回1，发生错误时返回-1，表示当前应用已经设置为DDE服务器。如果任何参数的值为NULL，StartServerDDE()函数返回NULL。

--------------------------------------------------------------------------------

StopServerDDE()

功能停止当前应用的DDE服务器功能。执行该函数后，发给该应用的任何DDE

客户应用请求都将失败。

语法StopServerDDE ( { windowname, } applname, topic )

参数windowname：可选项，指定要关闭服务器功能的服务器窗口名，缺省值为当前窗口，如果当前应用有多个服务器窗口，那么必须指定该参数applname：当前应用的DDE名称topic：string类型，应该与StartServerDDE()中对应参数相同返回值Integer。函数执行成功时返回1，发生错误时返回-1，表示当前应用未曾作为DDE服务器启动。如果任何参数的值为NULL，StopServerDDE()函数返回NULL。

查看文章

PowerBuilder函数全集[1].1

2009-04-06 18:34

printdefinefont()

功能定义打印作业使用的字体，对每个打印作业powerbuilder支持八种字体。语法

printdefinefont(printjobnumber,fontnumber,facename,height,weight,font pitch,fontfamily, italic,underline)

参数printjobnumber：用printopen()函数打开的打印作业号fontnumber：指定赋给当前定义字体的编号，有效值在1到8之间 facename：string类型，指定字体名称，该字体应该是你的打印机支持的字体，比如“宋体”height：integer类型，使用正值指定字体的高度，以千分之一英寸为单位；使用负值指定字体点数，比如，-18代表18点。一般来说，使用点数更精确些weight：指定字体的磅数，正常字体为400磅，粗体为700磅fontpitch：fontpitch枚举类型，指定字体标准。有效取值为：default! - 缺省值；fixed! - 固定形式；variable! - 可变形式fontfamily：fontfamily枚举类型，指定字体系列。有效取值为：anyfont!、decorative!、modern!、roman!、script!、swiss!italic：boolean类型，指定是否使用斜体样式。有效取值为：true - 使用斜体样式；false - 不使用斜体样式。缺省值为falseunderline：boolean类型，指定是否加下划线。有效取值为：true - 加下划线；false - 不加下划线。缺省值为false 返回值integer。函数执行成功时返回1，发生错误时返回-1。如果任何参数的值为null，printdefinefont()函数返回null。用法在一个打印作业中，应用程序能够最多同时定义8种字体。当应用程序需要使用更多的字体时，可以在使用了某个字体号输出内容后使用printdefinefont()函数将该字体号对应的字体

更换为其它字体。

printline()

功能在当前打印页上绘出指定厚度的一条线。

语法printline ( printjobnumber, x1, y1, x2, y2, thickness )

参数printjobnumber：用printopen()函数打开的打印作业号x1：integer类型，指定直线起点的x坐标，以千分之一英寸为单位y1：integer类型，指定直线起点的y坐标，以千分之一英寸为单位x2：integer类型，指定直线终点的x坐标，以千分之一英寸为单位y2：integer类型，指定直线终点的y坐标，以千分之一