跳至主要內容

Button 動作按鈕

此元件在介面上顯示一個按鈕,用於執行一個動作。

類型描述必選預設值最低版本需求
action字串動作標識*--
args字典傳遞給動作的參數*--
alignment字串對齊方式-Left1.2-10
alignment描述
Left左對齊
Center居中
Right右對齊
Natural自然對齊
Justified兩邊對齊

動作說明

動作執行完成後,會將回傳值儲存到該元件的設定項中,因此需要正確設定該元件的 keydefaults 屬性。

不同的 action 動作需要傳遞不同的參數字典 args.

Reload:

重新整理 XUI,重新載入所有運行中的 XUI 實例,需要 XXT v1.2-10 及更高版本。

無參數,無回傳值

RunCommand:

呼叫 system/posix_spawn 執行命令行,需要 XXT v1.2-10 及更高版本。

類型描述必選預設值最低版本需求
command字串欲執行的命令行字串*-1.2-10
回傳值類型描述
整數命令行執行的回傳值 Exit Status

LaunchScript:

運行服務腳本。

類型描述必選預設值最低版本需求
path字串服務腳本路徑*--

無回傳值

OpenURL:

在第三方應用中打開 URL.

類型描述必選預設值最低版本需求
url字串欲打開的URL*--

無回傳值

ScanQRCode:

調起相機,掃描二維碼。

無參數

回傳值類型描述
字串二維碼掃描結果

SendMail:

在應用中,發送郵件。

類型描述必選預設值最低版本需求
subject字串郵件主題*--
toRecipients包含字串的陣列收件電子郵件地址陣列*--
ccRecipients包含字串的陣列抄送電子郵件地址陣列-{}-
bccRecipients包含字串的陣列密送電子郵件地址陣列-{}-
attachments包含字串的陣列攜帶附件的路徑陣列-{}-

無回傳值

Null:

無動作,一般用於重置一個特定的設定值,併發出相應通知給腳本,需要 XXT v1.2-10 及更高版本。

無參數,無回傳值

範例

{
cell = "Button";
action = "OpenURL:";
label = "联系 [email protected]";
args = {
url = "mailto:[email protected]";
}
};

XUI-Button.png