QUndoStack Class

멤버 함수 문서

[explicit] QUndoStack::QUndoStack(QObject *parent = nullptr)

부모 parent 와 함께 빈 실행 취소 스택을 구성합니다. 스택은 처음에 깨끗한 상태가 됩니다. parent 가 QUndoGroup 객체인 경우 스택이 자동으로 그룹에 추가됩니다.

push()도 참조하세요 .

[virtual noexcept] QUndoStack::~QUndoStack()

실행 취소 스택을 파괴하여 그 위에 있는 모든 명령을 삭제합니다. 스택이 QUndoGroup 에 있는 경우 스택은 그룹에서 자동으로 제거됩니다.

QUndoStack()도 참조하세요 .

void QUndoStack::beginMacro(const QString &text)

지정된 text 설명이 포함된 매크로 명령의 구성을 시작합니다.

지정된 text 으로 설명된 빈 명령이 스택에 푸시됩니다. 이후 스택에 푸시된 모든 후속 명령은 endMacro()가 호출될 때까지 빈 명령의 하위 명령에 추가됩니다.

시작 매크로() 및 endMacro() 호출은 중첩될 수 있지만, 시작 매크로() 호출은 모두 endMacro() 호출과 일치하는 호출이 있어야 합니다.

매크로가 작성되는 동안에는 스택이 비활성화됩니다. 이는 곧

• indexChanged() 및 cleanChanged()는 반환되지 않습니다,
• canUndo() 및 canRedo()는 거짓을 반환합니다,
• undo() 또는 redo()을 호출해도 아무런 효과가 없습니다,
• 실행 취소/다시 실행 작업이 비활성화됩니다.

가장 바깥쪽 매크로에 대해 endMacro()를 호출하면 스택이 활성화되고 적절한 신호가 방출됩니다.

stack.beginMacro("insert red text");
stack.push(new InsertText(document, idx, text));
stack.push(new SetColor(document, idx, text.length(), Qt::red));
stack.endMacro(); // indexChanged() is emitted

이 코드는 다음과 같습니다:

QUndoCommand *insertRed = new QUndoCommand(); // an empty command
insertRed->setText("insert red text");

new InsertText(document, idx, text, insertRed); // becomes child of insertRed
new SetColor(document, idx, text.length(), Qt::red, insertRed);

stack.push(insertRed);

endMacro()도 참조하세요 .

bool QUndoStack::canRedo() const

다시 실행할 수 있는 명령이 있으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

이 함수는 스택이 비어 있거나 스택의 최상위 명령이 이미 다시 실행된 경우 false 을 반환합니다.

index() == count()와 동의어입니다.

index() 및 canUndo()도 참조하세요 .

[signal] void QUndoStack::canRedoChanged(bool canRedo)

이 신호는 canRedo() 값이 변경될 때마다 발생합니다. createRedoAction ()에서 반환된 다시 실행 작업을 활성화 또는 비활성화하는 데 사용됩니다. canRedo 은 새 값을 지정합니다.

bool QUndoStack::canUndo() const

실행 취소할 수 있는 명령이 있으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

이 함수는 스택이 비어 있거나 스택의 맨 아래 명령이 이미 실행 취소된 경우 false 을 반환합니다.

index() == 0과 동의어입니다.

index() 및 canRedo()도 참조하세요 .

[signal] void QUndoStack::canUndoChanged(bool canUndo)

이 신호는 canUndo() 값이 변경될 때마다 발생합니다. createUndoAction ()에서 반환된 실행 취소 작업을 활성화 또는 비활성화하는 데 사용됩니다. canUndo 은 새 값을 지정합니다.

[signal] void QUndoStack::cleanChanged(bool clean)

이 신호는 스택이 클린 상태에 들어가거나 클린 상태를 벗어날 때마다 발생합니다. clean 이 참이면 스택이 깨끗한 상태이고, 그렇지 않으면 스택이 깨끗한 상태를 벗어났음을 나타냅니다.

isClean() 및 setClean()도 참조하세요 .

int QUndoStack::cleanIndex() const

클린 인덱스를 반환합니다. setClean ()가 호출된 인덱스입니다.

스택에 깨끗한 인덱스가 없을 수도 있습니다. 문서가 저장되고 일부 명령이 실행 취소된 다음 새 명령이 푸시되는 경우 이런 일이 발생합니다. push ()는 새 명령을 푸시하기 전에 실행 취소된 명령을 모두 삭제하므로 스택이 다시 깨끗한 상태로 돌아갈 수 없습니다. 이 경우 이 함수는 -1을 반환합니다. resetClean ()를 명시적으로 호출한 후 -1을 반환할 수도 있습니다.

isClean() 및 setClean()도 참조하세요 .

void QUndoStack::clear()

