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顯示為：[phone]對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。

功能将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）的介紹。