屬性名稱
|
描述
|
基礎類型
|
預設值
|
是否可繫結 (Y/N)?
|
適用於網格還是樹網格?
|
||||
---|---|---|---|---|---|---|---|---|---|
Id*
|
ThingWorx 在內部使用的唯一識別元。
|
INTEGER
|
Gridadvanced-<id>或
Treegridadvanced--<id>
|
N
|
二者
|
||||
Type*
|
小器具類型。
|
n/a
|
Grid-Advancedor Tree-Grid-Advanced
|
N
|
二者
|
||||
DisplayName*
|
用來在顯示時識別網格的使用者定義名稱。
|
STRING
|
gridadvanced-nor treegridadvanced-n
|
N
|
二者
|
||||
Description*
|
使用者定義的描述。
|
STRING
|
n/a
|
N
|
二者
|
||||
Data*
|
啟動網格時載入的資料來源。 如果將網格繫結至子資料來源,會顯示實心箭頭: 如果沒有資料來源,則會顯示 。 |
INFOTABLE
|
n/a
|
Y
|
二者
|
||||
ChildData*
|
展開節點時動態載入之子資料的來源。 如果將網格繫結至子資料來源,會顯示實心箭頭: 如果沒有子資料來源,則會顯示 。 |
INFOTABLE
|
n/a
|
Y
|
僅限樹網格
|
||||
ParentIDFieldName
|
識別父 ID 欄位名稱。若要建立階層樹狀結構,必須使用此內容。
|
STRING
|
parentId
|
N
|
僅限樹網格
|
||||
IDFieldName
|
網格的主索引鍵欄。此欄中的值可作為每個資料列的唯一識別元使用。此內容對於進階網格為選用內容,對於樹網格為必要內容。
如果未指定欄位,或者如果指定的欄位不存在,則網格會建立它自己的內部列 ID。
|
STRING
|
id
|
N
|
二者
|
||||
IDPathSeparator
|
可讓您配置路徑分隔符號字元。
路徑分隔符號字元在樹網格中用來選取由網格動態載入但未在用戶端載入的列。請參閱動態載入列的列選取部份。
|
STRING
|
:;
|
N
|
僅限樹網格
|
||||
HasChildrenFieldName
|
指定欄名稱,以指示列是否有可用的子資料。
若要指示列沒有子項,請輸入下列其中一項:'0'、0、'false'、false、empty string 或 undefined。
其他任何值都表示列有子項。
|
STRING
|
hasChildren
|
N
|
僅限樹網格
|
||||
Configuration*
|
如果將網格繫結至組態服務,會顯示實心箭頭: 如果沒有組態服務,則會顯示 。
|
STRING
|
n/a
|
Y
|
二者
|
||||
IsEditable
|
決定當網格在執行時間顯示時,您是否可以編輯網格儲存格中的值。若啟用此內容,EditCellStarted 與 EditCellComplete 事件會顯示在「內容」面板中。
|
BOOLEAN
|
False
|
N
|
二者
|
||||
EnableEditButtons
|
啟動網格工具列中的「編輯」、「儲存」及「取消」,以手動儲存編輯。
如果您要自動儲存變更,請設定上述的 IsEditable 內容。如果您要手動儲存變更,請設定 EnableEditButtons 內容。
如需詳細資訊,請參閱《進階網格中的儲存格編輯》。
若設定此內容時,下列小器具內容會顯示在「內容」面板中。
• 組態內容 - EnableAddDeleteButtons 與 EditButtonsLocation
• 事件 - EditStarted、EditCompleted 與 EditCancelled。
|
BOOLEAN
|
False
|
N
|
二者
|
||||
EnableAddDeleteButtons
|
若您將此內容設定為 True,「新增」與「刪除」會顯示在格點工具列中,以便您可以新增或刪除網格中的列。
|
BOOLEAN
|
False
|
N
|
僅限進階網格
|
||||
EditedTable
|
在執行時間編輯儲存格時,為已更新值指定輸出位置的可繫結內容。此內容必須繫結至資料負載更新服務,才能儲存更新的值。例如,繫結至資料表物件上的 AddOrUpdateDataTableEntries 服務。
|
INFOTABLE
|
n/a
|
Y
|
二者
|
||||
EnableKeyboardNavigation
|
可讓您使用鍵盤導覽小器具。
|
BOOLEAN
|
True
|
Y
|
二者
|
||||
DeletedTable
|
此內容可指定在執行時間從網格刪除之列的輸出位置。
此內容必須繫結至資料負載更新服務,才能儲存更新的值。例如,將內容繫結至資料表物件上的 AddOrUpdateDataTableEntries 服務。
|
INFOTABLE
|
n/a
|
Y
|
僅限進階網格
|
||||
DisplayOnlyMode
|
在僅顯示模式下設定網格。
|
BOOLEAN
|
False
|
Y
|
二者
|
||||
DefaultSelectedRows
|
定義當顯示網格時預設會反白哪些列編號。值可以包含逗號分隔的數值與範圍。
範例:1,2,4-5 此內容也可以由繫結服務定義。如果繫結服務,會顯示 。 如果沒有服務,則會顯示 。
|
STRING
|
n/a
|
Y
|
二者
|
||||
SelectedRows*
|
透過 INFOTABLE 來源定義當顯示網格時,預設會反白哪些列。
在樹網格中使用時,進行列選取時只需要「列 ID」欄,但您也可以包括其他欄。
在進階網格中,會透過將服務中 SelectedRows 參數的輸出繫結至網格上的輸入 SelectedRows 內容,來處理列選取。
此內容在輸出或輸入方向為可繫結,以便一個實體可以控制在另一個實體中的列選取。例如,一個表格可以控制第二個表格中的列選取,或者您也可以使用 3D 圖像來選取表格中的列。 如需控制實體,請將服務繫結為輸出 INFOTABLE 如需實體被控制,請將服務繫結為輸入 INFOTABLE:
|
INFOTABLE
|
n/a
|
Y
|
二者
|
||||
IncludeRowExpansionParents*
|
決定當選取或展開子列時,是否包括未包括在預先載入用戶端資料中的父列。若為 True,會擷取包含子列的父列,以便可以重新建立階層。
|
BOOLEAN
|
False
|
N
|
僅限樹網格
|
||||
ExpandRows*
|
網格中應展開之任何頂層或子列的 ID。選取列以展開時,只需要「列 ID」欄。
|
INFOTABLE
|
n/a
|
Y
|
僅限樹網格
|
||||
ExpandLoadedRows*
|
啟動網格時,會自動展開所有預先載入的資料。
|
BOOLEAN
|
False
|
Y
|
僅限樹網格
|
||||
ExpandRowOnDoubleClick
|
當您連按兩下列或按一下節點圖示時,會展開包含子項的列。
在 JSON 組態服務中,內容名稱為:treeSettings.expandRowOnDoubleClick。
|
BOOLEAN
|
False
|
N
|
僅限樹網格
|
||||
PreserveRowExpansion
|
重新整理網格時,會保留列展開選取。使用此內容時,請確定樹載入資料服務中的 maxLevels 內容設定為大於您要展開至的層級的值。如需有關資料服務的詳細資訊,請參閱使用樹網格資料
|
BOOLEAN
|
False
|
N
|
僅限樹網格
|
||||
RowSelection
|
控制可以配置哪一個列選取。選項:none、single 或 multi。
|
STRING
|
無
|
N
|
僅限網格
|
||||
AutoScroll
|
控制當重定網格大小或重新整理服務時,網格是否自動捲動至所選列。
|
BOOLEAN
|
False
|
N
|
二者
|
||||
CookiePersistence*
|
可針對某些欄設定 (順序、大小、可見度與排序順序) 啟動用戶端持續性。
|
BOOLEAN
|
True
|
N
|
二者
|
||||
EnableContextMenu*
|
啟用或禁用網格前後關聯選單在執行時間的顯示,終端使用者可用來顯示或隱藏特定欄。與 CookiePersistence 搭配使用:
• 如果同時設定這兩個內容 - 使用者可以顯示及隱藏欄,且這些選取會持續。
• 如果未設定 EnableContextMenu 而設定了 CookiePersistence - 使用者無法顯示或隱藏欄,但之前的選取會保持不變。
• 如果已設定 EnableContextMenu 但未設定 CookiePersistence - 您可以顯示及隱藏欄,但僅適用於目前請求。
在 JSON 組態服務中,您可將內容設定為頂層參數,方式如下:
var config = {“enableContextMenu”: false,...}
|
BOOLEAN
|
True
|
N
|
二者
|
||||
EnableSorting
|
必須設定才能進行任何類型的欄排序,包括在標題、MultiColumnSortOrder 內容或繫結排序服務的遞增與遞減之間切換。若設定此選項,「內容」面板中的下列內容會變為可用:
• QueryFilter - 與資料服務搭配使用的可繫結篩選器查詢。
• Filter - 用來觸發查詢資料服務的可繫結事件內容。
|
BOOLEAN
|
False
|
N
|
二者
|
||||
MultiColumnSortOrder
|
設定預設欄排序順序。語法:column name:order,column name:order
範例:office:asc,title:des
|
STRING
|
n/a
|
N
|
二者
|
||||
EnableGridSearch
|
在網格上放置具有全域搜尋方塊的工具列。若設定此選項,「內容」面板中的下列內容會變為可用:
• QueryFilter - 與資料服務搭配使用的可繫結篩選器查詢。
• Filter - 用來觸發查詢資料服務的可繫結事件內容。
|
BOOLEAN
|
False
|
N
|
二者
|
||||
GridSearchLocation
|
定義放置搜尋方塊的位置。只有在設定 EnableGridSearch 內容後,此選項才會變為可用。
|
STRING
|
n/a
|
N
|
二者
|
||||
QueryFilter*
|
這是一個可繫結的查詢內容,用來將查詢服務繫結為輸入查詢參數,以控制資料的排序、搜尋與篩選。開啟 EnableSorting 或 EnableGridSearch 內容後,此內容會變為可用。您可以從內容面板或網格本身的前後關聯選單中設定此內容。 如果您要在混搭中使用資料篩選器小器具,可以從進階網格或樹網格小器具將輸出 QueryFilter 內容繫結至輸入查詢內容。網格會組合所有查詢參數,以建立繫結至指定服務的單一輸出篩選器。當在兩個方向以這種方式繫結查詢篩選器時,會顯示實心箭頭: 如果沒有資料篩選器小器具,且繫結僅在輸出方向,則一個箭頭為實心,另一個箭頭為空心: |
QUERY
|
n/a
|
Y
|
二者
|
||||
EnableGridReset
|
放置具有網格「重設」按鈕的工具列。按一下「重設」可清除儲存在 cookie 中的所有網格使用者設定,並將網格恢復為其預設組態。
|
BOOLEAN
|
False
|
N
|
二者
|
||||
EnableFilterEventOnConfigChange*
|
可在從服務更新組態時,開啟或關閉事件觸發。
若設定此內容,且已變更繫結組態,會觸發篩選器事件來同時更新資料。如果未設定此內容,在更新繫結組態時,不會觸發篩選器事件。
|
BOOLEAN
|
True
|
N
|
二者
|
||||
EnableFooter
|
在網格中啟用頁尾部份。若將此內容設定為 True,會設定另外兩個名為 FooterData 與 TableFooterStyle 的內容。
頁尾部份的資料使用 FooterData 內容進行繫結。
如需詳細資訊,請參閱進階網格中的頁尾部份
|
BOOLEAN
|
False
|
N
|
二者
|
||||
FooterData
|
包含顯示在網格頁尾的資料。
|
INFOTABLE
|
n/a
|
Y
|
二者
|
||||
GridResetButtonLocation
|
定義放置網格重設按鈕的位置。
|
STRING
|
n/a
|
N
|
二者
|
||||
RowFormat
|
可開啟一個對話方塊,您可在其中定義選用的以列為基礎的規則,來套用動態「狀態格式」。這些以列為基礎的規則可由以儲存格為基礎的狀態格式取代,可從網格前後關聯選單的「配置格點欄」選項中找到此功能。
|
STATE FORMATTING
|
狀態格式
|
N
|
二者
|
||||
TableWrapperStyle
|
定義網格背景樣式。這會在整個表格周圍新增輪廓顏色,並設定背景顏色。支援的屬性包括線條顏色、線條粗細、線條樣式、背景顏色以及替代背景顏色。
|
STYLEDEFINITION
|
DefaultTableWrapperStyle
|
N
|
二者
|
||||
TableHeaderStyle
|
定義網格標題樣式。
|
STYLEDEFINITION
|
DefaultTableHeaderStyle
|
N
|
二者
|
||||
FocusStyle
|
定義在網格中具有焦點之列的樣式。
|
STYLEDEFINITION
|
DefaultFocusStyle
|
N
|
二者
|
||||
RowBackgroundStyle
|
定義列背景樣式。這會新增背景顏色、字型顏色以及粗細樣式,但不會將線條樣式新增至每一列。
|
STYLEDEFINITION
|
DefaultRowBackgroundStyle
|
N
|
二者
|
||||
RowAlternateBackgroundStyle
|
為替代列定義另一個列背景樣式。這會新增字型顏色與粗細樣式,但不會新增線條樣式。
|
STYLEDEFINITION
|
DefaultRowAlternateBackgroundStyle
|
N
|
二者
|
||||
RowHoverStyle
|
定義當您將指標置於列上時列的樣式。這會將背景顏色與字型新增至每個儲存格。線條顏色、粗細與類型只會套用至放置指標的列。
|
STYLEDEFINITION
|
DefaultRowHoverStyle
|
N
|
二者
|
||||
RowSelectedStyle
|
定義當選取列時的列樣式。這會將背景顏色與字型新增至每個儲存格。線條顏色、粗細與類型只會套用至所選列。
|
STYLEDEFINITION
|
DefaultRowSelectedStyle
|
N
|
二者
|
||||
RowBorderStyle
|
定義列邊框樣式。這會將線條顏色、線條粗細與線型新增至儲存格的水平側。
|
STYLEDEFINITION
|
DefaultRowBorderStyle
|
N
|
二者
|
||||
CellBorderStyle
|
定義儲存格邊框樣式。這會將線條顏色、線條粗細與線型新增至儲存格的垂直側。
|
STYLEDEFINITION
|
DefaultCellBorderStyle
|
N
|
二者
|
||||
ToolbarStyle
|
定義工具列的樣式。
|
STYLEDEFINITION
|
DefaultToolbarStyle
|
N
|
二者
|
||||
TableFooterStyle
|
定義網格中頁尾部份的樣式。這包括背景顏色、邊框樣式及字型樣式。
|
STYLE DEFINITION
|
DefaultGridAdvancedFooterStyle
|
N
|
二者
|
||||
TooltipStyle
|
定義工具提示的樣式。
|
STYLEDEFINITION
|
DefaultTooltipStyle
|
N
|
二者
|
||||
SortAscendingStyle
|
定義遞增排序圖示的樣式。
|
STYLEDEFINITION
|
DefaultSortAscendingStyle
|
N
|
二者
|
||||
SortDescendingStyle
|
定義遞減排序圖示的樣式。
|
STYLEDEFINITION
|
DefaultSortDescendingStyle
|
N
|
二者
|
||||
CellValidationErrorStyle
|
定義發生驗證錯誤時儲存格的樣式。
|
STYLE DEFINITION
|
DefaultCellValidationErrorStyle
|
N
|
二者
|
||||
CellValidationErrorTooltipStyle
|
定義發生驗證錯誤時儲存格工具提示的樣式。
|
STYLE DEFINITION
|
DefaultCellValidationErrorTooltipStyle
|
N
|
二者
|
||||
RowIconStyle
|
定義樹節點之資料夾圖示的樣式。
|
STYLEDEFINITION
|
DefaultRowIconStyle
|
N
|
僅限樹網格
|
||||
RowExpansionIconStyle
|
定義樹節點之展開圖示的樣式。
|
STYLEDEFINITION
|
DefaultRowExpansionIconStyle
|
N
|
僅限樹網格
|
||||
RowCollapseIconStyle
|
定義樹節點之摺疊圖示的樣式。
|
STYLEDEFINITION
|
DefaultRowCollapseIconStyle
|
N
|
僅限樹網格
|
||||
HeaderOverflow
|
提供用來處理溢出之標題儲存格文字的選項。選項:
• fitted - 文字會配合欄寬度,然後換行,甚至會使字詞斷開。
• wrapped - 文字會在空格或破折號的地方換到另一行。
• clipped - 會裁切掉標題儲存格結尾的文字。
• ellipsis - 會裁切掉文字,但會用省略號 (...) 表示還有更多文字。
• tooltip - 會裁切掉文字但會顯示省略號 (...),並會在工具提示中顯示完整文字
|
STRING
|
tooltip
|
N
|
二者
|
||||
DataOverflow
|
為溢出的資料儲存格文字提供選項。HeaderOverflow 內容也提供相同的選項。
|
STRING
|
clipped
|
N
|
二者
|
||||
MaxHeaderHeight
|
在垂直捲軸顯示前標題列可以展開至的最大高度 (以像素為單位)。
|
NUMBER
|
100
|
N
|
二者
|
||||
MinRowHeight
|
網格中列的最小高度設定 (以像素為單位)。
假設您未針對所顯示圖像大於預設列高度下限 (30 像素) 的欄使用圖像轉譯器。範例為套用包含圖像之樣式的狀態定義。在此情況下,請務必放大列高度設定以容納圖像高度。
|
NUMBER
|
0
|
N
|
二者
|
||||
MaxRowCacheSize
|
您可在用戶端網格中展開的最大列數。達到限制時,會產生一則警告,而且必須先摺疊節點,才能進一步展開。
|
NUMBER
|
5000
|
N
|
僅限樹網格
|
||||
DoubleClicked*
|
連按兩下網格時會觸發的可繫結事件內容。
|
EVENT
|
n/a
|
Y
|
二者
|
||||
Filter*
|
這是一個可繫結的查詢內容,用來將查詢服務繫結為輸入查詢參數,以控制資料的排序、搜尋與篩選。開啟 EnableSorting 或 EnableGridSearch 內容後,此內容會變為可用。您可以從內容面板或網格本身的前後關聯選單中設定此內容。
|
EVENT
|
n/a
|
Y
|
二者
|
||||
EditCellStarted
|
您開始編輯儲存格值時可以觸發的可繫結事件內容。只有在設定 IsEditable 參數後,此內容才處於使用中狀態。
您可使用此事件來在編輯時變更混搭中其他小器具的狀態。
|
EVENT
|
n/a
|
Y
|
二者
|
||||
EditCellCompleted
|
您編輯儲存格然後再按下 ENTER 鍵、TAB 鍵或已編輯儲存格之外的任何位置時可以觸發的可繫結事件內容。按下 ESC 鍵可使值保持未編輯狀態。重新整理網格時,已編輯的值會顯示。
此事件的兩個用法如下:
• 您可將其繫結至資料負載更新服務,以使 EditedTable 資料負載的已編輯值保持不變。
• 您可將其繫結至會在混搭中啟用「儲存」按鈕小工具的服務。「儲存」按鈕可以再繫結至資料負載更新服務,以使 EditedTable 資料負載的已更新值保持不變。
|
EVENT
|
n/a
|
Y
|
二者
|
||||
EditStarted
|
當您在網格工具列中按一下「編輯」時,會觸發此事件。
|
EVENT
|
n/a
|
Y
|
二者
|
||||
EditCompleted
|
當您在網格工具列中按一下「儲存」時,會觸發此事件。
|
EVENT
|
n/a
|
Y
|
二者
|
||||
EditCancelled
|
當您在網格工具列中按一下「取消」時,會觸發此事件。
|
EVENT
|
n/a
|
Y
|
二者
|
||||
Z-index*
|
分層小器具的排序。Z 索引較低的網格小器具會移至 Z 索引較高的另一個小器具後方。
|
NUMBER
|
10
|
N
|
二者
|
||||
Visible*
|
若設定,網格會在執行時間顯示。此內容可由繫結至網格的服務定義。如果可見服務繫結至網格,會顯示實心箭頭: 如果沒有可見服務,則會顯示 。 |
BOOLEAN
|
True
|
Y
|
二者
|
||||
SelectedRowsChanged*
|
當您在網格中選取或取消選取一或多列時,可用來觸發另一個小器具或服務的可繫結事件內容。
欲使用此事件內容,請遵循下列步驟:
• 將 RowSelection 內容設定為 single 或 multi。
• 將 SelectedRows 內容繫結至另一個實體 (小器具或服務)。
• 將 SeletedRowsChanged 事件繫結至其他實體,以便在 SelectedRows 變更時會將其觸發。
|
EVENT
|
n/a
|
Y
|
二者
|
|
網格樣式的優先順序如下所列,TableWrapperStyle 的優先順序最低,RowHoverStyle 的優先順序最高。
1. TableWrapperStyle
2. RowBackground/RowAlternateBackgroundStyle
3. CellBorder/RowBorderStyle
4. FixedRowFormatter/State Definition
5. RowSelectedStyle
6. RowHoverStyle
|