명령 스택의 모든 명령을 삭제하여 명령 스택을 지우고 스택을 깨끗한 상태로 되돌립니다.

명령은 실행 취소되거나 다시 실행되지 않으며 편집된 개체의 상태는 변경되지 않습니다.

이 함수는 일반적으로 문서의 내용을 버릴 때 사용됩니다.

QUndoStack()도 참조하세요 .

const QUndoCommand *QUndoStack::command(int index) const

index 에 있는 명령에 대한 const 포인터를 반환합니다.

이 함수는 스택에 푸시되어 실행된 명령을 수정하면 나중에 명령을 취소하거나 다시 실행하면 문서 상태가 손상되는 경우가 거의 항상 발생하기 때문에 const 포인터를 반환합니다.

QUndoCommand::child()도 참조하세요 .

int QUndoStack::count() const

스택에 있는 명령의 수를 반환합니다. 매크로 명령은 하나의 명령으로 계산됩니다.

index(), setIndex() 및 command()도 참조하세요 .

QAction *QUndoStack::createRedoAction(QObject *parent, const QString &prefix = QString()) const

주어진 parent 을 사용하여 QAction 객체를 다시 실행합니다.

이 작업을 트리거하면 redo() 호출이 발생합니다. 이 작업의 텍스트는 다음 redo() 호출에서 다시 실행될 명령의 텍스트이며, 접두사 앞에 지정된 prefix 이 붙습니다. 다시 실행할 수 있는 명령이 없는 경우 이 작업은 비활성화됩니다.

prefix 이 비어 있으면 접두사 대신 기본 템플릿 "Redo %1"이 사용됩니다. Qt 4.8 이전에는 접두사 "Redo"가 기본적으로 사용되었습니다.

createUndoAction(), canRedo() 및 QUndoCommand::text()도 참조하세요 .

QAction *QUndoStack::createUndoAction(QObject *parent, const QString &prefix = QString()) const

주어진 parent 을 사용하여 실행 취소 QAction 객체를 만듭니다.

이 작업을 트리거하면 undo() 호출이 발생합니다. 이 작업의 텍스트는 다음 번 undo() 호출에서 실행 취소될 명령의 텍스트이며, 앞에 지정된 prefix 이 붙습니다. 실행 취소할 수 있는 명령이 없는 경우 이 작업은 비활성화됩니다.

prefix 이 비어 있으면 접두사 대신 기본 템플릿 "Undo %1"이 사용됩니다. Qt 4.8 이전에는 접두사 "Undo"가 기본으로 사용되었습니다.

createRedoAction(), canUndo() 및 QUndoCommand::text()도 참조하세요 .

void QUndoStack::endMacro()

매크로 명령의 구성을 종료합니다.

중첩된 매크로 집합에서 가장 바깥쪽에 있는 매크로인 경우 이 함수는 전체 매크로 명령에 대해 indexChanged()를 한 번 내보냅니다.

beginMacro()도 참조하세요 .

int QUndoStack::index() const

현재 명령의 인덱스를 반환합니다. 다음 redo() 호출 시 실행될 명령입니다. 여러 명령이 실행 취소되었을 수 있으므로 스택에서 항상 가장 위에 있는 명령은 아닙니다.

setIndex(), undo(), redo() 및 count()도 참조하세요 .

[signal] void QUndoStack::indexChanged(int idx)

이 신호는 명령이 문서 상태를 수정할 때마다 발생합니다. 명령이 실행 취소되거나 다시 실행될 때 발생합니다. 매크로 명령이 실행 취소되거나 다시 실행되거나 setIndex()가 호출되면 이 신호는 한 번만 발생합니다.

idx 현재 명령의 인덱스, 즉 다음 redo()를 호출할 때 실행될 명령을 지정합니다.

index() 및 setIndex()도 참조하세요 .

bool QUndoStack::isClean() const

스택이 깨끗한 상태이면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

setClean() 및 cleanIndex()도 참조하세요 .

void QUndoStack::push(QUndoCommand *cmd)

cmd 을 스택에 푸시하거나 가장 최근에 실행한 명령과 병합합니다. 두 경우 모두 redo() 함수를 호출하여 cmd 을 실행합니다.

cmd 의 ID가 -1이 아니고 가장 최근에 실행된 명령의 ID와 동일한 경우 QUndoStack 은 가장 최근에 실행된 명령에서 QUndoCommand::mergeWith()를 호출하여 두 명령의 병합을 시도합니다. QUndoCommand::mergeWith ()가 true 을 반환하면 cmd 이 삭제됩니다.

QUndoCommand::redo() 및 해당되는 경우 QUndoCommand::mergeWith(), QUndoCommand::isObsolete()를 호출한 후 cmd 또는 병합된 명령에 대해 ()가 호출됩니다. QUndoCommand::isObsolete ()가 true 을 반환하면 cmd 또는 병합된 명령이 스택에서 삭제됩니다.

