Chapter 12

Formula


 

12.12 特殊 (special)

 

FormName()

SetTitle(title)

GetTitle()

FormPos(left,top)

FormSize(width,height)

FormX()

FormY()

FormW()

FormH()

FormDate()

FormDir()

SnapShot(png_file)

SnapShot(png_file, frame)

IsAdmin()

UserName()

UserPasswoed()

UserGroup()

HttpCodeBase()

UncCodePath()

SetLang(lang)

SetLang(lang, font)

OsLang()

IsLang(lang)

ClientName()

ClientIp()

ApserverName()

ApserverIp()

AddCookie(name,value,comment,maxage)

AddCookie(name,value,comment,maxage,path)

GetCookie(name)

GetServletResp(event.param)

Beep()

RGB(red,green,blue)

BarCode(x)

BarCode(x,addchecksum)

IdCheck(x)

CompanyId(x)

ChiNum(x)

LastUsePrinter()

MWHTTP()

MWHTTP(alias)

IsGrantOpen(formname)

IsAuthItem(item)

 

FormName()

 

說明: 取得視窗 class 名稱。
參數: 無。
傳回值: 視窗 class 名稱。
範例:

 FormName()。

 

▲Top

 

 

SetTitle(title)

 

說明: 動態變更視窗標題。
參數: "title":視窗標題,常數字串須加上引號。
傳回值: 設定的名稱 (title)。
範例:

將視窗抬頭文字設定為目前資料來源記錄的客戶名稱 。
SetTitle({Customers:CustomerName})

 

▲Top

 

 

GetTitle()

 

說明: 讀取視窗標題。
參數: 無。
傳回值: 設定的標題名稱 (title)。
範例:

GetTitle()

 

▲Top

 

 

 

FormPos(left,top)

 

說明: 動態變更視窗的位置。
參數: "left":與主視窗左邊界的距離,單位是像素 (pixel)。
"top":與主視窗上邊界的距離,單位是像素 (pixel)。
傳回值: 成功執行傳回 1 ,否則傳回 0。
範例:

 FormPos(50,10)

 

▲Top

 

 

FormSize(width,height)

 

說明: 動態變更視窗的大小。
參數: "width":視窗寬度,單位是像素 (pixel)。
"height":視窗長度,單位是像素 (pixel)。
傳回值: 成功執行傳回 1 ,否則傳回 0。
範例:

 FormSize(600,400)

 

▲Top

 

 

 

FormX()

 

說明: 傳回視窗左邊界的位置。
參數: 無。
傳回值: 數值,單位是像素 (pixel)。
範例:

 FormX()

 

▲Top

 

FormY()

 

說明: 傳回視窗上邊界的位置。
參數: 無。
傳回值: 數值,單位是像素 (pixel)。
範例:

 FormY()

 

▲Top

 

 

FormW()

 

說明: 傳回視窗寬度。
參數: 無。
傳回值: 數值,單位是像素 (pixel)。
範例:

 FormW()

 

▲Top

 

FormH()

 

說明: 傳回視窗高度。
參數: 無。
傳回值: 數值,單位是像素 (pixel)。
範例:

 FormH()

 

▲Top

 

FormDate()

 

說明: 傳回最後一次更新視窗設計 XML 產生的日期時間。函式應用於執行期版本管理。
參數: 無。
傳回值: 日期時間文字串,yyyyMMddHHmmss。
範例:

 FormDate() 傳回 20050101123020

 

▲Top

 

 

FormDir()

 

說明: 傳回視窗所隸屬於的系統目錄。
參數: 無。
傳回值: #應用程式名稱.子系統目錄名稱。按所隸屬於的子系統目錄以 . 分隔。
範例:

 FormDir() 傳回 #jNorth.Basc

 

▲Top

 

 

SnapShot(png_file)

 

說明: 傳回視窗快照並存成檔名為 png_file 的 PNG 圖檔。
參數: png_file:PNG 圖檔名稱。
傳回值: 1 表成功,0 表有誤。
範例:

SnapShot("customer.png") 將此視窗快照並存成檔名為 customer.png 的 PNG 圖檔。

 

▲Top

 

 

SnapShot(png_file, frame)

 

說明: 傳回視窗快照並存成檔名為 png_file 的 PNG 圖檔。
參數: png_file:PNG 圖檔名稱。
frame: 0  快照不含視窗外框, 1 快照含視窗外框
傳回值: 1 表成功,0 表有誤。
範例:

 SnapShot("customer.png", 0) 將此視窗快照但不要視窗外框,並存成檔名為 customer.png 的 PNG 圖檔。

 

▲Top

 

 

 

IsAdmin()

 

