QUndoCommand Class

メンバ関数ドキュメント

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

親を持つ QUndoCommand オブジェクトを構築するparent 。

parent がnullptr でない場合、このコマンドは親の子リストに追加されます。親コマンドはこのコマンドを所有し、デストラクタで削除します。

~QUndoCommand()も参照してください 。

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

与えられたparent とtext で QUndoCommand オブジェクトを構築します。

parent がnullptr でない場合、このコマンドは parent の子リストに追加されます。親コマンドはこのコマンドを所有し、デストラクタで削除します。

~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() は、2つのコマンドが同じIDを持ち、そのIDが-1でない場合にのみ、2つのコマンドのマージを試みます。

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 は、2つのコマンドが同じidを持ち、そのidが-1でない場合にのみ、2つのコマンドのマージを試みます。

デフォルトの実装は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() に 2 つの異なる文字列を指定する必要がある場合は、"˶n" で区切ってこの関数に渡してください。開発中に英語の文字列にこの機能を使わなくても、特定の言語のニーズに合わせるために、翻訳者に2つの異なる文字列を使わせることができます。説明した機能と関数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()も参照してください 。