應(yīng)用筆記 | TSMaster——圖形編輯面板功能模塊簡(jiǎn)介

圖形編輯面板

TSMaster 圖形編輯面板讓用戶能夠開發(fā)自己的圖形窗口，用于處理報(bào)文的收發(fā)，信號(hào)解析顯示等功能。

一 工具欄

1. 模式選擇按鈕，主要包含如下模式：

1）按下狀態(tài)時(shí)候，當(dāng)前 Panel 處于編輯模式下，用戶可以增加刪除控件，編輯控件屬性的。

2）彈起狀態(tài)，當(dāng)前 Panel 處于測(cè)試運(yùn)行模式，顯示的是該面板實(shí)際運(yùn)行時(shí)的狀態(tài)，用戶不可進(jìn)行編輯。

3）灰色狀態(tài)，當(dāng)前 Panel 處于運(yùn)行狀態(tài)。意味著當(dāng)前 TSMaster 處于設(shè)備連接運(yùn)行狀態(tài)。如果用戶想重新編輯界面，必須斷開 TSMaster 連接，才可以進(jìn)入編輯狀態(tài)。

2. 層疊控制

當(dāng)出現(xiàn)控件層疊情況時(shí)，把控件移動(dòng)到前面和把控件移動(dòng)到后面。

3. 對(duì)齊控件

控件對(duì)齊分為兩步：

1）首先選擇需要對(duì)齊的多個(gè)控件：按住 Ctrl 鍵，鼠標(biāo)點(diǎn)擊多個(gè)按鈕，則選中多個(gè)控件。如下所示：

2）選擇頂部菜單欄的對(duì)齊按鈕，如下所示：

對(duì)齊選項(xiàng)有：

? Align Left：左對(duì)齊

? Align Right：右對(duì)齊

? Align Top：上對(duì)齊

? Align Buttom：下對(duì)齊

? Center Horizontally：以中間模塊為準(zhǔn)水平對(duì)齊

? Center Vertically：以中間模塊為準(zhǔn)垂直對(duì)齊

? Distribute Horizontally:：橫向均勻排布

以最左邊和最右邊一個(gè)控件的坐標(biāo)為準(zhǔn)，計(jì)算控件之間間隔的平均值，然后在橫向上均勻排列。

? Distribute Vertically:：縱向均勻排布

以最上面和最下面一個(gè)控件的坐標(biāo)為準(zhǔn)，計(jì)算控件之間間隔的平均值，然后在縱向上均勻排列。

4.新建 Panel

創(chuàng)建全新的 Panel，此操作將刪除 Panel 所有現(xiàn)有的控件。

5. 加載配置

載入現(xiàn)有 Panel 配置文件。

6. 存儲(chǔ)配置

存儲(chǔ)當(dāng)前 Panel 的配置文件。

7.Panel 參數(shù)配置

主要包含如下參數(shù)配置：

? Feature Enable：是否使能 Panel

? Layout：Panel 內(nèi)部控件整體布局

? Design Time：設(shè)計(jì)時(shí)是否顯示鏈接標(biāo)簽和控件名稱

? Refresh Rate：配置 Panel 數(shù)據(jù)的刷新時(shí)間。推薦刷新時(shí)間為 300ms。如果電腦配置較高，可以配置更高的刷新率

二 控件基本操作

1. 添加控件

2. 刪除控件

直接 Delete 鍵，或者右鍵，快捷菜單選擇刪除。

3. 移動(dòng)控件

控件都會(huì)有自己所在的容器，在容器范圍內(nèi)，想調(diào)整位置，直接選中控件，左鍵按住，移動(dòng)即可。如下所示：

4.移動(dòng)到容器外面

TSMaster 不支持直接拖拽到容器外面，如果要把控件移出容易，可以采用剪切（Ctrl+X）+ 粘貼（Ctrl+V）的方式可以把控件移動(dòng)到容器外面。

5.顯示控件類型名

在設(shè)計(jì)時(shí)（Design Time）階段，默認(rèn)是顯示控件的名稱（這個(gè)名稱是控件的唯一 ID，是系統(tǒng)默認(rèn)分配的，不能修改，在運(yùn)行時(shí)不可見）的，如下圖所示：

如果在設(shè)計(jì)階段不想看到控件的唯一名稱，可以到 Settings 界面中進(jìn)行設(shè)置，如下所示：

6.顯示控件關(guān)聯(lián)的變量鏈接

在設(shè)計(jì)時(shí)（Design Time）階段，用戶可以設(shè)置顯示當(dāng)前控件所關(guān)聯(lián)的變量(CAN/LIN 信號(hào)或者系統(tǒng)變量等)，便于設(shè)計(jì)者清晰的知道當(dāng)前該控件所關(guān)聯(lián)的信號(hào)值，如下圖所示：