다른 모든 경우에는 cmd 가 스택에 푸시됩니다.

cmd 가 푸시되기 전에 명령이 실행 취소된 경우 현재 명령과 그 위에 있는 모든 명령이 삭제됩니다. 따라서 cmd 은 항상 스택의 맨 위에 위치하게 됩니다.

명령이 푸시되면 스택이 해당 명령의 소유권을 갖게 됩니다. 명령이 실행된 후 수정하면 거의 항상 문서 상태가 손상되므로 명령을 반환하는 게터가 없습니다.

QUndoCommand::id() 및 QUndoCommand::mergeWith()도 참조하세요 .

[slot] void QUndoStack::redo()

QUndoCommand::redo()를 호출하여 현재 명령을 다시 실행합니다. 현재 명령 인덱스를 증가시킵니다.

스택이 비어 있거나 스택의 최상위 명령이 이미 다시 실행된 경우 이 함수는 아무 작업도 수행하지 않습니다.

QUndoCommand::isObsolete()가 현재 명령에 대해 참을 반환하면 해당 명령이 스택에서 삭제됩니다. 또한 정리 인덱스가 현재 명령 인덱스보다 크거나 같으면 정리 인덱스가 재설정됩니다.

undo() 및 index()도 참조하세요 .

QString QUndoStack::redoText() const

다음 redo() 호출에서 다시 실행될 명령의 텍스트를 반환합니다.

QUndoCommand::actionText() 및 undoText()도 참조하세요 .

[signal] void QUndoStack::redoTextChanged(const QString &redoText)

이 신호는 redoText() 값이 변경될 때마다 발생합니다. createRedoAction ()에서 반환된 다시 실행 작업의 텍스트 속성을 업데이트하는 데 사용됩니다. redoText 은 새 텍스트를 지정합니다.

[slot] void QUndoStack::resetClean()

스택이 깨끗한 경우 클린 상태를 벗어나 cleanChanged()를 반환합니다. 이 메서드는 정리 인덱스를 -1로 재설정합니다.

이 메서드는 일반적으로 다음과 같은 경우에 호출됩니다:

• 어떤 템플릿을 기반으로 작성되었으나 저장되지 않아 아직 문서와 연결된 파일 이름이 없는 경우.
• 백업 파일에서 복원된 경우.
• 편집기 외부에서 변경되었는데 사용자가 다시 로드하지 않은 경우.

isClean(), setClean() 및 cleanIndex()도 참조하세요 .

[slot] void QUndoStack::setClean()

스택이 아직 정리되지 않은 경우 스택을 정리된 것으로 표시하고 cleanChanged()를 출력합니다.

예를 들어 이 함수는 일반적으로 문서가 저장될 때 호출됩니다.

실행 취소/다시 실행 명령을 사용하여 스택이 이 상태로 돌아갈 때마다 cleanChanged() 신호를 보냅니다. 이 신호는 스택이 정리 상태를 벗어날 때도 발생합니다.

isClean(), resetClean(), cleanIndex()도 참조하세요 .

[slot] void QUndoStack::setIndex(int idx)

현재 명령 인덱스가 idx 에 도달할 때까지 undo() 또는 redo()을 반복적으로 호출합니다. 이 함수는 문서의 상태를 앞뒤로 롤백하는 데 사용할 수 있습니다. indexChanged()는 한 번만 호출됩니다.

index(), count(), undo() 및 redo()도 참조하세요 .

QString QUndoStack::text(int idx) const

색인에 있는 명령의 텍스트를 반환합니다 idx.

beginMacro()도 참조하세요 .

[slot] void QUndoStack::undo()

QUndoCommand::undo()를 호출하여 현재 명령 아래의 명령을 실행 취소합니다. 현재 명령 인덱스를 감소시킵니다.

스택이 비어 있거나 스택의 맨 아래 명령이 이미 실행 취소된 경우 이 함수는 아무 작업도 수행하지 않습니다.

명령이 실행 취소된 후 QUndoCommand::isObsolete()가 true 을 반환하면 스택에서 명령이 삭제됩니다. 또한 정리 인덱스가 현재 명령 인덱스보다 크거나 같으면 정리 인덱스가 재설정됩니다.

redo() 및 index()도 참조하세요 .

QString QUndoStack::undoText() const

다음 undo() 호출에서 실행 취소될 명령의 텍스트를 반환합니다.

QUndoCommand::actionText() 및 redoText()도 참조하세요 .

[signal] void QUndoStack::undoTextChanged(const QString &undoText)

이 신호는 undoText() 값이 변경될 때마다 발생합니다. createUndoAction ()에서 반환된 실행 취소 작업의 텍스트 속성을 업데이트하는 데 사용됩니다. undoText 은 새 텍스트를 지정합니다.