說明: 傳回是否以應用程式管理員的身份登入系統。
參數: 無。
傳回值: 1 表是,0 表否。
範例:

 IsAdmin()

 

▲Top

 

 

 

UserName()

 

說明: 取得目前使用者(user)的登入名稱。
參數: 無。
傳回值: 使用者(user)的名稱。
範例:

 UserName()

 

▲Top

 

 

UserPassword()

 

說明: 取得目前使用者(user)的登入密碼。
參數: 無。
傳回值: 使用者(user)的密碼。
範例:

 UserPassword()

 

▲Top

 

 

UserGroup()

 

說明: 取得目前使用者(user)的群組名稱。version 1.4 停用。
參數: 無。
傳回值: 使用者(user)的群組名稱。
範例:

 UserGroup()

 

▲Top

 

 

HttpCodeBase()

 

說明: 取得應用程式 class 的路徑。
請參考
檔案下載與上載
參數: 無。
傳回值: 應用程式 class 的路徑。
範例:

請參考 檔案下載與上載

 

▲Top

 

 

UncCodePath()

 

說明: 取得應用程式 class 的路徑,依照 UNC 的格式表示。
請參考
 檔案下載與上載
參數: 無。
傳回值: 應用程式 class 的路徑。
範例:

請參考  檔案下載與上載

 

▲Top

 

 

 

SetLang(lang)

SetLang(lang, font)

 

說明: jLIVE Builder 多國語系版本,設定視窗語系。請參閱 國際化。jLIVE Builder 多國語系應用程式執行時,系統會自動切換至使用者端的語系,除非設計師欲提供使用者切換至其他非使用者作業語系,否則不必使用此運算式。
參數: "lang":語系。例如:zh_TW:繁體中文。zH_CN :簡體中文。ja:日文。
"font":更換使用的字型名稱。 除非使用者環境無法以 Dialog 顯示非使用者作業語系,否則不必輸入。
傳回值: 1 表執行成功,0 表失敗。
範例:

將視窗語系調整成日文。

Setlang("ja")

將視窗語系調整成簡體中文,並以 Arial Unicode MS 字型顯示。
 

SetLang("zh_CN", "Arial Unicode MS")

 

▲Top

 

 

 

OsLang()

 

說明: 取得目前客戶端 (client) 機器作業系統所使用的語系名稱。
參數: 無。
傳回值: 語系字串,例如 zh_TW。
範例:

 OsLang()

 

▲Top

 

 

IsLang(lang)

 

說明: 目前客戶端(client)機器作業系統所使用的語系名稱,是否為 lang。
參數: 語系字串,例如 zh_TW。
傳回值: 1 表是,0 表否。
範例:

 IsLang("zh_CN"),客戶端(client)是否為簡體中文。

 

▲Top

 

 

 

ClientName()

 

說明: 取得目前客戶端(client)的機器名稱。
參數: 無。
傳回值: 機器名稱。
範例:

 ClientName()
傳回 PR158

 

▲Top

 

 

ClinetIp()

 

說明: 取得目前客戶端(client)的機器的 IP。
參數: 無。
傳回值: 機器的 IP。
範例:

 ClientIp()
傳回 192.168.1.188

 

▲Top

 

 

ApserverName()

 

說明: 取得應用程式伺服器的機器名稱。
參數: 無。
傳回值: 應用程式伺服器的機器名稱。
範例:

 ApserverName()
傳回 Server-1

 

▲Top

 

 

ApserverIp()

 

說明: 取得應用程式伺服器的  IP。
參數: 無。
傳回值: 應用程式伺服器的  IP。
範例:

 ApserverIp()
傳回 211.22.140.210

 

▲Top

 

 

AddCookie(name,value,comment,maxage)

 

說明: 在客戶端 (client) 加入 Cookie。
參數: "name":Cookie 名稱。
"value":Cookie 內含值。
"comment":Cookie 註解。
"maxage":Cookie 有效期限,以秒計算。
傳回值: Cookie 值 (value)。
範例:

加入一個名稱為 log_userid 的 cookie,其值為編輯元件 (edit_userid) 的內含值,cookie 的有效期限為 5 天。 
AddCookie("log_userid", {edit_userid}, "comment for id", 216000)

 

▲Top

 

 

AddCookie(name,value,comment,maxage,path)

 

說明: 在客戶端 (client) 指定的路徑加上 Cookie。
參數: "name":Cookie 名稱。
"value":Cookie 內含值。
"comment":Cookie 註解。
"maxage":Cookie 有效期限,以秒計算。
"path":Cookie 的路徑。
傳回值: Cookie 值 (value)。
範例:

 

 

▲Top

 

 

GetCookie(name)

 

