?? pbhspage17.htm
字號:
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=gb2312">
<meta name="GENERATOR" content="Microsoft FrontPage 4.0">
<meta name="ProgId" content="FrontPage.Editor.Document">
<title>Beep</title>
<style type="text/css">
<!--
td { font-family: "宋體", "Arial", "MS Sans Serif"; font-size: 9pt}
body { font-family: "宋體", "Arial", "MS Sans Serif"; font-size: 9pt}
.mytd { line-height: 13pt}
a {text-decoration:none}
a:hover {color: red;text-decoration:underline，target="window_name"}
-->
</style>
</head>
<body>
<ul>
<li><b>Beep()</b><br>
功能響鈴n次（n超過10時只響10次）。<br>
語法Beep ( n )<br>
參數n：數值類型，指定需要的響鈴次數。如果n的值大于10，那么計算機只響鈴10次返回值Integer。函數執行成功時返回1，發生錯誤時返回-1。如果參數n的值為NULL，Beep()函數返回NULL。
<hr>
</li>
<li><b>ClassName()<br>
</b>功能確定指定變量的類（數據類型）。<br>
語法ClassName(variable)<br>
參數variable：指定要確定其數據類型的變量返回值String。函數執行成功時返回指定變量的數據類型，發生錯誤時返回空字符串。如果參數variable的值為NULL，ClassName()函數返回NULL。用法需要注意的是，ClassName()函數不能確定枚舉類型變量的類型，此時，ClassName()函數返回空字符串（""）。
<hr>
</li>
<li><b>DebugBreak()<br>
</b>功能暫停程序執行，打開調試器，進入調試模式。<br>
語法DebugBreak ( )<br>
返回值無用法 DebugBreak()函數可以幫助你調試應用程序。如果你希望應用程序執行某條語句后暫停執行，然后進入調試模式，那么可以在該語句后面放上DebugBreak()函數，應用程序執行到DebugBreak()函數后，打開Debug（調試）窗口，并在其中顯示當前上下文信息。這種方式實現了應用程序在PowerBuilder開發環境中的即時調試功能。
<hr>
</li>
<li><b>IntHigh()</b><br>
功能得到Long型值的高位字。<br>
語法IntHigh ( long )<br>
參數long：long型值或變量返回值 Integer。函數執行成功時返回參數long的高位字，發生錯誤時返回-1。如果參數long的值為NULL，IntHigh()函數返回NULL。用法IntHigh()函數通常用于分解外部C或C++語言函數的返回值和Windows消息。
<hr>
</li>
<li><b>IntLow()<br>
</b>功能得到Long型值的低位字。<br>
語法IntLow ( long )<br>
參數long：long型值或變量返回值Integer。函數執行成功時返回參數long的低位字，發生錯誤時返回-1。如果參數long的值為NULL，IntLow()函數返回NULL。用法IntLow()函數通常用于分解外部C或C++語言函數的返回值和Windows消息。示例請參看IntHigh()函數。
<hr>
</li>
<li><b>IsValid()<br>
</b>功能檢查對象變量是否已經實例化，即實例變量的值是否是個有效的對象句柄。<br>
語法IsValid ( objectname )<br>
參數objectname：要檢測的對象名返回值Boolean。如果指定對象已經創建了對象實例，那么IsValid()函數返回TRUE，否則返回FALSE。如果參數objectname的值為NULL，IsValid()函數返回NULL。
<hr>
</li>
<li><b>KeyDown()</b><br>
功能檢查用戶是否按了鍵盤上指定的鍵。<br>
語法KeyDown ( keycode )<br>
參數 keycode：KeyCode枚舉類型或integer類型，指明要檢測的按鍵或某個鍵的ASCII值返回值Boolean。如果用戶按了keycode參數指定的按鍵，函數返回TRUE，否則返回FALSE。如果參數keycode的值為NULL，KeyDown()函數返回NULL。用法KeyDown()函數通常在某個事件的事件處理程序中調用，它并不指明用戶鍵入了哪個字符，而是說明當前事件（即事件處理程序中調用KeyDown()函數的事件）發生時用戶正按著哪個按鍵。一般來說，應用程序在窗口的Key事件或控件的按鍵事件中調用KeyDown()函數，以檢測用戶是否按了某個特殊鍵。對控件來說，PowerBuilder沒有定義預定義的Key事件，這也沒有關系，如果在控件得到焦點后希望應用程序檢測用戶的按鍵，只要對該控件定義一個用戶事件，并把pbm_keydown （其它控件）或pbm_dwnkey（數據窗口控件）映射到該用戶事件上即可。
<hr>
</li>
<li><b>MessageBox()<br>
</b>功能顯示一個消息對話框。<br>
語法MessageBox(title,text{,icon{,button{,default}}})<br>
參數title：string類型，指定消息對話框的標題text：指定消息對話框中顯示的消息，該參數可以是數值數據類型、字符串或boolean值icon：Icon枚舉類型，可選項，指定要在該對話框左側顯示的圖標button：Button枚舉類型，可選項，指定顯示在該對話框底部的按鈕default：數值型，可選項，指定作為缺省按鈕的按鈕編號，按鈕編號自左向右依次計數，缺省值為1，如果該參數指定的編號超過了顯示的按鈕個數，那么MessageBox()函數將使用缺省值返回值Integer。函數執行成功時返回用戶選擇的按鈕編號（例如1、2、3等），發生錯誤時返回-1。如果任何參數的值為NULL，MessageBox()函數返回NULL。<br>
用法當你的應用程序需要顯示一段簡短信息（比如顯示出錯、警告等信息）時，沒有必要自己從頭創建窗口、安排控件，使用MessageBox()函數既簡單又方便。用戶只有響應該窗口后，程序才能繼續運行下去。MessageBox()函數的icon參數指定顯示在窗口中的圖標，它是枚舉類型，可能取值為： 取值 圖標Information! StopSign! Exclamation! Question! None! 無圖標其中Information!是Icon參數的缺省值。Button參數指定在窗口中顯示哪些按鈕，有效取值為：取值中文Windows 95下顯示OK!“確定”按鈕OKCancel!“確定”、“取消”按鈕YesNo!“是”、“否”按鈕 YesNoCancel!“是”、“否”、“取消”按鈕RetryCancel!“重試”、“取消”按鈕AbortRetryIgnore!“終止”、“重試”、“忽略”按鈕
<hr>
</li>
<li><b>PixelsToUnits()</b><br>
功能 將像素值轉換為PowerBuilder單位PBU。<br>
語法PixelsToUnits ( pixels, type )<br>
參數pixels：integer類型，指定要轉換為PowerBuilder單位的像素數type：ConvertType枚舉類型，指定按哪個方向進行轉換。有效取值為：XPixelsToUnits! - 按水平方向轉換像素；YPixelsToUnits! - 按垂直方向轉換像素返回值Integer。函數執行成功時返回pixels參數指定像素數按指定方向轉換成的PowerBuilder單位數，發生錯誤時返回-1。如果任何參數的值為NULL，PixelsToUnits()函數返回NULL。用法窗口中水平方向和垂直方向相同的像素數表示的距離并不相同。如果你使用水平方向和垂直方向相同的像素數繪制一個方框，那么你會看到，該方框不是正方形而是個矩形，而使用PBU計量的相同單位數將繪出正方形。因此，在進行單位轉換時，需要指明按那么方向進行轉換。
<hr>
</li>
<li><b>PopulateError()</b><br>
功能以應用程序定制的錯誤號和錯誤信息填充Error對象，該函數不觸發應用對象的SystemError事件。<br>
語法PopulateError ( number, text )<br>
參數number：integer類型，指定要保存到Error對象number屬性中的值text：string類型，指定要保存到Error對象text屬性中的值返回值Integer。函數執行成功時返回1，發生錯誤時返回-1。<br>
用法當應用程序需要根據變量的當前取值來定制Error對象時，可以使用PopulateError()函數來填充Error對象的number和text屬性，同時該函數根據上下文自動填充Error對象的其它屬性。定制了Error對象后，應用程序可以使用不帶參數的SignalError()函數觸發應用對象的SystemError事件。這樣，在SystemError事件的事件處理程序中可以編寫處理定制錯誤和系統錯誤的通用代碼。如果應用程序沒有對SystemError事件編寫事件處理程序，那么SignalError()函數什么也不做。
<hr>
</li>
<li><b>RGB()</b><br>
功能將代表紅、綠、藍三原色的三個整數組合成一個表示顏色的長整數。<br>
語法RGB ( red, green, blue )<br>
參數red：integer類型，指定顏色中的紅色分量強度，有效值在0到255之間green：integer類型，指定顏色中的綠色分量強度，有效值在0到255之間blue：integer類型，指定顏色中的藍色分量強度，有效值在0到255之間返回值Long。函數執行成功時返回由指定分量確定的顏色，用長整數表示。發生錯誤時返回-1。如果任何參數的值為NULL，RGB()函數返回NULL。<br>
用法RGB()函數使用下述公式計算表示顏色的長整數：65536 * Blue+ 256 * Green+ Red其中，Blue代表藍色分量，Green代表綠色分量，Red代表紅色分量。各分量中，數值越小，亮度越低，數值越大，亮度越高。例如，RGB ( 0, 0, 0 )為黑色（亮度最低），RGB ( 255, 255,255 )為白色（亮度最高）。
<hr>
</li>
<li><b>SetNull()</b><br>
功能將指定變量的值設置為NULL。這里的變量可以是除數組、結構、自動實例化對象之外的任何數據類型。<br>
語法SetNull ( anyvariable )<br>
參數anyvariable：要將其值設置為NULL的變量返回值Integer。函數執行成功時返回1，發生錯誤時返回-1。如果任何參數的值為NULL，SetNull()函數返回NULL。用法PowerBuilder應用程序在說明變量時，并不自動地將其初值設置為NULL，而是根據類型的不同而設置不同的初值，比如，數值類型的變量自動初始化為0，字符串型變量自動初始化為空字符串（""）。因此，如果需要將某個變量的值設置為NULL，就需要使用SetNull()函數來完成任務了。一般來說，NULL值往往應用在數據庫值未確定的列上。
<hr>
</li>
<li><b>SetPointer()<br>
</b>功能設置鼠標指針。<br>
語法SetPointer ( type )<br>
參數type：Pointer枚舉類型，指明要設置為哪種鼠標指針返回值Pointer。返回更換前的鼠標指針，以便于應用程序恢復原有指針。如果參數type的值為NULL，SetPointer()函數返回NULL。用法type參數的可能取值為：Arrow!、Cross!、Beam!、HourGlass!、SizeNS!、SizeNESW!、SizeWE!、SizeNWSE!、UpArrow!。
<hr>
</li>
<li><b>SignalError()<br>
</b>功能以編程方式觸發應用對象的SystemError事件。<br>
語法SignalError ( { number }, { text } )<br>
參數number：integer類型，可選項，指定出錯編號，該編號將保存到Error對象的number屬性中text：string類型，可選項，指定出錯信息，該信息將保存到Error對象的text屬性中返回值Integer。函數執行成功時返回1，發生錯誤時返回-1。用法SignalError()函數通常用于測試應用程序的出錯處理代碼，它以人工方式產生錯誤，以此模擬應用程序運行過程中可能出現的錯誤。我們知道，應用程序本身產生錯誤的條件往往不容易在測試時遇到。當應用程序使用PopulateError()函數定制了Error對象后，可以以不帶參數的方式調用SignalError()函數，由該函數觸發應用對象的SystemError事件。如果我們在調用SignalError()函數時指定了參數number和text，那么SignalError()函數將根據上下文填充Error對象的所有屬性，然后觸發應用對象的SystemError事件。如果應用程序沒有對應用對象的SystemError事件編寫事件處理程序，那么SignalError()函數什么也不做。
<hr>
</li>
<li><b>UnitsToPixels()</b><br>
功能將PowerBuilder單位（PBU）轉換為像素。<br>
語法UnitsToPixels ( units, type )<br>
參數units：integer類型，指定要轉換為像素的PowerBuilder單位（PBU）數type：ConvertType枚舉類型，指定按哪個方向進行轉換。有效取值為：XUnitsToPixels! - 按水平方向轉換PBU；YUnitsToPixels! - 按垂直方向轉換PBU返回值Integer。函數執行成功時返回units參數指定PBU數按指定方向轉換成的像素數，發生錯誤時返回-1。如果任何參數的值為NULL，UnitsToPixels()函數返回NULL。用法窗口中水平方向和垂直方向相同的像素數表示的距離并不相同。如果你使用水平方向和垂直方向相同的像素數繪制一個方框，那么你會看到，該方框不是正方形而是個矩形，而使用PBU計量的相同單位數將繪出正方形。因此，在進行單位轉換時，需要指明按那么方向進行轉換。</li>
</ul>
<p> </p>
<p> </p>
<p align="center">PB編程地帶 <font color="#0000FF">版權所有</font></p>
</body>
</html>
?? 快捷鍵說明
復制代碼
Ctrl + C
搜索代碼
Ctrl + F
全屏模式
F11
切換主題
Ctrl + Shift + D
顯示快捷鍵
?
增大字號
Ctrl + =
減小字號
Ctrl + -