用戶介面命令集 Commands for GUI design

{!!}{script_{server_www_hostpath_{@@host}}idoor\product\fcl\header.htm}{!!}

FCL v2 GUI子命令集預覽　更新日期: 2022/12/14　<FCL 雲端語言>　Windows/Android/iOS

伺服器端命令格式: {i.命令} 例如: {i.create} {i.destroy}
用戶端命令格式 : {ic.gui_命令} {ic.gui_create} {ic.gui_destroy} ...

** 可用[,]或[_]作為參數的間隔符號(如果參數包含逗號則須用_作間隔符號).
** 可用顏色值代替顏色號,多個編號用&分隔.

{ic.gui_const} 可以返回各種常數值,例如: {ic.gui_const_style:title+frame+buffer}
或: {ic.gui_const_misc:off}

{ic.gui_get_編號,標識} 可以取得視窗的狀態標識: get:state|width|height

Create
Destroy
Resize
Move
Icon
Image
Picture
VLine
Line
LineColor
View
Command
Show
Timer
Hover
Set
Scroll
Mover
Clear
Progress
Menu

Enable
Parent
Focus
Space
Font
ToXY
ToLC
Color
Print
Cursor
Text
Visit
Visit
Palette
Palette
Bar
Synch
Lock
Background
Tooltip

Pen
Mode
Map
Origin
Transform
Paint
aLine
Box
Block
Circle
Pie
Arc
Ellipse
Chart
Save
Copy
Tray
Key
Browser
Scrollbar

開啟視窗
關閉視窗
改變視窗大小
改變視窗位置
設定視窗圖標
設定視窗背景圖畫
顯示圖畫
設定豎線
橫線開關
設定間線的顏色
設定預覽文件
設定命令
顯示視窗
設定計時器
設定檢測鼠標停留及離開
設定狀態
捲動視窗
設定捲動棒作用的視窗編號
清除視窗內容
顯示進度棒
操作視窗的項目表

設定視窗生效/失效
設定視窗所在容器
設定當前視窗
設定視窗行列間距
設定字體
設定字符顯示位置(點)
設定字符顯示位置(行列)
設定顯示字符的顏色
顯示字符
設定光標位置
在指定位置顯示字符
捲動到指定的光標位置
設定捲動範圍的調整行列數
設定視窗調色盤
從文件讀入調色盤
設定視窗橫標
同步視窗的參數
鎖定鍵盤及鼠標
改變視窗的背景顏色
設定單出式提示

設定用於作圖的筆
設定作圖顏色狀態
設定圖形坐標對映
設定圖形坐標原點
設定圖形坐標轉換
在封閉區域填色
劃線段
劃方格
劃方塊
劃圓形
劃扇形
劃弧
劃橢圓
劃統計圖
儲存視窗內容
複製視窗內容
設定通知區圖標
設定視窗按鍵
開啟瀏覽器視窗
捲動棒開關

Create - 開啟視窗

{i.create_編號,容器,款式,備註,背景,橫坐標,縱坐標,寬,高}

款式:

Frame    - 凸起的框      Buffer - 緩沖區        Title   - 題目          Hand     - 手型鼠標
HLine    - 加橫線        Focus   - 焦點效果      Mover   - 鼠標移動鍵   ULine    - 加下劃線
FixPos   - 不許移動      HScroll - 橫捲棒        VScroll - 豎捲棒        HDScroll - 橫資料捲棒
VDScroll - 豎資料捲棒    DScroll - 拉動資料換行 Button - 鼠標鍵        Tick     - 型鼠標鍵
Scroll   - 捲棒型鼠標鍵 Edge    - 粗框          Caption - 視窗系統標題 Gradual - 漸進顏色鼠標鍵
Edit     - 允許編輯      Browser - 瀏覽器        Hidden - 隱藏          Radio    - 單選型鼠標鍵
Image    - 圖片

- 如果高度小於零, 表示坐標及寬高使用行列數, 寬度小於零, 表示從橫坐標起,取整個容器寬度.

- 背景顏色-2表示由系統決定, 背景顏色-3,-4表示由系統通過背景取樣決定顏色(-3表示選取黑色或白色, -4表示選取黃色或藍色).

- Edit款式可以配合HLine(多行), HScroll及VScroll, Under(密碼模式).

Destroy - 關閉視窗

{i.destroy_編號}

Resize - 改變視窗大小

