Feat: [DelTableView]增加快速处理模型的接口及文档.

Author: mengps

DelegateUI_Qt5/gallery/UpdateLists.json

@@ -1,4 +1,9 @@
 [
+    {
+        "isNew": false,
+        "name": "DelTableView",
+        "desc": "添加 clear() 函数。\n添加 appendRow() 函数。\n添加 getRow() 函数。\n添加 insertRow() 函数。\n添加 moveRow() 函数。\n添加 removeRow() 函数。\n添加 setRow() 函数。\n"
+    },
     {
         "isNew": false,
         "name": "DelOTPInput",

DelegateUI_Qt5/gallery/qml/Examples/DataDisplay/ExpTableView.qml

@@ -179,8 +179,17 @@ filterInput(可选) | string | 该列过滤输入
 - \`scrollToRow(row: int)\` 滚动到 \`row\` 指定的行。\n
 - \`sort(column: int)\` 排序 \`column\` 指定的列(该列的描述对象需要具有 \`sorter\` 和 \`sortDirections\`)。\n
 - \`clearSort()\` 清除所有排序(即还原为初始状态)。\n
-- \`filter()\` 使用提供的(如果有，可以多列) \`onFilter\` 过滤整个模型。\n
+- \`filter()\` 使用提供的(如果有，可以多列) \`onFilter\` 过滤整个模型，**注意** 此函数还会确定应用了排序的列并自动进行重排。\n
 - \`clearFilter()\` 清除所有过滤(即还原为初始状态)。\n
+- \`clear()\` 清空所有模型数据、排序和过滤。\n
+**注意** 以下函数仅作用于当前(排序&过滤后)的数据，不会更改 \`initModel\`，并且，为了最佳的性能，\n
+需要用户自行判断是否应该重新排序&过滤(调用 \`filter()\` 即可)\n。
+- \`appendRow(object: var)\` 在当前模型末尾添加 \`object\` 行, 不会更改 \`initModel\`。\n
+- \`object getRow(rowIndex: int)\` 获取当前模型 \`row\` 处的行数据。\n
+- \`insertRow(rowIndex: int, object: var)\` 在当前模型插入行数据 \`object\` 到 \`rowIndex\` 处, 不会更改 \`initModel\`。\n
+- \`moveRow(fromRowIndex: int, toRowIndex: int, count: int = 1)\`将 \`count\` 个模型数据从 \`from\` 位置移动到 \`to\` 位置, 不会更改 \`initModel\`。\n
+- \`removeRow(rowIndex: int, count: int = 1)\` 删除当前模型 \`rowIndex\` 处的 \`count\` 条行数据, 不会更改 \`initModel\`。\n
+- \`setRow(rowIndex: int, object: var)\` 设置当前模型 \`rowIndex\` 处行数据为 \`object\`, 不会更改 \`initModel\`。\n
                        `)
         }
 

DelegateUI_Qt5/src/imports/DelegateUI/Controls/DelTableView.qml

@@ -435,6 +435,62 @@ DelRectangle {
         __private.model = [...initModel];
     }
 
+    function clear() {
+        __private.model = initModel = [];
+        __cellModel.clear();
+        columns.forEach(
+                    object => {
+                        if (object.sortDirections && object.sortDirections.length !== 0) {
+                            object.activeSorter = false;
+                            object.sortIndex = -1;
+                            object.sortMode = 'false';
+                        }
+                        if (object.hasOwnProperty('onFilter') || object.hasOwnProperty('filterInput')) {
+                            object.filterInput = '';
+                        }
+                    });
+    }
+
+    function appendRow(object) {
+        __private.model.push(object);
+        __cellModel.appendRow( __private.toCellObject(object));
+    }
+
+    function getRow(rowIndex) {
+        if (rowIndex >= 0 && rowIndex < __private.model.length) {
+            return __private.model[rowIndex];
+        }
+        return undefined;
+    }
+
+    function insertRow(rowIndex, object) {
+        __private.model.splice(rowIndex, 0, object);
+        __cellModel.insertRow(rowIndex,  __private.toCellObject(object));
+    }
+
+    function moveRow(fromRowIndex, toRowIndex, count = 1) {
+        if (fromRowIndex >= 0 && fromRowIndex < __private.model.length &&
+                toRowIndex >= 0 && toRowIndex < __private.model.length) {
+            const objects = __private.model.splice(from, count);
+            __private.model.splice(to, 0, ...objects);
+            __cellModel.moveRow(fromRowIndex, toRowIndex, count);
+        }
+    }
+
+    function removeRow(rowIndex, count = 1) {
+        if (rowIndex >= 0 && rowIndex < __private.model.length) {
+            __private.model.splice(rowIndex, count);
+            __cellModel.removeRow(rowIndex, count);
+        }
+    }
+
+    function setRow(rowIndex, object) {
+        if (rowIndex >= 0 && rowIndex < __private.model.length) {
+            __private.model[rowIndex] = object;
+            __cellModel.setRow(rowIndex, __private.toCellObject(object));
+        }
+    }
+
     component HoverIcon: DelIconText {
         signal clicked()
         property alias hovered: __hoverHandler.hovered
@@ -523,6 +579,19 @@ DelRectangle {
             control.checkedKeys = [...checkedKeysMap.keys()];
         }
 
+        function toCellObject(object) {
+            let dataObject = new Object;
+            for (let i = 0; i < control.columns.length; i++) {
+                const dataIndex = control.columns[i].dataIndex ?? '';
+                if (object.hasOwnProperty(dataIndex)) {
+                    dataObject[`__data${i}`] = object[dataIndex];
+                } else {
+                    dataObject[`__data${i}`] = null;
+                }
+            }
+            return dataObject;
+        }
+
         onModelChanged: {
             __cellView.contentY = 0;
             __cellModel.clear();