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는 명령 압축에 사용됩니다. 이 명령의 클래스에 고유한 정수여야 하며, 명령이 압축을 지원하지 않는 경우 -1이어야 합니다.

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

QUndoStack::push()는 두 명령의 ID가 같고 ID가 -1이 아닌 경우에만 병합을 시도합니다.

mergeWith() 및 QUndoStack::push()도 참조하세요 .

bool QUndoCommand::isObsolete() const

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

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

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

이 명령이 수행하는 작업을 설명하는 짧은 텍스트 문자열을 반환합니다(예: "텍스트 삽입").

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

actionText(), setText(), QUndoStack::createUndoAction() 및 QUndoStack::createRedoAction()도 참조하세요 .

[virtual] void QUndoCommand::undo()

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

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

redo()도 참조하세요 .