{i.resize_編號,橫向,縱向,標識} 標識: Size:Abs+Left+Top+Right+Bottom

Abs - 絕對值 Left - 左 Top - 上 Right - 右 Bottom - 下 LC - 行列大小 Half - 半行大小

Point - 焦點坐標 Scroll - 更新捲動

Move - 改變視窗位置

{i.move_編號,x,y,標識} 標識: Move:Abs+Horz+Vert

Abs - 絕對值 Horz - 橫向移動 Vert - 縱向移動 Child - 子視窗 All - 全部 LC - 行列位置 Half - 半行位置

Synch - 同步 Center - 對中 (x=0, y=0 亦表示對中)

Background - 改變視窗背景顏色

{i.background_編號,顏色號} 顏色號 0-255

Title - 設定視窗題目

{i.title_編號,橫坐標,縱坐標,前景,背景,題目字串}

顏色號 0-255
橫坐標 = 0 齊左, = -1 對中, = 其他負值n 表示從右起數n點
縱座標 = 0 齊上, = -1 對中, = 其他負值n 表示從下起數n點

Icon - 設定視窗圖片

{i.icon_編號,橫坐標,縱坐標,寬,高,圖形文件名稱}

坐標=-1 表示對中寬,高=0 表示吻合視窗 =-1 不改變大小 =-2 按比例吻合視窗

-3 圖片大於視窗時按比例吻合視窗, 小於視窗時吻合視窗
-4 圖片大於視窗時按比例吻合視窗, 小於視窗時不改變大小

文件名稱不加路徑表示使用臨時目錄.

文件名稱: * 表示使用視窗系統的背景圖片. *頁數表示設定多頁圖片的當前頁.

Picture - 顯示圖畫

{i.picture_編號,寬,高,圖形文件名稱} 文件名稱不加路徑表示使用臨時目錄

VLine - 設定豎線

{i.Vline_編號,列1&列2&...} 如果列數資料為0表示關閉豎線

Line - 橫線開關

{i.line_編號}

LineColor - 設定間線的顏色

{i.linecolor_編號,顏色號} 顏色號 0-255

View - 設定預覽文件

{i.view_編號,頁數,寬,高,標識,文件名稱} 標識: View:Set+Prev+Next+Print+Save+mail

Set - 設定 Prev - 上頁 Next - 下頁 Print - 打印 Save - 儲存 Mail - 電郵

Command - 設定命令

{i.command_編號,命令}

可設定所有iClient或iServers命令
左右鍵命令用{CH0}隔開

Show - 顯示視窗

{i.show_編號,標識} 標識: Show:Hide+Restore+Minimize+Maximize+Show+Scroll+Refresh+Synch

Hide - 隱藏 Restore - 恢復 Minimize - 最小化 Maximize - 最大化 Show - 顯示 Scroll - 刷新捲動棒

Open - 刷新視窗及其子視窗 Redraw - 刷新子視窗 Refresh - 刷新頂層視窗 Synch - 刷新並更新屬性

Timer - 設定計時器

{i.timer_編號,毫秒,標識} 標識: Timer:OneTime+Mouse+Command+Synch+Refresh+Flash

OneTime - 只執行一次 Mouse - 傳送鼠標位置 Command - 執行命令 Synch - 同步視窗參數
Refresh - 刷新視窗及其子視窗 Flash - 閃動視窗題目

最多設定5個計時器.
毫秒為零表示取銷標識所指的計時器, 標識同時為零則表示取銷所有計時器
在{i.command}設定的命令串中, 只使用字符{CH0}左邊的命令

Hover - 設定檢測鼠標停留及離開

{i.hover_編號,毫秒,標識} 標識: Timer:OneTime+Mouse+Command

OneTime - 只執行一次 Mouse - 傳送鼠標位置 Command - 執行命令

最少1毫秒.
在{i.command}設定的命令串中, 字符{CH0}左邊是停留時執行的命令, 右邊是離開的命令

Set - 設定狀態

{i.set_編號,類型,狀態}     類型: Set:State   狀態: State:Checked|Unchecked+NotUse
                                Set:FixPos        Misc:On|Off
                                Set:DataBar       Misc:On|Off
                                Set:Drop          Misc:On|Off
                                Set:Synch         同步視窗編號
                                Set:FanJian       0 系統 1 簡體 2 繁體

Checked - 已核 Unchecked - 未核 NotUse - 失效

