source: trunk/doc/src/examples/undoframework.qdoc@ 846

Last change on this file since 846 was 846, checked in by Dmitry A. Kuminov, 14 years ago

trunk: Merged in qt 4.7.2 sources from branches/vendor/nokia/qt.

File size: 10.6 KB
Line 
1/****************************************************************************
2**
3** Copyright (C) 2011 Nokia Corporation and/or its subsidiary(-ies).
4** All rights reserved.
5** Contact: Nokia Corporation ([email protected])
6**
7** This file is part of the documentation of the Qt Toolkit.
8**
9** $QT_BEGIN_LICENSE:FDL$
10** Commercial Usage
11** Licensees holding valid Qt Commercial licenses may use this file in
12** accordance with the Qt Commercial License Agreement provided with the
13** Software or, alternatively, in accordance with the terms contained in a
14** written agreement between you and Nokia.
15**
16** GNU Free Documentation License
17** Alternatively, this file may be used under the terms of the GNU Free
18** Documentation License version 1.3 as published by the Free Software
19** Foundation and appearing in the file included in the packaging of this
20** file.
21**
22** If you have questions regarding the use of this file, please contact
23** Nokia at [email protected].
24** $QT_END_LICENSE$
25**
26****************************************************************************/
27
28/*!
29 \example tools/undoframework
30 \title Undo Framework Example
31
32 This example shows how to implement undo/redo functionality
33 with the Qt undo framework.
34
35 \image undoframeworkexample.png The Undo Diagram Example
36
37 In the Qt undo framework, all actions that the user performs are
38 implemented in classes that inherit QUndoCommand. An undo command
39 class knows how to both \l{QUndoCommand::}{redo()} - or just do
40 the first time - and \l{QUndoCommand::}{undo()} an action. For
41 each action the user performs, a command is placed on a
42 QUndoStack. Since the stack contains all commands executed
43 (stacked in chronological order) on the document, it can roll the
44 state of the document backwards and forwards by undoing and redoing