/************************************************************************
 * This file has been generated automatically from                      *
 *                                                                      *
 * src/core/layout/qgslayoutundostack.h                                 *
 *                                                                      *
 * Do not edit manually ! Edit header and run scripts/sipify.py again   *
 ************************************************************************/






class QgsLayoutUndoStack : QObject
{
%Docstring(signature="appended")
An undo stack for :py:class:`QgsLayouts`.
%End

%TypeHeaderCode
#include "qgslayoutundostack.h"
%End
  public:

    QgsLayoutUndoStack( QgsLayout *layout );
%Docstring
Constructor for QgsLayoutUndoStack, for the specified parent ``layout``.
%End

    void beginMacro( const QString &commandText );
%Docstring
Starts a macro command, with the given descriptive ``commandText``.

Any commands added to the stack (either via direct manipulation of
:py:func:`~QgsLayoutUndoStack.stack` or via
:py:func:`~QgsLayoutUndoStack.beginCommand`/:py:func:`~QgsLayoutUndoStack.endCommand`
calls) between a :py:func:`~QgsLayoutUndoStack.beginMacro` and
:py:func:`~QgsLayoutUndoStack.endMacro` block are collapsed into a
single undo command, which will be applied or rolled back in a single
step.

.. seealso:: :py:func:`endMacro`
%End

    void endMacro();
%Docstring
Ends a macro command. This must be called after
:py:func:`~QgsLayoutUndoStack.beginMacro`, when all child undo commands
which form part of the macro have been completed.

Any commands added to the stack (either via direct manipulation of
:py:func:`~QgsLayoutUndoStack.stack` or via
:py:func:`~QgsLayoutUndoStack.beginCommand`/:py:func:`~QgsLayoutUndoStack.endCommand`
calls) between a :py:func:`~QgsLayoutUndoStack.beginMacro` and
:py:func:`~QgsLayoutUndoStack.endMacro` block are collapsed into a
single undo command, which will be applied or rolled back in a single
step.

.. seealso:: :py:func:`beginMacro`
%End

    void beginCommand( QgsLayoutUndoObjectInterface *object, const QString &commandText, int id = 0 );
%Docstring
Begins a new undo command for the specified ``object``.

This must be followed by a call to
:py:func:`~QgsLayoutUndoStack.endCommand` or
:py:func:`~QgsLayoutUndoStack.cancelCommand` after the desired changes
have been made to ``object``.

The ``id`` argument can be used to specify an id number for the source
event - this is used to determine whether QUndoCommand command
compression can apply to the command.

.. seealso:: :py:func:`endCommand`

.. seealso:: :py:func:`cancelCommand`
%End

    void endCommand();
%Docstring
Saves final state of an object and pushes the active command to the undo
history.

.. seealso:: :py:func:`beginCommand`

.. seealso:: :py:func:`cancelCommand`
%End

    void cancelCommand();
%Docstring
Cancels the active command, discarding it without pushing to the undo
history.

.. seealso:: :py:func:`endCommand`

.. seealso:: :py:func:`cancelCommand`
%End

    QUndoStack *stack();
%Docstring
Returns a pointer to the internal QUndoStack.
%End

    void notifyUndoRedoOccurred( QgsLayoutItem *item );
%Docstring
Notifies the stack that an undo or redo action occurred for a specified
``item``.
%End

    void blockCommands( bool blocked );
%Docstring
Sets whether undo commands for the layout should be temporarily blocked.

If ``blocked`` is ``True``, subsequent undo commands will be blocked
until a follow-up call to blockCommands( ``False`` ) is made.

Note that calls to blockCommands are stacked, so two calls blocking the
commands will take two calls unblocking commands in order to release the
block.

.. seealso:: :py:func:`isBlocked`
%End

    bool isBlocked() const;
%Docstring
Returns ``True`` if undo commands are currently blocked.

.. seealso:: :py:func:`blockCommands`
%End

    void push( QUndoCommand *command /Transfer/ );
%Docstring
Manually pushes a ``command`` to the stack, and takes ownership of the
command.
%End

  signals:

    void undoRedoOccurredForItems( QSet< QString > itemUuids );
%Docstring
Emitted when an undo or redo action has occurred, which affected a set
of layout ``itemUuids``.
%End

  private:
    QgsLayoutUndoStack( const QgsLayoutUndoStack &other );
};

/************************************************************************
 * This file has been generated automatically from                      *
 *                                                                      *
 * src/core/layout/qgslayoutundostack.h                                 *
 *                                                                      *
 * Do not edit manually ! Edit header and run scripts/sipify.py again   *
 ************************************************************************/