◇◇◇PowerBuilder函数大全4◇◇◇
窗口操作函数
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对象中的值，调用CloseWithReturn()函数的代码段通过查看Message对象属性的值得到关闭窗口时被关闭窗口传递的值。returnvalue参数必须是下述三种类型之一：String、Numeric、PowerObject返回值Integer。函数执行成功时返回1，发生错误时返回-1。如果参数任何的值为NULL，CloseWithReturn()函数返回NULL。
--------------------------------------------------------------------------------
Open()
功能 打开窗口。该函数有两种语法格式：
语法一、打开编程时已知数据类型的窗口对象；
语法二、打开程序运行后才能确定数据类型的窗口对象。下面分别予以介绍：
语法一、打开编程时已知数据类型的窗口对象
语法Open ( windowvar {, parent } )
参数windowvar：要打开窗口的窗口名，可以使用窗口画笔定义的窗口对象名，也可以使用该窗口对象的某个变量。Open()函数把打开窗口的引用放置到windowvar变量中parent：可选项，指定要打开窗口的父窗口，要打开窗口成为父窗口的子窗口，只有当要打开窗口需要成为某个窗口的子窗口时才需要指定该参数。如果应用程序使用Open()函数打开某个子窗口或弹出窗口而又省略了该参数，那么当前活动窗口成为被打开窗口的父窗口返回值Integer。函数执行成功时返回1，发生错误时返回-1。如果任何参数的值为NULL，Open()函数返回NULL。
语法二、打开程序运行后才能确定数据类型的窗口对象
语法Open ( windowvar, windowtype {, parent } )
参数windowvar：指定窗口变量名，Open()函数把打开窗口的引用放置到该变量中windowtype：string类型，指定要打开窗口的数据类型，该参数指定的窗口数据类型必须与windowvar参数的类型相同或是windowvar类型的后继对象parent：可选项，指定要打开窗口的父窗口，要打开窗口成为父窗口的子窗口，只有当要打开窗口需要成为某个窗口的子窗口时才需要指定该参数。如果应用程序使用Open()函数打开某个子窗口或弹出窗口而又省略了该参数，那么当前活动窗口成为被打开窗口的父窗口返回值Integer。函数执行成功时返回1，发生错误时返回-1。如果任何参数的值为NULL，Open()函数返回NULL。
--------------------------------------------------------------------------------
OpenSheet()
功能在MDI框架窗口中打开MDI子窗口，并在指定菜单中创建选择该子窗口的菜单项。
语法OpenSheet(sheetrefvar{,windowtype},mdiframe{,position{,arrangeopen}})
参数sheetrefvar：指定要作为工作表打开的窗口名windowtype：string类型，可选项，指定要打开窗口的类型（也就是窗口画笔中保存的窗口对象名）mdiframe：指定要放置工作表的MDI框架窗口名position：可选参数，指定所打开的工作表的名称作为一个菜单项显示在第几个菜单标题下面，缺省时，被放在倒数第二个菜单标题下，原因是，大多数商业软件的最后两个菜单标题是Window和Help，把工作表的名称放到Window菜单标题中用于选择工作表窗口是个合情合理的选择arrangeopen：ArrangeOpen枚举类型，可选参数，但如果选用了此参数，那么position参数也必须同时指定。arrangeopen参数告诉系统如何显示打开的工作表返回值Integer。函数执行成功时返回1，发生错误时返回-1。如果参数任何的值为NULL，OpenSheet()函数返回NULL。
用法arrangeopen参数的可能取值为：Cascaded!把一个工作表放在另一个的上面，每个都向右下方偏移一点，这样所有工作表的标题栏用户都能看到。该值是OpenSheet()函数的缺省选择。Layered!将工作表显示在客户区的左上角，并最大化工作表，使其充满MDI框架窗口的整个客户区。Original!操作动作与Cascaded!参数相同，只是不放大窗口，而以窗口定义时的大小显示。
--------------------------------------------------------------------------------
OpenSheetWithParm()
功能 在MDI框架窗口中打开MDI子窗口，同时把参数保存在Message对象中进行传递。
语法OpenSheetWithParm(sheetrefvar,parameter{,windowtype},mdiframe{,position{,arrangeopen}}
参数sheetrefvar：指定要作为工作表打开的窗口名parameter：指定要传递给打开工作表的数据，该数据保存在Message对象的属性中， parameter参数的数据类型必须是下述三种类型之一：String、Numeric、PowerObjectwindowtype：string类型，可选项，指定是要打开窗口的类型（也就是窗口画笔中保存的窗口对象名）mdiframe：指定要放置工作表的MDI框架窗口名position：可选参数，指定所打开的工作表的名称作为一个菜单项显示在第几个菜单标题下面，缺省时，被放在倒数第二个菜单标题下，原因是，大多数商业软件的最后两个菜单标题是Window和Help，把工作表的名称放到Window菜单标题中用于选择工作表窗口是个合情合理的选择arrangeopen：ArrangeOpen枚举类型，可选参数，但如果选用了此参数，那么position参数也必须同时指定。arrangeopen参数告诉系统如何显示打开的工作表返回值Integer。函数执行成功时返回1，发生错误时返回-1。如果参数任何的值为NULL，OpenSheet()函数返回NULL。
用法arrangeopen参数的可能取值为：Cascaded!把一个工作表放在另一个的上面，每个都向右下方偏移一点，这样所有工作表的标题栏用户都能看到。该值是OpenSheet()函数的缺省选择。Layered!将工作表显示在客户区的左上角，并最大化工作表，使其充满MDI框架窗口的整个客户区。Original!操作动作与Cascaded!参数相同，只是不放大窗口，而以窗口定义时的大小显示。
--------------------------------------------------------------------------------
OpenWithParm()
功能带参数打开窗口，与打开窗口的Open()函数相似，OpenWithParm()有两种语法格式：
语法一、带参数打开编程时已知数据类型的窗口对象；
语法二、带参数打开程序运行后才能确定数据类型的窗口对象。下面分别予以介绍：
语法一、带参数打开编程时已知数据类型的窗口对象
语法OpenWithParm(windowvar,parameter{,parent})
参数windowvar：要打开窗口的窗口名，可以使用窗口画笔定义的窗口对象名，也可以使用该窗口对象的某个变量。Open()函数把打开窗口的引用放置到windowvar变量中parameter：指定要传递给打开窗口的数据，该数据保存在Message对象的属性中，parameter参数的数据类型必须是下述三种类型之一：String、Numeric、PowerObjectparent：可选项，指定要打开窗口的父窗口，要打开窗口成为父窗口的子窗口，只有当要打开窗口需要成为某个窗口的子窗口时才需要指定该参数。如果应用程序使用Open()函数打开某个子窗口或弹出窗口而又省略了该参数，那么当前活动窗口成为被打开窗口的父窗口返回值Integer。函数执行成功时返回1，发生错误时返回-1。如果任何参数的值为NULL，OpenWithParm()函数返回NULL。
用法消息对象Message有三个属性用于存储OpenWithParm()函数传递给打开窗口的数据。根据parameter参数数据类型的不同，该参数的值保存在Message对象的不同属性中。
语法二、带参数打开程序运行后才能确定数据类型的窗口对象
语法OpenWithParm(windowvar,parameter,windowtype{,parent})
参数windowvar：指定窗口变量名，Open()函数把打开窗口的引用放置到该变量中parameter：指定要传递给打开窗口的数据，该数据保存在Message对象的属性中，parameter参数的数据类型必须是下述三种类型之一：String、Numeric、PowerObjectwindowtype：string类型，指定要打开窗口的数据类型，该参数指定的窗口数据类型必须与windowvar参数的类型相同或是windowvar类型的后继对象parent：可选项，指定要打开窗口的父窗口，要打开窗口成为父窗口的子窗口，只有当要打开窗口需要成为某个窗口的子窗口时才需要指定该参数。如果应用程序使用Open()函数打开某个子窗口或弹出窗口而又省略了该参数，那么当前活动窗口成为被打开窗口的父窗口返回值Integer。函数执行成功时返回1，发生错误时返回-1。如果任何参数的值为NULL，OpenWithParm()函数返回NULL。
国际化函数
IsAllArabic()
功能确定指定的字符串是否全部由阿拉伯文字符组成，该函数只能在PowerBuilder的阿拉伯文版本中使用。
语法IsAllArabic ( string )
参数string：要测试的字符串返回值Boolean。如果string的内容全部由阿拉伯文字符组成，那么函数返回TRUE，否则返回FALSE。字符串中如果包含数字、空格、标点符号，那么该函数也返回FALSE。如果PowerBuilder不是阿拉伯文版本，该函数总是返回FALSE。
--------------------------------------------------------------------------------
IsAllHebrew()
功能确定指定的字符串是否全部由希伯来文字符组成，该函数只能在PowerBuilder的希伯来文版本中使用。
语法IsAllHebrew( string )
参数string：要测试的字符串返回值Boolean。如果string的内容全部由希伯来文字符组成，那么函数返回TRUE，否则返回FALSE。字符串中如果包含数字、空格、标点符号，那么该函数也返回FALSE。如果PowerBuilder不是希伯来文版本，该函数总是返回FALSE。
--------------------------------------------------------------------------------
IsAnyArabic()
功能确定指定的字符串中是否包含阿拉伯文字符，该函数只能在PowerBuilder的阿拉伯文版本中使用。
语法IsAnyArabic( string )
参数string：要测试的字符串返回值Boolean。如果string中至少包含一个阿拉伯文字符成，那么函数返回TRUE，否则返回FALSE。如果PowerBuilder不是阿拉伯文版本，该函数总是返回FALSE。
--------------------------------------------------------------------------------
IsAnyHebrew()
功能确定指定的字符串中是否包含希伯来文字符，该函数只能在PowerBuilder的希伯来文版本中使用。
语法IsAnyArabic( string )
参数string：要测试的字符串返回值 Boolean。如果string中至少包含一个希伯来文字符，那么函数返回TRUE，否则返回FALSE。如果PowerBuilder不是希伯来文版本，该函数总是返回FALSE。
--------------------------------------------------------------------------------
IsArabic()
功能确定指定的字符是否是阿拉伯文字符，如果参数为字符串，则只检查左边第一个字符是否是阿拉伯文字符。该函数只能在PowerBuilder的阿拉伯文版本中使用。
语法IsArabic ( character )
参数character：要测试的字符或字符串返回值Boolean。如果character是阿拉伯文字符，那么函数返回TRUE，否则返回FALSE。如果PowerBuilder不是阿拉伯文版本，该函数总是返回FALSE。
--------------------------------------------------------------------------------
IsArabicAndNumbers()
功能确定指定的字符串是否全部由阿拉伯文字符或数字组成，该函数只能在PowerBuilder的阿拉伯文版本中使用。
语法IsArabicAndNumbers ( string )
参数string：要测试的字符串返回值Boolean。如果string的内容全部由阿拉伯文字符或数字组成，那么函数返回TRUE，否则返回FALSE。如果PowerBuilder不是阿拉伯文版本，该函数总是返回FALSE。
--------------------------------------------------------------------------------
IsHebrew()
功能确定指定的字符是否是希伯来文字符，如果参数为字符串，则只检查左边第一个字符是否是希伯来文字符。该函数只能在PowerBuilder的希伯来文版本中使用。
语法IsArabic ( character )
参数character：要测试的字符或字符串返回值Boolean。如果character是希伯来文字符，那么函数返回TRUE，否则返回FALSE。如果PowerBuilder不是希伯来文版本，该函数总是返回FALSE。
--------------------------------------------------------------------------------
IsHebrewAndNumbers()
功能确定指定的字符串是否全部由希伯来文字符或数字组成，该函数只能在PowerBuilder的希伯来文版本中使用。
语法IsArabicAndNumbers ( string )
参数string：要测试的字符串返回值Boolean。如果string的内容全部由希伯来文字符或数字组成，那么函数返回TRUE，否则返回FALSE。如果PowerBuilder不是希伯来文版本，该函数总是返回FALSE。
--------------------------------------------------------------------------------
Reverse()
功能颠倒字符串中字符次序。
语法Reverse ( string )
参数string：要颠倒字符次序的字符串返回值String。函数执行成功时返回颠倒字符次序后的字符串，如果发生错误，那么返回空字符串（""）。用法Reverse()函数将一个字符串中最后一个字符放置到另一个字符串的第一个字符位置、倒数第二个字符放置在另一个字符串的第二个字符位置，以此类推。
--------------------------------------------------------------------------------
ToAnsi()
功能将Unicode字符转换成ANSI字符。
语法ToAnsi ( string )
参数string：要进行转换的Unicode编码的字符串返回值Blob。函数执行成功时返回指定字符串对应的ANSI编码的blob类型数据，发生错误时返回空值（NULL）。
--------------------------------------------------------------------------------
ToUnicode()
功能将ANSI字符转换成Unicode字符。
语法ToUnicode( blob)
参数blob：要进行转换的ANSI编码的blob类型数据返回值String。函数执行成功时返回指定字符串对应的Unicode编码的字符串，发生错误时返回空字符串。
其他函数
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计量的相同单位数将绘出正方形。因此，在进行单位转换时，需要指明按那么方向进行转换。
