Qt Widgets プログラミング：QPlainTextEdit::redoAvailable() 関数徹底解説

Qt Widgetsにおける QPlainTextEdit::redoAvailable() の解説

概要

• 機能: やり直し操作が可能かどうかを判断
• 戻り値:
  • True: やり直し操作が可能
  • False: やり直し操作が不可能
• 関連するクラス:
  • QPlainTextEdit: プレーンなテキスト編集のためのウィジェット
  • QTextDocument: テキストを処理するためのクラス

動作

QPlainTextEdit::redoAvailable() は、テキスト編集履歴に基づいて動作します。テキスト編集中に undo() 関数を使用して操作を元に戻すと、その操作は履歴に記録されます。その後、redoAvailable() 関数を呼び出すと、履歴に記録された操作が存在するかどうかを確認できます。

使用例

QPlainTextEdit* plainTextEdit = new QPlainTextEdit();

// テキスト編集
plainTextEdit->insertPlainText("Hello, world!");

// 元に戻す
plainTextEdit->undo();

// やり直し操作が可能かどうかを確認
bool redoAvailable = plainTextEdit->redoAvailable();

if (redoAvailable) {
  // やり直し
  plainTextEdit->redo();
} else {
  // やり直し操作が不可能
  // ...
}

補足

• redoAvailable() 関数は、undo() 関数を使用して操作を元に戻した後のみ、True を返します。
• テキスト編集中にカット、コピー、貼り付けなどの操作を行うと、履歴がクリアされ、redoAvailable() 関数は False を返すようになります。
• QPlainTextEdit クラスには、undoAvailable() 関数も用意されています。この関数は、元に戻す操作が可能かどうかを判断するために使用されます。

その他

• 上記の情報は、Qt 5.15 を基にしています。バージョンによって挙動が異なる場合があります。
• 不明な点があれば、お気軽に質問してください。

QPlainTextEdit::redoAvailable() を使用したサンプルコード

QPlainTextEdit* plainTextEdit = new QPlainTextEdit();

// テキスト編集
plainTextEdit->insertPlainText("Hello, world!");

// 元に戻す
plainTextEdit->undo();

// やり直し操作が可能かどうかを確認
bool redoAvailable = plainTextEdit->redoAvailable();

if (redoAvailable) {
  // やり直し
  plainTextEdit->redo();
} else {
  // やり直し操作が不可能
  // ...
}

やり直し操作を無効にする例

QPlainTextEdit* plainTextEdit = new QPlainTextEdit();

// テキスト編集
plainTextEdit->insertPlainText("Hello, world!");

// 元に戻す
plainTextEdit->undo();

// やり直し操作を無効にする
plainTextEdit->setUndoRedoEnabled(false);

// やり直し操作は不可能になる
bool redoAvailable = plainTextEdit->redoAvailable();

// ...

やり直し操作を有効にする例

QPlainTextEdit* plainTextEdit = new QPlainTextEdit();

// テキスト編集
plainTextEdit->insertPlainText("Hello, world!");

// 元に戻す
plainTextEdit->undo();

// やり直し操作を無効にする
plainTextEdit->setUndoRedoEnabled(false);

// やり直し操作を有効にする
plainTextEdit->setUndoRedoEnabled(true);

// やり直し操作が可能になる
bool redoAvailable = plainTextEdit->redoAvailable();

// ...

複数の操作を元に戻す/やり直す例

QPlainTextEdit* plainTextEdit = new QPlainTextEdit();

// テキスト編集
plainTextEdit->insertPlainText("Hello, ");
plainTextEdit->insertPlainText("world!");

// 2つの操作を元に戻す
plainTextEdit->undo();
plainTextEdit->undo();

// やり直し操作が可能かどうかを確認
bool redoAvailable = plainTextEdit->redoAvailable();

if (redoAvailable) {
  // 2つの操作をやり直す
  plainTextEdit->redo();
  plainTextEdit->redo();
} else {
  // やり直し操作が不可能
  // ...
}

テキスト変更イベントを処理する例

class MyPlainTextEdit : public QPlainTextEdit {
 public:
  MyPlainTextEdit() {
    // テキスト変更イベントに接続
    connect(this, &QPlainTextEdit::textChanged, this, &MyPlainTextEdit::onTextChanged);
  }

 private:
  void onTextChanged() {
    // テキスト変更時に、やり直し操作が可能かどうかを確認
    bool redoAvailable = redoAvailable();

    // ...
  }
};

これらのサンプルコードは、QPlainTextEdit::redoAvailable() 関数の使い方を理解するのに役立ちます。

QPlainTextEdit::redoAvailable() 以外の方法

QTextDocument::isRedoAvailable() 関数を使用する

QPlainTextEdit クラスは QTextDocument クラスを内部で使用しています。QTextDocument クラスには、isRedoAvailable() 関数という、やり直し操作が可能かどうかを判断するための関数があります。

QPlainTextEdit* plainTextEdit = new QPlainTextEdit();

// テキスト編集
plainTextEdit->insertPlainText("Hello, world!");

// 元に戻す
plainTextEdit->undo();

// QTextDocument オブジェクトを取得
QTextDocument* document = plainTextEdit->document();

// やり直し操作が可能かどうかを確認
bool redoAvailable = document->isRedoAvailable();

if (redoAvailable) {
  // ...
} else {
  // ...
}

自作のフラグを使用する

アプリケーションの要件に応じて、独自のフラグを使用してやり直し操作が可能かどうかを管理することもできます。

class MyPlainTextEdit : public QPlainTextEdit {
 public:
  MyPlainTextEdit() {
    // やり直し操作が可能かどうかを示すフラグ
    m_redoAvailable = false;
  }

  void undo() {
    QPlainTextEdit::undo();

    // 元に戻す操作を行った後に、やり直し操作が可能になるようにフラグを設定
    m_redoAvailable = true;
  }

  bool redoAvailable() const {
    return m_redoAvailable;
  }

 private:
  bool m_redoAvailable;
};

その他の方法

上記以外にも、以下の方法でやり直し操作が可能かどうかを判断できます。

• QHistory クラスを使用する
• 自作の履歴管理クラスを使用する

これらの方法は、QPlainTextEdit::redoAvailable() 関数よりも柔軟性がありますが、複雑になる可能性があります。