Scroll - 捲動視窗

{i.scroll_編號,DX,DY,標識} 標識: Misc:xy|lc

xy - 使用xy坐標 lc - 使用行列坐標

Scrollbar - 卷動視窗

{i.scrollbar_編號,類型,開關} 類型: scroll:horz|vert|both
開關: misc:on|off

horz - 橫捲動棒 vert - 豎捲動棒 both - 橫豎兩者

on - 開 off - 關

Mover - 設定捲動棒作用的視窗編號

{i.mover_編號,視窗號}

Clear - 清除視窗內容

{i.clear_編號}

Enable - 設定視窗生效/失效

{i.enable_編號,狀態} 狀態: Misc:On|Off

On - 開 Off - 關

Parent - 設定視窗所在容器

{i.parent_編號,容器編號}

Focus - 設定當前視窗

{i.focus_編號}

Space - 設定視窗行列間距

{i.space_編號,上界,左界,行間距,字間距}

內定: 上界=0 左界=0 行間距=6 字間距=0

Font - 設定字體

{i.font_編號,高度,寬度,類型,字體名稱} 類型: Font:Chn+Eng+AdjH+AdjW+Bold+Line+Fix

Chn - 設定中文 Eng - 設定英文 AdjH - 調整高度 AdjW - 調整寬度 Bold - 粗體 Line - 底線 Fix - 等寬

如果高度及寬度為零,表示保留原來設定的高度及寬度,高度和寬度為負數,表示增加按行列設定字體大小

ToXY - 設定字符顯示位置(點)

{i.toxy_編號,X,Y}

ToLC - 設定字符顯示位置(行列)

{i.tolc_編號,L,C}

Color - 設定顯示字符的顏色

{i.color_編號,前景顏色號,背景顏色號}

背景顏色號 = -1 表示透明

Print - 顯示字符

{i.print_編號,字符串}

Cursor - 設定光標位置

{i.cursor_編號,狀態} 狀態: Cur:Thin|Thick|Off

Thin - 幼 Thick - 粗 Off - 關閉

Text - 在指定位置顯示字符

{i.text_編號,行,列,顏色號,字符串} 顏色號 0-255

Visit - 捲動到指定的光標位置

{i.visit_編號}

Visit - 設定捲動範圍的調整行列數

{i.visit_編號,左,上,右,下,標識}

標識: 1 - 更新時捲動 -1 - 不允許自動捲動

Palette - 設定視窗調色盤

{i.palette_編號,顏色號,顏色值} 顏色號 0-255

下列顏色已設定與Windows配合:

&HF6 (246) - 3D物件       &HF7 (247) - 當前視窗題目 &HF8 (248) - 應用程式工作區
&HF9 (249) - Windows桌面 &HFA (250) - 按鈕文字      &HFB (251) - 信息背景
&HFC (252) - 項目表背景   &HFD (253) - 對話盒        &HFE (254) - 視窗背景
&HFF (255) - 視窗中的文字

Palette - 從文件讀入調色盤

{i.palette_編號,文件名稱}

文件格式: 0,&HRRGGBB      RR-紅 GG-綠 BB-藍
          1,&HRRGGBB
          ......

Bar - 設定視窗橫標

{i.bar_編號,行數,長度,顏色號} 顏色號 0-255

Synch - 將視窗在用戶端的參數傳送到伺服器

{i.synch_編號_子視窗_位置} 子視窗: Misc:On|Off
位置: Misc:On|Off

Lock - 鎖定鍵盤及鼠標

{i.lock_編號,標識} 標識: Misc:On|Off

On - 開 Off - 關

Pen - 設定用於作圖的筆

{i.pen_編號,虛實,寬度,顏色號} 虛實: 0|1

Mode - 設定作圖顏色狀態

{i.mode_編號,狀態} 狀態: 0|1

狀態=0 表示置換, =1 表示XOR

Map - 設定圖形坐標對映

{i.map_編號,寬度,高度}

Origin - 設定圖形坐標原點

{i.origin_編號,X,Y}

Transform - 設定圖形坐標轉換

{i.transform_編號,X1,Y1,X2,Y2}

X1,Y1,X2,Y2 可用浮點數

Paint - 在封閉區域填色

{i.paint_編號,橫坐標,縱坐標,標識,顏色號,填上顏色號}

標識=0 顏色號代表邊界顏色, =1 顏色號代表區域顏色

