腳本內建指令說明

此指令適用於1.0.3.1版

UI操作指令

UI.UpdateLog(OutPut,Color) -- 秀出訊息至程式Log區

UI.ID -- 取得執行緒ID

UI.Link -- 取得下載任務連結

UI.FileName -- 取得執行任務檔名

UI.FileSize -- 取得執行任務檔案大小

UI.SavePath -- 取得執行任務保存路徑

UI.ProceSuccess(Check) -- 將檔案列表ICON轉成完成圖示

UI.ProceFalse() -- 將檔案列表ICON轉成失敗圖示

UI.User -- 取得任務列表的帳號

UI.Password -- 取得任務列表的密碼

UI.AddShareLink("保存的資料") -- 將連結保存到上傳完成列表的分享連結欄位內

UI.UpFile(要Post的網址) -- 檔案上傳

UI.StartupPath -- 取得當前程式路徑

UI.DownloadURL("下載網址")-- 檔案下載

UI.PromptCaptcha("圖片網址",x,y,title)-- 將圖片儲存於交談視窗中

UI.CaptchaValue-- 取得該UI.PromptCaptcha(圖片網址)指令的使用者輸入資料

UI.Sleep(秒數,顯示風格) -- 停止執行緒至特定秒數

UI.PromptTXT(資料內容) -- 設定交談窗口的提示字串

UI.PromptShow(x,y,title) -- 秀出交談視窗

UI.PromptValue -- 取得交談視窗所輸入的值

UI.SetExecdByte(內容,View) -- 強制修改執行位元組欄位

UI.SetPercentage(內容,View) -- 強制修改百分比欄位

UI.SetSpeed(內容,View) -- 強制修改速度欄位

UI.SetLastTime(內容,View) -- 強制修改剩餘時間欄位

UI.Stop_Point-- 取得使用者按下停止按鈕狀態

UI.DESC -- 取得或者設定任務欄備註

UI.GetSetConfigBuffer -- 取得偏好設定的Buffer資料

UI.ScriptType-- 取得當前任務類型

UI.SetIconStart()-- 強制任務的ICON圖示設定為上傳或下載

UI.SetIOExceptionOK()- 強制忽略IOException錯誤

UI.GetScriptPath--取得腳本路徑

UI.GetAccountFilePath-取得上傳腳本所綁定的帳號文件路徑

UI.PostToGetFile(URL,PostData)-使用Post模式進行下載

UI.HD_TotalFreeSpace(資料夾路徑)-傳回指定路徑的硬碟區可用容量大小

UI.Version-傳回程式當前版本號

HTTP操作指令

HTTP.Proxy -- 設定Proxy

HTTP.HTMLEncoding -- 設定讀取網頁時要以什麼編碼格式呈現

HTTP.AllowAutoRedirect -- 設定是否自動轉址

HTTP.Referer -- 設定參照頁

HTTP.UserAgent -- 設定模擬的瀏覽器

HTTP.GetURL(URL) -- 讀取網頁

HTTP.PostURL(URL,PostStr) -- 送出資料至網頁

HTTP.AddPostParam(欄位名稱,值) -- 送出資料至網頁

HTTP.PostData -- 回傳透過HTTP.AddPostParam指令所儲存的資料

HTTP.MaximumAutomaticRedirections -- 設定自動轉址次數

HTTP.SetCookie(Cookie值) -- 自訂Cookie

HTTP.AddUpParam(欄位名稱,值) -- 設定上傳參數

HTTP.AddFileReference(File欄位名稱,ContentType,FileName) -- 設定上傳檔案所必需的file欄位資料

HTTP.ClearProcedureData() -- 清除HTTP.AddFileReference和HTTP.AddUpParam以及HTTP.PostData資料

HTTP.Cookie -- 取得或者設定Cookie集合

HTTP.SetHeaders(檔頭名稱,檔頭值) -- 自訂檔頭

HTTP.GetCookie -- 取得Cookie值(取得最後一次的回傳快取資料)

HTTP.CookieToString -- 取得Cookie值(取得程式目前快取資料)

HTTP.Redirect_Url -- 取得狀態302後的轉址

HTTP.GetHeader(URL)-- 取得網頁檔頭資訊

DNA操作指令

DNA.Key -- 設定DNA 金鑰

DNA.LoadFile("DNA文件路徑") -- 匯入DNA文件路徑

DNA.Status-- DNA比對結果

DNA.Message -- 比對結果回報

PublicValue 操作指令

PublicValue.SetVaule(要儲存的變數,"索引值") -- 設定跨任務變數

PublicValue.ValueExists("索引值") -- 判斷所設定的跨任務變數是否存在

PublicValue.ReadValue("索引值") -- 取得跨任務變數的值

VBLangueScript指令

VBLangueScript.Source(VB.NET程式碼,要執行的Class名稱) -- 建構VB.NET程式碼

VBLangueScript.Exec(Function名稱,參數集合) -- 運行所建構的VB.NET的某個Function

VBLangueScript.Error_Message -- 回傳錯誤訊息

CSharpLangueScript指令

