資料表格（TsRadGridView）

功能視窗的明細區與查詢結果都以 TsRadGridView 資料表格呈現。以下操作對所有資料表格通用。

顏色代表什麼

資料表格用少數幾種顏色提示狀態，看到顏色不必猜：

欄位標題

標題顏色	意思
黑色（一般）	可編輯的欄位
灰色	這一欄不能改。進入 新增／修改 後，唯讀欄（系統計算、反查帶出的名稱等）的標題會變灰；整個表格在瀏覽狀態時維持正常顏色，不會整排變灰

資料列

你看到的	意思
列最左側的細條變紅色	這筆已按過 刪除此筆資料，標記為待刪除，按 儲存 時才真正刪掉；存檔前可再按一次取消
列最左側的細條變深灰	這筆不可編輯
整列淡綠底	目前選取中的那一筆（單據明細類表格）
整列紅底	檢核未通過的資料，只出現在稽核／檢查類表格（例如成本計算、庫存基準檢查），紅底那一列就是要處理的

少數查詢程式另有自己的顏色規則（例如生產查詢的假日欄標題以紅色標示），該程式的手冊頁會另外說明。單據上方欄位標籤的顏色（紅＝必填、藍＝主鍵、灰＝系統產生）見共用控制項操作。

欄位標題右鍵選單

在欄位標題上按滑鼠右鍵，會出現下列選單（項目文字會自動帶入你點到的欄名）：

選單項目	功能說明
依"欄名"遞增排序	依該欄由小到大排序（同一時間只保留最後選的排序方式）
依"欄名"遞減排序	依該欄由大到小排序
清除"欄名"的排序	取消該欄的排序
依"欄名"群組	依該欄的值分組顯示
取消"欄名"群組	取消該欄的群組
打開群組面板	切換顯示／隱藏最上方的群組拖放面板（可將欄位拖進去做群組）
自動調整欄寬	一次把所有欄位寬度調整成貼合內容
記憶格式	把目前的欄位版型（欄序／欄寬／隱藏欄位）存成永久版型，詳見版型記憶
匯出至 Excel	把資料表格內容匯出成 Excel 檔，詳見匯出 Excel

資料列右鍵選單

在資料列（內容）上按右鍵，依程式與欄位型態會出現下列項目：

選單項目	功能說明	出現時機
複製當前儲存格	複製點到的儲存格內容到剪貼簿	一般資料表格皆有
新增數筆	一次新增多筆空白列	可新增明細、且在編輯狀態才可按
刪除此筆資料	將點到的這一列標記刪除	可新增明細、且在編輯狀態才可按
全部勾選	把勾選欄一次全部打勾	明細有勾選欄、且在編輯狀態
取消勾選	把勾選欄一次全部取消	明細有勾選欄、且在編輯狀態
從 Excel 匯入	由 Excel 檔匯入資料到明細，詳見從 Excel 匯入	支援匯入的可編輯明細

非編輯狀態時

新增數筆、刪除此筆資料、勾選相關項目在非編輯狀態下會呈停用（灰色）。請先按工具列的 新增 或 修改 進入編輯狀態。

一鍵自動欄寬

在資料表格左上角（列標記上方那一格）點兩下，即可一次把所有欄位寬度調整成貼合內容，效果同右鍵的 自動調整欄寬。滑鼠移到該處會顯示提示「點兩下自動調整欄寬」。

日期欄按兩下跳到行事曆

在資料表格的日期欄儲存格點兩下，主畫面最右側的行事曆會自動開啟並跳到該日期，事件清單同步切換成當天。這是額外加掛的動作，儲存格原本的反應（在編輯狀態下點兩下會進入該格編輯）維持不變。儲存格為空或不是有效日期時不會有反應；在跳出的獨立視窗內也不會跳轉，因為行事曆面板只在主畫面。單筆日期欄位的相同操作見其他常用輸入控制項。

按兩下資料表格的受訂日期儲存格（2026/01/02），右側行事曆跳到該日並選中。（實機截圖）

調整欄寬、欄序、排序與群組

• 欄寬：拖曳欄位標題交界處即可加寬／縮窄。
• 欄序：按住欄位標題拖曳到目標位置放開，調整欄位順序。
• 排序：可用右鍵選單，或直接點欄位標題切換排序（多數資料表格支援）。
• 群組：先用 打開群組面板 顯示群組面板，再把欄位標題拖進面板即可分組。

版型記憶

按欄標題右鍵的 記憶格式 後，這個資料表格的版型會被記住：

• 儲存的內容：每一欄的欄序（顯示順序）、欄寬、是否隱藏，以及凍結欄數（左側釘選欄數）。
• 不會儲存的內容：排序、群組、欄位篩選不會存入永久版型（見下方說明）。
• 儲存位置：存到資料庫，並以「程式代號＋該資料表格名稱」為鍵，因此同一支程式的每個資料表格各自記憶；下次開啟同一程式時自動套回。
• 排序／群組的暫存行為：你當次做的排序與群組屬於「本次執行的暫存版型」——在同一程式內切到別的畫面再切回來會保留，但關閉程式後即還原，不會存成永久版型。

還原預設版型

目前畫面上沒有「一鍵還原預設版型」的按鈕。若要回到系統預設欄位配置，需請系統管理員清除該資料表格已存的版型記錄。（此還原途徑未於本次程式碼中確認，請以實際系統設定為準。）

匯出 Excel

按欄標題右鍵的 匯出至 Excel：

1. 跳出「另存新檔」對話框，預設檔名為「資料表格名稱_日期時間.xlsx」，預設目錄為系統設定的 Excel 匯出目錄。
2. 選好位置存檔後，系統會將資料表格內容輸出成 .xlsx，並包含欄標題、欄位小計與群組小計。
3. 匯出完成後會自動開啟該 Excel 檔。

匯出的欄位

匯出的是資料表格目前呈現的欄位與資料（含目前的排序／群組樣式）。若只想匯出部分欄位，可先隱藏不需要的欄再匯出。

從 Excel 匯入

部分可編輯的明細資料表格，資料列右鍵有 從 Excel 匯入。它靠表頭文字對應欄位做匯入，規則如下：

• 對應方式：Excel 的第 1 列必須是欄位標題，其標題文字需與資料表格的欄位標題一致（比對不分大小寫）；系統只對應「可見、可編輯」的欄位，資料從 Excel 第 2 列起讀取。
• 整批預檢、全有或全無：匯入前會先把每一格轉成對應型別做檢查；只要有任何一格轉不過，就整批中止，不會匯入一半。中止時會列出無法填入的儲存格（標明 Excel 列號與欄名，最多顯示前 20 筆）供你修正。
• 前置條件：需先進入編輯狀態才能匯入；若 Excel 表頭與資料表格欄位完全對應不到，會提示「Excel 表頭與表格欄位無一對應」。

匯入前先對齊表頭

最穩的做法是先用 匯出至 Excel 匯出一份空白或範例，直接在該檔的表頭下填資料，再匯入回來，可確保表頭文字完全一致。

需補截圖清單

以下截圖待補拍（放 docs/getting-started/controls/images/）：

1. grid-color-readonly-header.png — 任一單據明細按 修改 後，唯讀欄（如品名、金額小計）標題變灰、可編輯欄維持黑色，兩者同框
2. grid-color-row-states.png — 同一表格內一列按過 刪除此筆資料（左側紅色指示條）、另一列為目前選取（淡綠底）

相關功能

• 共用控制項操作
• 基本畫面介紹