aLine - 劃線段

{i.aline_編號,X1,Y1,X2,Y2}

如果X1=-1,Y1=-1 表示從當前坐標開始劃, Y2 < 0 表示使用行列坐標

Box - 劃方格

{i.box_編號,X,Y,寬度,高度}

高度 < 0 表示使用行列坐標

Block - 劃方塊

{i.block_編號,X,Y,寬度,高度,淺顏色號,深顏色號}

高度 < 0 表示使用行列坐標

Circle - 劃圓形

{i.circle_編號,X,Y,半徑}

Pie - 劃扇形

{i.pie_編號,X,Y,半徑,起始角度,終止角度,顏色號}

Arc - 劃弧

{i.arc_編號,X,Y,W,H,X1,Y1,X2,Y2}

X,Y,W,H - 定義弧所在的方格 X1,Y1 - 起點 X2,Y2 - 終點

Ellipse - 劃橢圓

{i.ellipse_編號,X,Y,W,H}

X,Y,W,H - 定義橢圓所在的方格

Chart - 劃統計圖

{i.chart_編號,標識,小數位數,顏色遞增數,坐標名稱,數據}

標識=0 條形圖, =1 線形圖, =2,3,4 扇形圖(2無字,3百分比,4坐標文字)

標識+1000 排序, +2000 正負對調

Save - 儲存視窗內容

{i.save_編號,X,Y,W,H,文件名稱}

W=0 取整個寬度 H=0 取整個高度支援格式:BMP,GIF,TIF,JPG,PNG

只允許儲存在用戶端的臨時文件目錄

Copy - 複製視窗內容

{i.copy_來源編號,目的編號,X,Y,W,H}

W=0 取目的地整個寬度 H=0 取目的地整個高度

Tray - 設定通知區圖標

{i.tray_編號,字串,圖標文件,開關} 開關: Misc:on|off

Key - 設定視窗按鍵

{i.key_編號,設定,按鍵串} 設定: Key:Allow+Prohibit+Escape

Allow 設定允許輸入的按鍵 (例如: ~k.esc~c.cr, 不能與key:prohibit同時使用)
Prohibit 設定禁止輸入的按鍵 (例如: ~c.n~k.cr, 不能與key:allow同時使用)
Escape 設定伺服器端的功能鍵 (例如: ~k.esc~c.cr, 只對edit,browser視窗有效)

瀏覽器視窗需先執行{i.browser_編號,browser:exton}

Progress - 顯示進度棒

{i.Progress_編號,動作,參數1,參數2} 動作: Progress:Range+Step+StepIt+SetPos+Status

Range - 設定範圍參數1 = 下限參數2 = 上限 (參數0,0表示取消進度棒功能)
Step - 設定步長參數1 = 步長值 (內定範圍的10%)
StepIt - 增加一步
SetPos - 設定位置參數1 = 位置參數2 <> 0 表示增減, = 0 表示絕對值
Status - 設定系統進度棒參數1 = 1 表示開, = 0 表示關 (開啟後傳送文件會顯示進度)

Browser - 開啟瀏覽器視窗

{i.browser_編號,動作,參數}             動作: Browser:Navigate+Prev+Next+Refresh+Stop+Print+Preview+Key+Exton+Extoff

Navigate 瀏覽網頁參數 = URL
Prev     上頁
Next     下頁
Refresh 重整
Stop     停止
Print    打印
Preview 預視
Key      禁止瀏覽器使用按鍵參數 = 1 禁止, = 0 不禁止
Exton    開始收集網頁參數   參數 = 用戶點擊連結時傳送至伺服器端的按鍵串
         用戶端軟件把URL轉換為變量內容{@@url}{@@參數1}..
         可以使用擴充的格式: abcd~f.k11?p1=1&p2=2
         用戶端處理完參數後向伺服器端發送按鍵[F11]
         伺服器端可用{C%(ic.return_(@@url))}{&&test_{C%}}取得各個變量的內容
Extoff   結束收集網頁參數

Tooltips - 設定單出式提示

{i.tooltips_編號,字串}

不提供字串表示取消彈出提示

Menu - 操作視窗的系統項目表

{i.menu_編號,動作,位置,按鍵,名稱} 動作: Menu:Insert+Delete

{!!}{script_{server_www_hostpath_{@@host}}idoor\ubottom.htm}{!!}