QUndoCommand Class

멤버 함수 문서

[explicit] QUndoCommand::QUndoCommand(QUndoCommand *parent = nullptr)

parent 를 부모로 하는 QUndoCommand 객체를 생성합니다.

parent 가 ` nullptr`가 아닌 경우, 이 명령은 부모의 자식 목록에 추가됩니다. 그러면 부모 명령이 이 명령을 소유하게 되며, 부모의 소멸자에서 이 명령을 삭제합니다.

~QUndoCommand()도 참조하십시오 .

[explicit] QUndoCommand::QUndoCommand(const QString &text, QUndoCommand *parent = nullptr)

지정된 ` parent ` 및 ` text`을 사용하여 `QUndoCommand` 객체를 생성합니다.

parent 가 nullptr 와 다를 경우, 이 명령은 부모의 자식 목록에 추가됩니다. 그러면 부모 명령이 이 명령을 소유하게 되며, 부모 명령의 소멸자에서 이 명령을 삭제합니다.

~QUndoCommand()도 참조하십시오 .

[virtual noexcept] QUndoCommand::~QUndoCommand()

QUndoCommand 객체와 모든 하위 명령을 삭제합니다.

QUndoCommand()도 참조하십시오 .

QString QUndoCommand::actionText() const

이 명령의 기능을 설명하는 짧은 텍스트 문자열을 반환합니다. 예를 들어, "텍스트 삽입"과 같은 문자열입니다.

이 텍스트는 스택의 '실행 취소' 및 '다시 실행' 동작의 텍스트 속성이 업데이트될 때 사용됩니다.

text(), setText(), QUndoStack::createUndoAction(), QUndoStack::createRedoAction()도 참조하십시오 .

const QUndoCommand *QUndoCommand::child(int index) const

index 에 있는 하위 명령을 반환합니다.

childCount() 및 QUndoStack::command()도 참조하십시오 .

int QUndoCommand::childCount() const

이 명령에 포함된 하위 명령의 개수를 반환합니다.

child()도 참조하십시오 .

[virtual] int QUndoCommand::id() const

이 명령어의 ID를 반환합니다.

명령어 ID는 명령어 압축에 사용됩니다. 이 ID는 해당 명령어 클래스에서 고유한 정수여야 하며, 명령어가 압축을 지원하지 않는 경우 -1이어야 합니다.

명령어가 압축을 지원하는 경우, 올바른 ID를 반환하기 위해 파생 클래스에서 이 함수를 재정의해야 합니다. 기본 구현은 -1을 반환합니다.

QUndoStack::push()는 두 명령의 ID가 동일하고, 해당 ID가 -1이 아닐 때만 두 명령을 병합하려고 시도합니다.

mergeWith() 및 QUndoStack::push()도 참조하십시오 .

bool QUndoCommand::isObsolete() const

해당 명령어가 더 이상 사용되지 않는지 여부를 반환합니다.

이 부울 값은 스택에서 더 이상 필요하지 않은 명령을 자동으로 제거하는 데 사용됩니다. isObsolete 함수는 QUndoStack::push(), QUndoStack::undo(), QUndoStack::redo() 및 QUndoStack::setIndex() 함수에서 확인됩니다.

setObsolete(), mergeWith(), QUndoStack::push(), QUndoStack::undo() 및 QUndoStack::redo()도 참조하십시오 .

[virtual] bool QUndoCommand::mergeWith(const QUndoCommand *command)

이 명령어를 command 와 병합하려고 시도합니다. 성공하면 true 를 반환하고, 그렇지 않으면 false 를 반환합니다.

이 함수가 true 를 반환하는 경우, 이 명령의 redo()을 호출하면 이 명령과 command 를 모두 다시 실행하는 것과 동일한 효과가 있어야 합니다. 마찬가지로, 이 명령의 undo()을 호출하면 command 와 이 명령을 취소하는 것과 동일한 효과가 있어야 합니다.

QUndoStack 두 명령의 ID가 동일하고, 해당 ID가 -1이 아닌 경우에만 두 명령을 병합하려고 시도합니다.

기본 구현은 ` false`를 반환합니다.

bool AppendText::mergeWith(const QUndoCommand *other)
{
    if (other->id() != id()) // make sure other is also an AppendText command
        return false;
    m_text += static_cast<const AppendText*>(other)->m_text;
    return true;
}

id() 및 QUndoStack::push()도 참조하십시오 .

[virtual] void QUndoCommand::redo()

문서에 변경 사항을 적용합니다. 이 함수는 파생 클래스에서 구현되어야 합니다. 이 함수 내에서 ` QUndoStack::push()`, ` QUndoStack::undo()` 또는 ` QUndoStack::redo()`를 호출하면 정의되지 않은 동작이 발생합니다.

기본 구현은 모든 하위 명령에 대해 redo()를 호출합니다.

undo()도 참조하십시오 .

void QUndoCommand::setObsolete(bool obsolete)

해당 명령어가 더 이상 사용되지 않는지 여부를 obsolete 에 설정합니다.

isObsolete(), mergeWith(), QUndoStack::push(), QUndoStack::undo() 및 QUndoStack::redo()도 참조하십시오 .

void QUndoCommand::setText(const QString &text)

명령어의 텍스트를 지정된 ‘ text ’로 설정합니다.

지정된 텍스트는 이 명령의 기능을 설명하는, 사용자가 쉽게 이해할 수 있는 짧은 문자열이어야 합니다.

text()와 actionText()에 서로 다른 문자열이 필요한 경우, "\n"로 구분하여 이 함수에 전달하십시오. 개발 과정에서 영어 문자열에 이 기능을 사용하지 않더라도, 번역가가 특정 언어의 요구 사항에 맞게 두 개의 서로 다른 문자열을 사용할 수 있도록 할 수 있습니다. 설명된 기능과 actionText() 함수는 Qt 4.8부터 사용할 수 있습니다.

text(), actionText(), QUndoStack::createUndoAction(), QUndoStack::createRedoAction()도 참조하십시오 .

QString QUndoCommand::text() const

이 명령의 기능을 설명하는 짧은 텍스트 문자열을 반환합니다. 예를 들어, “text 삽입”과 같은 문자열입니다.

이 텍스트는 QUndoView 내 항목의 이름으로 사용됩니다.

actionText(), setText(), QUndoStack::createUndoAction(), QUndoStack::createRedoAction()도 참조하십시오 .

[virtual] void QUndoCommand::undo()

문서의 변경 사항을 되돌립니다. undo()가 호출된 후, 문서의 상태는 redo()가 호출되기 전과 동일해야 합니다. 이 함수는 파생 클래스에서 반드시 구현되어야 합니다. 이 함수 내에서 QUndoStack::push(), QUndoStack::undo() 또는 QUndoStack::redo()를 호출하면 정의되지 않은 동작이 발생합니다.

기본 구현은 모든 하위 명령에 대해 undo()를 역순으로 호출합니다.

redo()도 참조하십시오 .