[dhtmlxGantt(甘特图)开发手册]第四篇——撤销/重做、提示消息、加载任务

简介

第一篇

第二篇

第三篇

第四篇

本文将介绍如何使用dhtmlxGantt的撤销/重做、消息提示功能，以及如何加载任务。

撤销/重做

★启用相应功能

——————————————————————————————————————————————————————

从4.0版本开始，dhtmlxGantt允许对做出的操作进行撤销/重做。需要在页面中引入 ext/undo.js 文件，才能使用该功能。

<script src="codebase/dhtmlxgantt.js"></script>
<script src="codebase/ext/undo.js"></script>  <link rel="stylesheet" href="codebase/dhtmlxgantt.css" type="text/css">

撤销/重做功能在默认情况下都被启用，你也可以单独为他们设置相应的参数。

启用撤销功能，将config的undo参数设置为true即可：

gantt.config.undo = true;

启用重做功能，将config的redo参数设置为true即可：

gantt.config.redo = true;

例子：Undo/Redo changes in Gantt

★调用 撤销/重做 方法

——————————————————————————————————————————————————————

想要撤回在甘特图中做出的修改，调用undo方法即可：

gantt.undo();

想要重做在甘特图中做出的修改，调用redo方法即可：

gantt.redo();

★获取存储的 撤销/重做 命令清单

——————————————————————————————————————————————————————

dhtmlxGantt甘特图中的所有操作，都转换成了命令对象(command object)。 undo.js 扩展文件可以针对它们执行反操作，并且在甘特图中体现。

当你需要对某个命令执行撤销或者重做的操作时候，扩展文件可将会获取最新的命令对象，然后执行相应的方法。

获取储存的undo命令，使用getUndoStack方法即可：

var stack = gantt.getUndoStack();

获取储存的redo命令，使用getRedoStack方法即可：

var stack = gantt.getRedoStack();

两个方法返回值都是命令对象的数组。

★设置参数

——————————————————————————————————————————————————————

有一些参数能够帮你调整undo操作。

使用undo_actions参数，可以声明针对哪一个动作执行撤销操作：

gantt.config.undo_actions = {
update:"update",
remove:"remove", // remove an item from datastore
add:"add"
};

使用undo_actions参数，可以声明针对哪一个动作执行撤销操作：

gantt.config.undo_steps = 10;

默认可撤销操作数为10.

使用undo_types参数，可以声明允许针对哪些实体执行撤销操作：

gantt.config.undo_types = {
link:"link",
task:"task"
};

★事件的API列表

——————————————————————————————————————————————————————

下面列出一些有用的相关事件API：

　　●　onBeforeUndo - 在undo方法被调用前触发

　　●　onAfterUndo - 在undo方法被调用后触发

　　●　onBeforeRedo - 在redo方法被调用前触发

　　●　onAfterRedo - 在redo方法被调用后触发