CSharpLangueScript.Source(C#程式碼,要執行的Class名稱) -- 建構C#程式碼

CSharpLangueScript.Exec(Function名稱,參數集合) -- 運行所建構的C#的某個Function

CSharpLangueScript.Error_Message -- 回傳錯誤訊息

JSLangueScript指令

JSLangueScript.Source(JScript程式碼) -- 建構Jscript程式碼

JSLangueScript.Exec(Function名稱,參數集合) -- 運行所建構的Jscript程式碼的某個Function

JSLangueScript.Error_Message -- 回傳錯誤訊息

UI操作指令

此處指令通常是用來提供給腳本取得程式介面的欄位值或者秀出訊息至程式顯示區當中,以及上傳和下載指令也歸為此處

UI.UpdateLog(OutPut,Color) -- 秀出訊息至程式Log區

函數

UI.UpdateLog(OutPut,Color)

說明

此方法用來顯示訊息至程式的Log顯示區

函數說明

其中OutPut資料型態為字串,Color資料型態數值

Stytle=1 訊息為紅色字體

Stytle=2 訊息為藍色字體

Stytle=3 訊息為紅色字體(粗體)

Stytle=4 訊息為藍色字體(粗體)

Color的值如果預設不輸入或者輸入超過上述數值時,則預設顯示一般黑色字體

範例

UI.UpdateLog("今天天氣很好")

UI.UpdateLog("今天天氣很好",1)

UI.UpdateLog("今天天氣很好",2)

UI.UpdateLog("今天天氣很好",3)

UI.UpdateLog("今天天氣很好",4)

效果

屬性

唯寫

回傳值

UI.ID -- 取得執行緒ID

函數

UI.ID

說明

此函數用來顯示當前任務的執行緒ID

範例

UI.UpdateLog("取得執行緒ID:%s" % (UI.ID))

UI.UpdateLog("取得執行緒ID:"+UI.ID)

效果

屬性

唯讀

回傳值

數值(integer)

UI.Link -- 取得下載任務連結

函數

UI.Link

說明

此函數用來取得或者設定當前”下載”任務的下載連結

範例

UI.UpdateLog("取得下載連結:%s" % (UI.Link))

UI.UpdateLog("取得下載連結:"+UI.Link)

效果

屬性

可讀寫

回傳值

字串(String)

UI.FileName -- 取得執行任務檔名

函數

UI.FileName

說明

此函數用來取得或者設定示當前任務的檔名

範例

UI.UpdateLog("取得當前任務檔名:%s" % (UI.FileName))

UI.UpdateLog("取得當前任務檔名:"+UI.FileName)

效果

屬性

可讀寫

回傳值

字串(String)

UI.FileSize -- 取得執行任務檔案大小

函數

UI.FileSize

說明

此函數用來取得或者設定示當前任務的檔案大小

範例

UI.UpdateLog("取得當前任務檔名:%s" % (UI.FileSize))

UI.UpdateLog("取得當前任務檔名:"+UI.FileSize)

效果

屬性

可讀寫

回傳值

字串(String)

UI.SavePath -- 取得執行任務保存路徑

函數

UI.SavePath

說明

此函數用來取得或者設定示當前任務的保存路徑

範例

UI.UpdateLog("取得當前任務保存路徑:%s" % (UI.SavePath))

UI.UpdateLog("取得當前任務保存路徑:"+UI.SavePath)

效果

屬性

可讀寫

回傳值

字串(String)

UI.ProceSuccess(Check) -- 將檔案列表ICON轉成完成圖示

函數

UI.ProceSuccess(Check)

說明

將檔案列表ICON轉成完成圖示或者為未確定完成圖示

備註

若將Check值設定為False則程式任務未確定成功圖示,若設定為True或者不設定的話

則為設定程完成圖示

屬性

方法(不可讀寫)

回傳值

UI.ProceFalse() -- 將檔案列表ICON轉成失敗圖示

函數

UI.ProceFalse()

說明

將檔案列表ICON轉成失敗圖示

屬性

方法(不可讀寫)

回傳值

UI.User -- 取得任務列表的帳號

函數

UI.User

說明

取得任務列表帳號

屬性

唯讀

回傳值

字串(String)

UI.Password -- 取得任務列表的密碼

函數

UI.Password

說明

取得任務列表密碼

屬性

唯讀

回傳值

字串(String)

UI.AddShareLink("保存的資料") -- 將連結保存到上傳完成列表的分享連結欄位內

函數

UI.AddShareLink(網址)

說明

將連結保存到上傳完成列表的分享連結欄位內

備註

1.若要保存多筆連結可使用 ^  符號做分割

2.詳細使用方法可以參考load.to(測試上傳用腳本).py腳本

屬性

唯寫

回傳值

無回傳值

UI.UpFile(要Post的網址) -- 檔案上傳

函數

UI.UpFile(要Post的網址)

說明

將連結保存到上傳完成列表的分享連結欄位內

備註

1.要Post的網址需要為字串格式(String)

2.詳細使用方法可以參考load.to(測試上傳用腳本).py腳本

3.上傳失敗會回傳空字串

範例

# -*- coding: utf-8 -*-

HTML=UI.UpFile("http://demo.com.tw/upfile.php”)

if HTML==""

    UI.UpdateLog("上傳失敗",2)

else:

    UI.UpdateLog("上傳成功",2)

屬性

唯寫

回傳值

字串(String)

UI.StartupPath -- 取得當前程式路徑

函數

UI.StartupPath

說明

取得當前程式路徑

屬性

唯讀

回傳值

字串(String)

UI.DownloadURL("下載網址")-- 檔案下載

函數

UI.DownloadURL

說明

檔案下載

備註.

1.下載網址需為字串格式

2.下載成功會回傳True,失敗則回傳False

範例

# -*- coding: utf-8 -*-

Status=UI.DownloadURL(“http://demo.com.tw/xxxx.zip”)

if Status==True:

    UI.UpdateLog("下載成功",3)

屬性

唯讀

回傳值

布林值(Boolean)

UI.PromptCaptcha("圖片網址",x,y,title)-- 將圖片儲存於交談視窗中

函數

UI.PromptCaptcha(圖片網址)

說明

將圖片儲存於交談視窗中

備註.

1.圖片網址需為字串格式

2.輸入完資料,可以透過UI.CaptchaValue取得使用者輸入資料

3.X和Y為選擇性參數,用來設定視窗大小,分別對應視窗長度和寬度

4.title 為選擇性參數,可用來自訂視窗名稱

範例

# -*- coding: utf-8 -*-

UI.PromptCaptcha("http://demo.com/001.jpg")

#取得使用者輸入的資料

UI.UpdateLog(UI.CaptchaValue)

屬性

唯寫(方法)

回傳值

無回傳值

UI.CaptchaValue-- 取得該UI.PromptCaptcha(圖片網址)指令的使用者輸入資料

函數

UI.CaptchaValue

說明

取得該UI.PromptCaptcha(圖片網址)指令的使用者輸入資料

屬性

唯讀

回傳值

字串(String)

UI.Sleep(秒數,顯示風格) -- 停止執行緒至特定秒數

函數

UI.Sleep(秒數,顯示風格)

說明

停止執行緒至特定秒數

備註.

1.秒數值需為數值的資料型態(integer),單位:秒

2.顯示風格為選擇性變數,設定為False不顯示倒數資訊,設定為True則會顯示,預設會顯示

範例.

#倒數五秒,顯示倒數資訊

UI.Sleep(5)

UI.Sleep(5,True)

#倒數五秒,不顯示倒數資訊

UI.Sleep(5,False)

屬性

唯寫

回傳值

無回傳值

UI.PromptTXT(資料內容) -- 設定交談窗口的提示字串

函數

UI.PromptTXT(資料內容)

說明

設定交談窗口的提示字串

備註.

1.如果要多行顯示,則就在重試呼叫此指令即可

2.此指令需在UI.PromptShow()之前使用

範例.

UI.PromptTXT("ABCDEFG")

UI.PromptTXT("GFEDCBA")

屬性

唯寫

回傳值

無回傳值

UI.PromptShow(x,y,title) -- 秀出交談視窗

函數

UI.PromptShow(x,y)

說明

秀出交談視窗

備註.

1.X和Y為選擇性參數,主要用來控制視窗大小,分別對應視窗的寬和高

2.title為選擇性參數,可用來自訂視窗名稱

範例.

UI.PromptTXT("ABCDEFG")

UI.PromptTXT("GFEDCBA")

#預設視窗大小顯示

UI.PromptShow()

#建立寬度500長度300的視窗

UI.PromptShow(500,300)

屬性

唯寫

回傳值

無回傳值

UI.PromptValue -- 取得交談視窗所輸入的值

函數

UI.PromptValue

說明

取得交談視窗所輸入的值

範例.

# -*- coding: utf-8 -*-

UI.PromptTXT("ABCDEFG")

UI.PromptTXT("GFEDCBA")

UI.PromptShow()

UI.UpdateLog(UI.PromptValue)

屬性

唯讀

回傳值

回傳值(String)

UI.SetExecdByte(內容,View) -- 強制修改執行位元組欄位

函數

UI.SetExecdByte(內容,View)

說明

強制修改執行位元組欄位

備註

1.此指令是提供給不使用內建上傳指令或者下載指令,而是直接使用Python腳本作上傳下載動作,但是需要秀出已上傳資訊或者已下載資訊的開發者使用(此處指令會自動格式化為Byte,KB,MB,GB,TB,TB等容量顯示數值)

2.View為選擇性參數,設定為True則不會格式化內容

屬性

唯寫

回傳值

無回傳值

UI.SetPercentage(內容,View) -- 強制修改百分比欄位

函數

UI.SetPercentage(內容,View)

說明

強制修改百分比欄位

備註

1.此指令是提供給不使用內建上傳指令或者下載指令,而是直接使用Python腳本作上傳下載動作,但是需要秀出上傳百分比資訊或者下載百分比資訊的開發者使用(此處指令會自動格式化百分比)

2.View為選擇性參數,設定為True則不會格式化內容

屬性

唯寫

回傳值

無回傳值

UI.SetSpeed(內容,View) -- 強制修改速度欄位

函數

UI.SetSpeed(內容,View)

說明

強制修改速度欄位

備註

1.指令是提供給不使用內建上傳指令或者下載指令,而直接使用Python腳本作上傳下載動作,但是需要秀出上傳速度資訊或者下載速度資訊的開發者使用(此處指令會自動格式化為Byte,KB,MB,GB,TB,TB等容量顯示數值)

2.View為選擇性參數,設定為True則不會格式化內容

屬性

唯寫

回傳值

無回傳值

UI.SetLastTime(內容,View) -- 強制修改剩餘時間欄位

函數

UI.SetLastTime(內容,View)

說明

強制修改剩餘欄位

備註

此指令是提供給不使用內建上傳指令或者下載指令,而直接使用Python腳本作上傳下載動作,但是需要秀出上傳剩餘時間資訊或者下載速度剩餘時間資訊的開發者使用(此處指令會自動格式化時間數值)

2.View為選擇性參數,設定為True則不會格式化內容

屬性

唯寫

回傳值

無回傳值

UI.Stop_Point-- 取得使用者按下停止按鈕狀態

函數

UI.Stop_Point

說明

取得使用者按下停止按鈕狀態

備註

若使用者有按下停止按鈕時會回傳True,沒按下則回傳False

屬性

唯讀

回傳值

Boolean

UI.DESC -- 取得或者設定任務欄備註

函數

UI.DESC

說明

取得任務欄備註

範例

#設定任務欄備註

UI.DESC="cscscsacscac"

取得任務欄備註

UI.UpdateLog(UI.DESC)

屬性

可讀寫

回傳值

String(字串)

UI.GetSetConfigBuffer -- 取得偏好設定的Buffer資料

函數

UI.GetSetConfigBuffer

說明

取得偏好設定的Buffer資料

備註

1.若在下載任務使用此指令,則會回傳偏好設定的下載設定中的Buffer

2.若在上傳任務使用此指令,則會回傳偏好設定的上傳設定中的Buffer

屬性

唯讀

回傳值

Long(長整數)

UI.ScriptType-- 取得當前任務類型

函數

UI.ScriptType

說明

取得當前任務類型

備註

該指令會依照使用者目前腳本是使用上傳模式或者下載模式,來回傳不同的值

下載模式=1

上傳模式=2

屬性

唯讀

回傳值

integer(數值)

UI.SetIconStart()-- 強制任務的ICON圖示設定為上傳或下載

函數

UI.SetIconStart()

說明

強制任務的ICON圖示設定為上傳或下載

備註

該指令會依照使用者目前腳本是使用上傳模式或者下載模式,來強制設定任務的ICON圖示為上傳或者下載圖示

屬性

不可讀寫

回傳值

無回傳值

UI.SetIOExceptionOK()- 強制忽略IOException錯誤

函數

UI.SetIOExceptionOK()

說明

強制忽略IOException錯誤

備註

此指令會強制略過"1"次的IOException錯誤(IOException錯誤通常發生在連線超時上)

將指令加在可能會發生IOException錯誤之前,即可避免掉這個錯誤

另外,若有多個可能發生IOException錯誤,請一樣在多個地方加入此指令

範例

#假設這處可能會發生IOException錯誤

HTML=HTTP.GetURL("http://aa.bb.cc)

#就在它之前就加入該指令(這樣即可避免錯誤)

UI.SetIOExceptionOK()

HTML=HTTP.GetURL("http://aa.bb.cc)

#若有多個可能發生IOException錯誤的地方,也一樣在可能發生錯誤處的加入

UI.SetIOExceptionOK()

HTML=HTTP.GetURL("http://aa.cccc.cc)

UI.SetIOExceptionOK()

HTML=HTTP.GetURL("http://aa.eeee.cc)

屬性

不可讀寫

回傳值

無回傳值

UI.GetScriptPath--取得腳本路徑

函數

UI.GetScriptPath

說明

取得腳本路徑

屬性

唯讀

回傳值

字串(String)

UI.GetAccountFilePath-取得上傳腳本所綁定的帳號文件路徑

函數

UI.GetAccountFilePath

說明

取得上傳腳本所綁定的帳號文件路徑

備註.

1.此指令僅適用上傳腳本

2.如果該上傳腳本沒有繫結帳號文件的話則會傳傳空字串

屬性

唯讀

回傳值

字串(String)

UI.PostToGetFile(URL,PostData)-使用Post模式進行下載

函數

UI.PostToGetFile(URL,PostData)

說明

使用Post進行下載

備註.

1.URL參數和PostData參數需為字串資料格式

2.可搭配HTTP.AddPostParam和HTTP.PostData使用

範例1

# -*- coding: utf-8 -*-

Post=”user=xxxxx&password=xxxx”

UI.PostToGetFile(“http://demo.com.tw/abc.zip”,Post)

範例2

# -*- coding: utf-8 -*-

HTTP.AddPostParam("user","xxxxx")

HTTP.AddPostParam("password",”xxxxx”)

UI.PostToGetFile(“http://demo.com.tw/abc.zip”,HTTP.PostData)

屬性

唯寫

回傳值

布林值(Boolean)

UI.HD_TotalFreeSpace(資料夾路徑)-傳回指定路徑的硬碟區可用容量大小

函數

UI.HD_TotalFreeSpace(資料夾路徑)

說明

傳回指定路徑的硬碟區可用容量大小

屬性

唯讀

回傳值

長整數(Long)

UI.Version-傳回程式當前版本號

函數

UI.Version

說明

傳回程式當前版本號

屬性

唯讀

回傳值

字串(String)

HTTP操作指令

此處指令主要用來處理讀取和送出資料至網頁端使用

HTTP.Proxy -- 設定Proxy

函數

HTTP.Proxy

說明

此函數用來設定或者取得Proxy

備註

1.如果透過腳本設定此函數,將會強制忽略透過使用者本身透過程式所設定的Proxy

2.此函數需要設定在HTTP.GetURL或者HTTP.PostURL之前

範例

# -*- coding: utf-8 -*-

HTTP.Proxy="proxy.hinet.net:80"

if HTTP.Proxy==None:

    UI.UpdateLog("沒有設定Proxy")

else:

    UI.UpdateLog("有設定Proxy")

    UI.UpdateLog(HTTP.Proxy)

效果

屬性

可讀寫

回傳值

字串(String)

HTTP.HTMLEncoding -- 設定讀取網頁時要以什麼編碼格式呈現

函數

HTTP.HTMLEncoding

說明

此函數用來設定讀取的網頁要用什麼編碼格式呈現(預設使用utf-8)

備註

1.此函數需要設定在HTTP.GetURL或者HTTP.PostURL之前

範例

# -*- coding: utf-8 -*-

HTTP.HTMLEncoding="utf-8"

HTML=HTTP.GetURL("http://tigermax.dyndns.org/bbs/forum.php")

UI.UpdateLog("目前使用%s讀取網頁"%(HTTP.HTMLEncoding),2)

UI.UpdateLog(HTML)

效果

屬性

可讀寫

回傳值

字串(String)

HTTP.AllowAutoRedirect -- 設定是否自動轉址

函數

HTTP.AllowAutoRedirect

說明

此函數用來設定讀取網頁時,是否自動轉址(預設自動轉址)

備註

1.此函數需要設定在HTTP.GetURL或者HTTP.PostURL之前

範例

# -*- coding: utf-8 -*-

HTTP.AllowAutoRedirect=False

if HTTP.AllowAutoRedirect==True:

    UI.UpdateLog("目前設定讀取網頁會自動轉頁")

else:

    UI.UpdateLog("不自動轉頁")

效果

屬性

可讀寫

回傳值

布林值(Boolean)

HTTP.Referer -- 設定參照頁

函數

HTTP.Referer

說明

此函數用來設定參照頁

備註

1.此函數需要設定在HTTP.GetURL或者HTTP.PostURL之前

範例

# -*- coding: utf-8 -*-

HTTP.Referer="http://tigermax.dyndns.org/bbs/forum.php"

if HTTP.Referer==None:

    UI.UpdateLog("沒有設定參照頁")

else:

    UI.UpdateLog("你設定參照頁為:%s" % (HTTP.Referer))

效果

屬性

可讀寫

回傳值

字串(String)

HTTP.UserAgent -- 設定模擬的瀏覽器

函數

HTTP.UserAgent

說明

此函數用來設定模擬的瀏覽器

備註

1.此函數需要設定在HTTP.GetURL或者HTTP.PostURL之前

2.此函數若無設定,預設使用"Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/535.2 (KHTML, like Gecko) Chrome/15.0.874.121 Safari/535.2"

範例

# -*- coding: utf-8 -*-

UI.UpdateLog("目前預設UserAgent:%s"%(HTTP.UserAgent))

效果

屬性

可讀寫

回傳值

字串(String)

HTTP.GetURL(URL) -- 讀取網頁

函數

HTTP.GetURL(URL)

說明

此函數用來讀取網頁

備註

如果發生讀取錯誤或者出現超時問題時,則只會回傳空字串

範例

# -*- coding: utf-8 -*-

URL=”http://tigermax.dyndns.org/bbs/forum.php”

HTML=HTTP.GetURL(URL)

UI.UpdateLog(HTML)

屬性

可讀寫

回傳值

字串(String)

HTTP.PostURL(URL,PostStr) -- 送出資料至網頁

函數

HTTP.PostURL(URL,PostStr)

說明

此函數用來Post資訊到遠端主機上

PostStr參數需為字串的資料形態

備註

如果發生讀取錯誤或者出現超時問題時,則只會回傳空字串

範例

# -*- coding: utf-8 -*-

URL=”http://tigermax.dyndns.org/bbs/forum.php”

HTML=HTTP.PostURL(URL,”user=xxxxx&pasword=ooooooo”)

UI.UpdateLog(HTML)

屬性

可讀寫

回傳值

字串(String)

HTTP.AddPostParam(欄位名稱,值) -- 送出資料至網頁

函數

HTTP.AddPostParam(欄位名稱,值)

說明

此函數用於保存要Post的資料,並將資料儲存在HTTP.PostData內

範例

# -*- coding: utf-8 -*-

#建構Post資料

HTTP.AddPostParam("op","download2")

HTTP.AddPostParam("id",ID)

HTTP.AddPostParam("rand",rand)

HTTP.AddPostParam("method_free","")

HTTP.AddPostParam("method_premium","")

HTTP.AddPostParam("down_direct","1")

   

 #Post資訊

HTML=HTTP.PostURL(UI.Link,HTTP.PostData)

屬性

方法

回傳值

無回傳值

HTTP.PostData -- 回傳透過HTTP.AddPostParam指令所儲存的資料

函數

HTTP.AddPostParam(欄位名稱,值)

說明

此函數用於保存要Post的資料,並將資料儲存在HTTP.PostData內

屬性

可唯讀

回傳值

字串(String)

HTTP.MaximumAutomaticRedirections -- 設定自動轉址次數

函數

HTTP.MaximumAutomaticRedirections

說明

此函數用來設定Get網址或Post網址,自動導向的次數(預設5次)

備註

1.如果不設定,或設定數值為0,則使用預設設定自動5次轉址

2.此設定需設定在HTTP.PostURL或者HTTP.GetURL之前

3.如果HTTP.AllowAutoRedirect設為定為Fasle,此功能會失效

範例

# -*- coding: utf-8 -*-

HTTP.MaximumAutomaticRedirections=2

URL=”http://tigermax.dyndns.org/bbs/forum.php”

HTML=HTTP.GetURL(URL)

UI.UpdateLog(HTML)

屬性

可讀寫

回傳值

數值(Integer)

HTTP.SetCookie(Cookie值) -- 自訂Cookie

函數

HTTP.SetCookie(Cookie值)

說明

此方法用來自定Cookie,其中Cookie值需為字串

備註

1.此設定需設定在HTTP.PostURL或者HTTP.GetURL之前

範例

# -*- coding: utf-8 -*-

HTTP.SetCookie("auth=XXXXXXX")

HTML=HTTP.GetURL("http://demo.com.tw")

屬性

方法(唯讀)

回傳值

無回傳值

HTTP.AddUpParam(欄位名稱,值) -- 設定上傳參數

函數

HTTP.AddUpParam(欄位名稱,值)

說明

此方法用來設定上傳時要Post的參數

備註

1.此設定需設定在UI.UpFile(Post網址)之前

2.注意資料型別,僅支援字串(String)和數值(integer)型態

3.詳細使用方法可以參考load.to(測試上傳用腳本).py腳本

屬性

方法(唯讀)

回傳值

無回傳值

HTTP.AddFileReference(File欄位名稱,ContentType,FileName) -- 設定上傳檔案所必需的file欄位資料

函數

HTTP.AddFileReference(File欄位名稱)

HTTP.AddFileReference(File欄位名稱,ContentType,FileName)

說明

設定上傳檔案所必需的file欄位資料

備註

1.此設定需設定在UI.UpFile(Post網址)之前

2.注意資料型別,僅支援字串(String)和數值(integer)型態

3.可額外定義ContentType選擇性參數,若不定義預設為application/octet-stream

4.可額外定義FileName選擇性參數,用來強制設定File欄位的"值",如果不設定預設值為上傳路徑+檔名

屬性

方法(唯讀)

回傳值

無回傳值

HTTP.ClearProcedureData() -- 清除HTTP.AddFileReference和HTTP.AddUpParam以及HTTP.PostData資料

函數

HTTP.ClearProcedureData()

說明

清除HTTP.AddFileReference和HTTP.AddUpParam以及HTTP.PostData資料

屬性

方法(唯讀)

回傳值

無回傳值

HTTP.Cookie -- 取得或者設定Cookie集合

函數

HTTP.Cookie

說明

取得或者設定Cookie集合

備註

1.此指令回傳值不是字串,所以無法直接使用字串格式設定Cookie值

2.若需要以字串方式設定Cookie值,請使用HTTP.SetCookie(Cookie值)

屬性

可讀寫

回傳值

CookieContainer (Cookie 集合Object)

HTTP.SetHeaders(檔頭名稱,檔頭值) -- 自訂檔頭

函數

HTTP.SetHeaders(檔頭名稱,檔頭值)

說明

自訂檔頭

備註

1.檔頭名稱需是字串的資料行態

2.檔頭值需是字串的資料行態

3.僅支援部分檔名設定,如User-Agent就無法直接從該指令做修改,而是必須從HTTP.UserAgent指令來修改

4.設定需放在HTTP.PostURL和HTTP.GetURL指令之前

範例

HTTP.SetHeaders("Accept-Language","zh-tw")

HTML=HTTP.GetURL(UI.Link)

屬性

方法(唯寫)

回傳值

無回傳值

HTTP.GetCookie -- 取得Cookie值(取得最後一次的回傳快取資料)

函數

HTTP.GetCookie

說明

取得Cookie值(取得最後一次的回傳快取資料)

備註

1.此指令可以用於HTTP.SetCookie上

範例

HTTP.SetCookie(HTTP.GetCookie)

HTML=HTTP.GetURL(http://xxxx.xxxx.com)

屬性

唯讀

回傳值

字串(String)

HTTP.CookieToString -- 取得Cookie值(取得程式目前快取資料)

函數

HTTP.CookieToString

說明

取得Cookie值(取得程式目前快取資料)

備註

1.此指令可以用於HTTP.SetCookie上

範例

HTTP.SetCookie(HTTP.CookieToString)

HTML=HTTP.GetURL(http://xxxx.xxxx.com)

屬性

唯讀

回傳值

字串(String)

HTTP.Redirect_Url -- 取得狀態302後的轉址

函數

HTTP.Redirect_Url

說明

取得狀態302後的轉址

屬性

唯讀

回傳值

字串(String)

HTTP.GetHeader(URL)-- 取得網頁檔頭資訊

函數

HTTP.GetHeader(URL)

說明

此函數僅取得檔頭資訊

屬性

唯讀

回傳值

字串(String)

DNA操作指令

此處指令用來讀取所建立的DNA文件

DNA.Key -- 設定DNA 金鑰

函數

DNA.Key

說明

設定DNA 金鑰

屬性

唯寫

回傳值

無回傳值

DNA.LoadFile("DNA文件路徑") -- 匯入DNA文件路徑

函數

DNA.LoadFile("DNA文件路徑")

說明

匯入DNA文件路徑

屬性

唯讀

回傳值

無回傳值

DNA.Status-- DNA比對結果

函數

DNA.Status

說明

DNA比對結果

屬性

唯讀

回傳值

Boolean(布林值)

DNA.Message -- 比對結果回報

函數

DNA.Message

說明

比對結果回報

屬性

唯讀

回傳值

String(字串)

PublicValue 操作指令

此處指令用來建立跨任務的變數,跨任務變數會在程式完整關閉後結束此變數的生命週期

PublicValue.SetVaule(要儲存的變數,"索引值") -- 設定跨任務變數

函數

PublicValue.SetVaule(要儲存的變數,"索引值")

說明

設定跨任務變數

備註:

1.索引值需為字串格式

範例:

# -*- coding: utf-8 -*-

Value="嘿嘿嘿嘿嘿"

#設定跨任務變數

PublicValue.SetVaule(Value,"Value")

屬性

唯寫

回傳值

無回傳值

PublicValue.ValueExists("索引值") -- 判斷所設定的跨任務變數是否存在

函數

PublicValue.ValueExists("索引值")

說明

#判斷所設定的跨任務變數是否存在

備註:

1.索引值需為字串格式

2.若該跨任務變數存在的話,會傳回True,不存在的為False

範例:

# -*- coding: utf-8 -*-

Value="嘿嘿嘿嘿嘿"

#設定跨任務變數

PublicValue.SetVaule(Value,"Value")

#判斷所設定的跨任務變數是否存在

if PublicValue.ValueExists("Value")==True:

        

        UI.UpdateLog("該跨任務變數存在")

        

else:

        UI.UpdateLog("該跨任務變數不存在")

屬性

唯讀

回傳值

無回傳值

PublicValue.ReadValue("索引值") -- 取得跨任務變數的值

函數

PublicValue.ReadValue("索引值")

說明

取得跨任務變數的值

備註:

1.索引值需為字串格式

範例:

# -*- coding: utf-8 -*-

Value="嘿嘿嘿嘿嘿"

#設定跨任務變數

PublicValue.SetVaule(Value,"Value")

#判斷所設定的跨任務變數是否存在

if PublicValue.ValueExists("Value")==True:

        

        UI.UpdateLog("該跨任務變數存在")

        

        #取得跨任務變數

        #PublicValue.ReadValue("Value")

        UI.UpdateLog(PublicValue.ReadValue("Value"))

else:

        UI.UpdateLog("該跨任務變數不存在")

屬性

唯讀

回傳值

回傳值(Object)

VBLangueScript指令

此處指令用來在運行VB.NET程式碼所用

VBLangueScript.Source(VB.NET程式碼,要執行的Class名稱) -- 建構VB.NET程式碼

函數

VBLangueScript.Source(VB.NET程式碼)

說明

建構VB.NET程式碼

備註

在建構VB.NET程式碼時,需要以Class的方式作編寫,如果正確建構,則會回傳True,失敗則回傳False

範例:

# -*- coding: utf-8 -*-

Status=VBLangueScript.Source('''

                                          Public Class MainClass

                                                Public Shared Function Eval(a,b,c) As String

                                                        Return a & b &c

                                                    End Function

                                        End Class

                                ''',"MainClass")

屬性

唯讀

回傳值

回傳值(Boolean)

VBLangueScript.Exec(Function名稱,參數集合) -- 運行所建構的VB.NET的某個Function

函數

VBLangueScript.Exec(Function名稱,參數集合) -- 運行所建構的VB.NET的某個Function

說明

運行所建構的VB.NET的某個Function

備註

1.參數集合為選擇性參數,如果要呼叫的Function不用參數傳遞,則參數集合留空即可

2.參數集合需要為元組的資料型態

3.回傳值的資料型態為要你所呼叫的Function所產生的資料型態,如果你的Function最後產生的值的資料型態為String,則所回傳的值的資料型態就為String

範例:

Status=VBLangueScript.Source('''

                                    Public Class MainClass

                                        Public Shared Function Eval(a,b,c) As String

                                                Return a & b &c

                                        End Function

                                    End Class

                                ''',"MainClass")

                                                        

if Status==True:

        ReturnStr=VBLangueScript.Exec("Eval",(0,"G","C"))

        UI.UpdateLog(ReturnStr)

屬性

唯讀

回傳值

回傳值(依使用者Function的回傳值的資料型態為主)

VBLangueScript.Error_Message -- 回傳錯誤訊息

函數

VBLangueScript.Error_Message -- 回傳錯誤訊息

說明

回傳錯誤訊息

屬性

唯讀

回傳值

回傳值(字串)

CSharpLangueScript指令

此處指令用來在運行C#程式碼所用

CSharpLangueScript.Source(C#程式碼,要執行的Class名稱) -- 建構C#程式碼

函數

VBLangueScript.Source(C#程式碼)

說明

建構C#程式碼

備註

在建構C#程式碼時,需要以Class的方式作編寫,如果正確建構,則會回傳True,失敗則回傳False

範例:

# -*- coding: utf-8 -*-

Status=CSharpLangueScript.Source('''

                                                public class MainClass

                                                {

                                                        public static object Eval(int a,int b,int c)

                                                        {

                                                                return a+b+c;

                                                        }

                                                }

                                                ''',"MainClass")

屬性

唯讀

回傳值

回傳值(Boolean)

CSharpLangueScript.Exec(Function名稱,參數集合) -- 運行所建構的C#的某個Function

函數

CSharpLangueScript.Exec(Function名稱,參數集合) -- 運行所建構的C#的某個Function

說明

運行所建構的C#的某個Function

備註

1.參數集合為選擇性參數,如果要呼叫的Function不用參數傳遞,則參數集合留空即可

2.參數集合需要為元組的資料型態

3.回傳值的資料型態為要你所呼叫的Function所產生的資料型態,如果你的Function最後產生的值的資料型態為String,則所回傳的值的資料型態就為String

範例:

Status=CSharpLangueScript.Source('''

                                                public class MainClass

                                                {

                                                        public static object Eval(int a,int b,int c)

                                                        {

                                                                return a+b+c;

                                                        }

                                                }

                                                ''',"MainClass")

if Status==True:

        ReturnStr=CSharpLangueScript.Exec("Eval",(16,17,18))

        UI.UpdateLog(ReturnStr)

屬性

唯讀

回傳值

回傳值(依使用者Function的回傳值的資料型態為主)

CSharpLangueScript.Error_Message -- 回傳錯誤訊息

函數

CSharpLangueScript.Error_Message -- 回傳錯誤訊息

說明

回傳錯誤訊息

屬性

唯讀

回傳值

回傳值(字串)

JSLangueScript指令

此處指令用來在運行JScript程式碼所用

JSLangueScript.Source(JScript程式碼) -- 建構Jscript程式碼

函數

JSLangueScript.Source(Jscript程式碼)

說明

建構Jscript程式碼

範例:

# -*- coding: utf-8 -*-

Staus=JSLangueScript.Source(

                                '''

                                function preprocess(a,b)  

                                {  

                                        return a+b;

                                }

                                        '''

                                )

屬性

唯讀

回傳值

回傳值(Boolean)

JSLangueScript.Exec(Function名稱,參數集合) -- 運行所建構的Jscript程式碼的某個Function

函數

JSLangueScript.Exec(Function名稱,參數集合) -- 運行所建構的Jscript的某個Function

說明

運行所建構的Jscript的某個Function

備註

1.參數集合為選擇性參數,如果要呼叫的Function不用參數傳遞,則在該欄位定義為()

2.參數集合需要為元組的資料型態

3.回傳值的資料型態為要你所呼叫的Function所產生的資料型態,如果你的Function最後產生的值的資料型態為String,則所回傳的值的資料型態就為String

範例:

Status=CSharpLangueScript.Source('''

                                                public class MainClass

                                                {

                                                        public static object Eval(int a,int b,int c)

                                                        {

                                                                return a+b+c;

                                                        }

                                                }

                                                ''',"MainClass")

if Status==True:

        ReturnStr=CSharpLangueScript.Exec("Eval",(16,17,18))

        UI.UpdateLog(ReturnStr)

屬性

唯讀

回傳值

回傳值(依使用者Function的回傳值的資料型態為主)

JSLangueScript.Error_Message -- 回傳錯誤訊息

函數

JSLangueScript.Error_Message -- 回傳錯誤訊息

說明

回傳錯誤訊息

屬性

唯讀

回傳值

回傳值(字串)