系統函數
系統函數提供用來存取系統、裝置和 QlikView 文件屬性的函數。
使用各個函數的下拉式清單,查看各函數的簡短描述及語法。對於某些函數,按一下語法描述中的函數名稱,可取得有關該特定函數的進一步詳細資料。
此函數傳回包含目前文件的作者屬性的字串。可用於載入指令碼和圖表運算式。
Author( )
此函數傳回用戶端瀏覽器的使用者代理程式字串。 可用於載入指令碼和圖表運算式。
範例:
Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/35.0.1916.114 Safari/537.36
ClientPlatform( )
此函數傳回包含電腦名稱 (由作業系統所傳回) 的字串。 可用於載入指令碼和圖表運算式。
ComputerName( )
此指令碼函數傳回所使用定序地區設定的文化名稱。如果尚未設定變數 CollationLocale,則會傳回實際使用者機器地區設定。
GetCollationLocale( )
此函數會傳回指定物件識別碼之工作表物件中具名延伸屬性的值。若未指定 objectid,則會使用包含此運算式的工作表物件。延伸屬性是定義於延伸物件的定義檔案中。
GetExtendedProperty(name[, objectid])
GetObjectField() 會傳回維度名稱。Index 為選用整數,代表應傳回的維度。
GetObjectField([index])
此函數會傳回 Windows 登錄中索引鍵的值。 可用於載入指令碼和圖表運算式。
GetRegistryString(path, key)
此函數僅可用於指令碼中,會在指令碼執行期間開啟輸入方塊,提示使用者輸入值。參數 cue 和 caption 分別作為訊息和標題文字。此函數會傳回所輸入的值。
若取消、關閉或無法顯示對話方塊,輸入方塊函數會傳回 NULL。
範例:
Load
Input('Enter value', 'Input box') as v,
Recno () as r
autogenerate 3;
Input(str cue [, str caption])
此函數僅可用於指令碼中,會在指令碼執行期間開啟訊息方塊。參數 msg 和 caption 分別作為訊息和標題文字。參數 mb_buttons 會定義要顯示在訊息方塊中的按鈕,其定義如下:
0 或 'OK' 代表單一 OK 按鈕,
1 或 'OKCANCEL' 代表兩個按鈕,OK 和 Cancel,
2 或 'ABORTRETRYIGNORE' 代表三個按鈕,Abort、Retry 和 Ignore,
3 或 'YESNOCANCEL' 代表三個按鈕,Yes、No 和 Cancel,
4 或 'YESNO' 代表兩個按鈕,Yes 和 No,
5 或 'RETRYCANCEL' 代表兩個按鈕,Retry 和 Cancel,
參數 mb_icons 會定義要顯示在訊息方塊中的圖示,其定義如下:
0 或空字串代表沒有圖示,
16 或 'ICONHAND' 代表含有 X 的圖示,用於嚴重錯誤,
32 或 'ICONQUESTION' 代表含有問號的圖示,
48 或 'ICONEXCLAMATION' 代表含有驚嘆號的圖示,用於次要錯誤、注意事項和警告
64 或 'ICONASTERISK' 代表含有 i 的圖示,用於資訊訊息。
參數 mb_defbutton 會定義訊息方塊顯示時具有焦點的按鈕,其定義如下:
若第一個按鈕應有焦點,則為 0 或 'DEFBUTTON1',
若第二個按鈕應有焦點,則為 256 或 'DEFBUTTON2',
若第三個按鈕應有焦點,則為 512 或 'DEFBUTTON3',
若第四個按鈕應有焦點,則為 768 或 'DEFBUTTON4'。
此函數會傳回一個整數,用以顯示使用者按下哪個按鈕,其定義如下:
1 代表 OK,
2 代表 Cancel,
3 代表 Abort,
4 代表 Retry,
5 代表 Ignore,
6 代表 Yes,
7 代表 No
參數 3、4 和 5 會從內部加入,所以如果使用了非以上所述的數值,可能會產生非預期的圖示和按鈕的組合。
若無法顯示對話方塊,訊息方塊函數會傳回 NULL。
範例:
Load
MsgBox('Message 2', 'msgbox', 'OKCANCEL', 'ICONASTERISK') as x, 2 as r
autogenerate 1;
MsgBox(str msg [, str caption [, mb_buttons [, mb_icons[, mb_defbutton]]]] )
此函數傳回包含目前使用者名稱 (由作業系統所傳回) 的字串。 可用於載入指令碼和圖表運算式。
OSUser( )
此函數會傳回完整的 QlikView 版本和組建編號作為字串。
傳回包含目前 QlikView 使用者名稱 (如同在區段存取中所輸入) 的字串。
QVuser( )
此函數傳回完成最後一筆資料載入時的時間戳記。 可用於載入指令碼和圖表運算式。
ReloadTime( )
此圖表函數會傳回物件所使用的狀態名稱。QlikView 開發人員可使用此函數,在物件的狀態變更時產生動態的文字和色彩。必須注意的是,此函數僅可用於物件,無法用於圖表運算式中,藉以確定運算式參照的狀態。