說明: 取得記載在客戶端 (client) 的 cookie 的內含值。
參數: "name":Cookie 名稱。
傳回值: cookie 的內含值。
範例:

 

 

▲Top

 

 

GetServletResp(event.param)

 

說明: 呼叫 Server 端的 servlet ,並取得其輸出參數。
參數: 事件名稱.參數名稱,參閱 Servlet Call
傳回值: 輸出參數的內含值,無此參數或事件傳回空字串。
範例:

參閱 Servlet Call

 

▲Top

 

 

Beep()

 

說明: 發出系統的嗶嗶聲。
參數: 無。
傳回值: 1。
範例:

 

 

▲Top

 

 

RGB(red,green,blue)

 

說明: 動態變更元件前景背景的顏色, 以 RGB 值表示。
參數: "red":RGB 紅色的值。
"green":RGB 綠色的值。
"blue":RGB 藍色的值。
傳回值: 以"red"、"green"、"blue"所組成設定顏色的數值。
範例:

 RGB( 0, 0, 0 )

 

▲Top

 

 

BarCode(x)

 

說明: 檢查 Barcode 的正確性。
參數: "x":Barcode 的值。
傳回值: 1 表正確,0 表錯誤。
範例:

 

 

▲Top

 

 

BarCode(x,addchecksum)

 

說明: 檢查 Barcode 的正確性。傳入 7 或 12 碼 Barcode,傳回加上檢查碼的 8 或 13 碼 Barcode。
參數: "x":Barcode 的值。
"addchecksum" 等於 1 時,加入 Barcode 檢查碼。

"addchecksum"等於 0 時,檢查 Barcode 的正確性。
傳回值: addchecksum" 等於 1 時 ,正確給值時傳回加入檢查碼的 Barcode 。否則傳回原值。
"addchecksum"等於 0 時,檢查 Barcode 的正確性,傳回 1 表正確,0 表錯誤。。
範例:

 

 

▲Top

 

 

IdCheck(x)

 

說明: 檢查中華民國身分證字號的正確性。
參數: "x":身分證字號。
傳回值: 1 表正確,0 表錯誤。
範例:

 

 

▲Top

 

 

CompanyId(x)

 

說明: 檢查中華民國公司統一編號的正確性。
參數: "x":公司統一編號。
傳回值: 1 表正確,0 表錯誤。
範例:

 

 

▲Top

 

 

ChiNum(x)

 

說明: 將阿拉伯數字轉換成繁體中文金額表示。
參數: "x":阿拉伯數字。
傳回值: 繁體中文數字。
範例:

 ChiNum(10625.78) 傳回 "壹萬零陸佰貳拾伍元柒角捌分"

 

▲Top

 

 

LastUsePrinter()

 

說明: 將 最後一次列印所選用的印表機名稱傳回。適用於連續多個報表列印,第一次列印時,詢問使用者選用印表機後,接續的印表作業,可以呼叫此函式取得使用者選用的印表機。
參數: 無。
傳回值: 印表機名稱。
範例:

取得最後一次印表作業所使用的印表機
LastUsePrinter()

 

▲Top

 

 

MWHTTP()

MWHTTP(alias)

 

說明: 傳回 jLIVE™ middle ware 的 URL。
參數: 無或空字串。
"alias":jLIVE™ middle ware 的別名。
傳回值: URL 字串。
範例:

MWHTTP() 與 MWHTTP("") ,傳回主要 jLIVE™ middle ware 的 URL。
MWHTTP("mw_usa"),傳回別名為 mw_usa 的 jLIVE™ middle ware 的 URL。

 

▲Top

 

IsGrantOpen(formname)

 

說明: 使用 jLIVE™ 授權管理時, 傳回是否允許開啟 formname  的視窗。
參數: "formname":視窗 class 名稱。
傳回值: 0 :未授權。
1 :授權允許開啟。
範例:

IsGrantOpen("CMM_BASC_CREATE") 傳回 0 :未授權。1 :授權允許開啟。

 

▲Top

 

IsAuthItem(item)

 

說明: 使用 jLIVE™ 授權管理時,傳回視窗中是否允許操作授權項目item  的作業 。
參數: "item":授權項目。
目前預設支援項目:
I:insert 新增
U:update 修改
D:delete 刪除
Q:query 查詢
P:print 列印
X:customer defined
Y:customer defined
Z:customer defined
傳回值: 0 :未授權。
1 :授權。
範例:

IsAuthItem("I") 在此視窗中是否允許新增作業。

 

▲Top

 

 



Copyright © 2001~ 2004 Probe Technology Inc. . All Rights Reserved.

Questions, comments, and suggestions to Service@probe.com.tw