在設(shè)計(jì)時(shí)階段，打開和關(guān)閉該關(guān)聯(lián)信號(hào)的顯示，跟打開和關(guān)閉控件名稱的顯示操作是一樣的，如下圖所示：

三 UI事件

TSMaster 提供了豐富的 Panel 界面。通過關(guān)聯(lián)變量，可以實(shí)現(xiàn)變量值的修改，或者變量值修改過后在 UI 界面上呈現(xiàn)，這些都比較好理解。如果用戶要實(shí)現(xiàn)按下按鍵過后，TSMaster 軟件發(fā)送一串報(bào)文，則需要配合 C 腳本實(shí)現(xiàn) UI 事件機(jī)制。

UI 事件機(jī)制

Panel 的事件機(jī)制架構(gòu)圖如下圖所示：

Panel 事件機(jī)制的實(shí)現(xiàn)，簡(jiǎn)單來說可以概括如下：Panel 中用戶輸入（按下按鍵，輸入數(shù)值等）->改變關(guān)聯(lián)的小程序變量的值->觸發(fā) C 腳本中數(shù)值變化事件->在事件中執(zhí)行用戶想執(zhí)行的代碼即可。下面以按鍵發(fā)送報(bào)文為例講解 UI 事件的添加過程。

四 釋疑

1.為啥 DBC 解析是對(duì)的，Panel 上控件顯示不對(duì)？

問題描述：

為什么信號(hào)值 DBC 解析出來是 12%，但是儀表盤上總是顯示 1.0（100%）

查看信號(hào)定義，因?yàn)樾盘?hào)值定義的范圍是 0—100，單位為”%”,解析出來的信號(hào)值為12%，代表信號(hào)值為 12，然后單位是字符串”%”，并不是信號(hào)值是 0.12。因此，儀表盤的范圍應(yīng)該是 0—100，跟信號(hào)定義中的范圍是一致的。如果儀表盤的范圍設(shè)置為 0—1,則當(dāng)信號(hào)值顯示為 12%的時(shí)候，儀表盤當(dāng)然會(huì)顯示到最大值 1。

解決辦法：

設(shè)置儀表控件屬性，調(diào)整該控件的顯示范圍跟信號(hào)的范圍一樣。從 0-1 調(diào)整為 0-100，調(diào)整過后，儀表盤顯示正常。

2. 添加了 DBC，為啥通過 Panel 關(guān)聯(lián)信號(hào)的時(shí)候看不到任何信號(hào)？

問題描述：

加載了示例數(shù)據(jù)庫：TOSUN_Hardware_Synthesize

可以看到，有報(bào)文，有信號(hào)等。

在面板中，添加 InputOutputBox，選擇關(guān)聯(lián)一個(gè) CAN 信號(hào)，結(jié)果界面如下：

此時(shí)如果用單存顯示控件，如 Progressbar 等關(guān)聯(lián)信號(hào)，是可以看到信號(hào)的。

原因分析：

InputBox 是輸入信號(hào)，這種信號(hào)從邏輯上來說需要被修改并發(fā)送到總線上，因此必須關(guān)聯(lián)到一個(gè)發(fā)送節(jié)點(diǎn)的 CAN 信號(hào)上。然后我們繼續(xù)看這個(gè)數(shù)據(jù)庫：

可見，節(jié)點(diǎn)數(shù)量為 0，也就是沒有任何發(fā)送和接收節(jié)點(diǎn)。這種情況下是無法啟動(dòng) RBS仿真的，因?yàn)闆]有發(fā)生節(jié)點(diǎn)，也就看不到任何跟發(fā)送節(jié)點(diǎn)相關(guān)的信號(hào)了。

解決辦法：

添加發(fā)送節(jié)點(diǎn)，并把報(bào)文和信號(hào)關(guān)聯(lián)到發(fā)送節(jié)點(diǎn)上，就可以看到信號(hào)了。

3.Panel 中看不到滾動(dòng)條

在設(shè)計(jì) Panel 的時(shí)候，出現(xiàn)看不到窗體看不到滾動(dòng)條（垂直+水平）的情況。如果窗體面積很大，超出了屏幕顯示范圍，就會(huì)出現(xiàn)一部分窗體被遮擋的情況。如下所示：

原因分析：

電腦屏幕設(shè)置了縮放，造成控件內(nèi)部不能正確計(jì)算相對(duì)屏幕的尺寸，因此無法正確顯示滾動(dòng)條。查看電腦設(shè)置如下：

解決方案：

關(guān)閉屏幕縮放，設(shè)置縮放為 100%，重啟軟件，即可重新看到窗體的滾動(dòng)條。

可以看到，在窗體上重新出現(xiàn)了滾動(dòng)條（垂直+水平），如下所示：