Qt Widgets：QLineEdit::editingFinished()シグナルでテキスト処理をパワーアップ

Qt WidgetsにおけるQLineEdit::editingFinished()シグナルの解説

QLineEdit::editingFinished()シグナルは、Qt WidgetsモジュールのQLineEditクラスで提供されるシグナルです。このシグナルは、ユーザーがLineEditウィジェットの編集を完了したときに発生します。

詳細

LineEditウィジェットの編集は、以下のいずれかの方法で完了できます。

• ユーザーがウィジェットからフォーカスを外す
• ユーザーがReturnキーまたはEnterキーを押す
• ユーザーがウィジェット内で編集を中止する

シグナルの処理

QLineEdit::editingFinished()シグナルを処理するには、QObject::connect()関数を使用して、シグナルをスロットに接続する必要があります。スロットは、シグナルが送信されたときに呼び出される関数です。

以下の例は、QLineEdit::editingFinished()シグナルを処理するコード例です。

//LineEditウィジェットの作成
QLineEdit *lineEdit = new QLineEdit;

//シグナルとスロットの接続
QObject::connect(lineEdit, &QLineEdit::editingFinished,
                 this, &MyClass::onLineEditEditingFinished);

//スロットの定義
void MyClass::onLineEditEditingFinished()
{
  //LineEditウィジェットのテキストを取得
  QString text = lineEdit->text();

  //テキスト処理を行う
  // ...
}

シグナルの利点

QLineEdit::editingFinished()シグナルを使用する利点は、以下のとおりです。

• ユーザーがLineEditウィジェットの編集を完了したタイミングを確実に捕捉できる
• 編集内容を取得して処理を行うことができる

補足

• QLineEdit::editingFinished()シグナルは、QLineEdit::textChanged()シグナルとは異なります。QLineEdit::textChanged()シグナルは、LineEditウィジェットのテキストが変更されるたびに発生します。
• QLineEdit::editingFinished()シグナルは、Qt Widgetsモジュールの他のウィジェットでも使用できます。

Qt Widgetsモジュールに関する情報は、Qt公式ドキュメント([無効な URL を削除しました]。

QLineEdit::editingFinished()シグナルのサンプルコード

以下のコードは、LineEditウィジェットの編集が完了したときに、入力されたテキストを取得して処理する例です。

#include <QtWidgets>

class MyClass : public QObject {
  Q_OBJECT
public:
  MyClass() {
    //LineEditウィジェットの作成
    lineEdit = new QLineEdit;

    //シグナルとスロットの接続
    QObject::connect(lineEdit, &QLineEdit::editingFinished,
                     this, &MyClass::onLineEditEditingFinished);
  }

private slots:
  void onLineEditEditingFinished() {
    //LineEditウィジェットのテキストを取得
    QString text = lineEdit->text();

    //テキスト処理を行う
    if (text.isEmpty()) {
      // テキストが空の場合
      // ...
    } else {
      // テキストが入力されている場合
      // ...
    }
  }

private:
  QLineEdit *lineEdit;
};

int main(int argc, char *argv[]) {
  QApplication app(argc, argv);

  MyClass myClass;

  myClass.lineEdit->show();

  return app.exec();
}

入力値の検証

以下のコードは、LineEditウィジェットに入力された値が正数かどうかを検証する例です。

#include <QtWidgets>

class MyClass : public QObject {
  Q_OBJECT
public:
  MyClass() {
    //LineEditウィジェットの作成
    lineEdit = new QLineEdit;

    //シグナルとスロットの接続
    QObject::connect(lineEdit, &QLineEdit::editingFinished,
                     this, &MyClass::onLineEditEditingFinished);
  }

private slots:
  void onLineEditEditingFinished() {
    //LineEditウィジェットのテキストを取得
    QString text = lineEdit->text();

    //入力値が正数かどうかを検証
    bool isNumber = true;
    for (int i = 0; i < text.length(); ++i) {
      if (!text[i].isDigit()) {
        isNumber = false;
        break;
      }
    }

    if (isNumber) {
      // 入力値が正数の場合
      // ...
    } else {
      // 入力値が正数でない場合
      // ...
    }
  }

private:
  QLineEdit *lineEdit;
};

int main(int argc, char *argv[]) {
  QApplication app(argc, argv);

  MyClass myClass;

  myClass.lineEdit->show();

  return app.exec();
}

入力値に基づいて処理を行う

以下のコードは、LineEditウィジェットに入力された値に基づいて処理を行う例です。

#include <QtWidgets>

class MyClass : public QObject {
  Q_OBJECT
public:
  MyClass() {
    //LineEditウィジェットの作成
    lineEdit = new QLineEdit;

    //シグナルとスロットの接続
    QObject::connect(lineEdit, &QLineEdit::editingFinished,
                     this, &MyClass::onLineEditEditingFinished);
  }

private slots:
  void onLineEditEditingFinished() {
    //LineEditウィジェットのテキストを取得
    QString text = lineEdit->text();

    //入力値に基づいて処理を行う
    if (text == "start") {
      // "start"が入力された場合
      // ...
    } else if (text == "stop") {
      // "stop"が入力された場合
      // ...
    } else {
      // その他の場合
      // ...
    }
  }

private:
  QLineEdit *lineEdit;
};

int main(int argc, char *argv[]) {
  QApplication app(argc, argv);

  MyClass myClass;

  myClass.lineEdit->show();

  return app.exec();
}

**4. 複数

QLineEdit::editingFinished()シグナルの代替方法

QValidator::validate()関数を使用する

QValidatorクラスは、LineEditウィジェットに入力された値の検証を行うためのクラスです。QValidator::validate()関数は、入力された値が有効かどうかを検証し、その結果を返します。

以下の例は、QValidator::validate()関数を使用して、LineEditウィジェットに入力された値が正数かどうかを検証するコードです。

#include <QtWidgets>

class MyValidator : public QValidator {
  Q_OBJECT
public:
  MyValidator(QObject *parent = nullptr) : QValidator(parent) {}

  QValidator::State validate(QString &input, int &pos) const override {
    //入力値が正数かどうかを検証
    bool isNumber = true;
    for (int i = 0; i < input.length(); ++i) {
      if (!input[i].isDigit()) {
        isNumber = false;
        break;
      }
    }

    if (isNumber) {
      return QValidator::Acceptable;
    } else {
      return QValidator::Invalid;
    }
  }
};

int main(int argc, char *argv[]) {
  QApplication app(argc, argv);

  //LineEditウィジェットの作成
  QLineEdit *lineEdit = new QLineEdit;

  //QValidatorの作成
  MyValidator *validator = new MyValidator;

  //LineEditウィジェットにQValidatorを設定
  lineEdit->setValidator(validator);

  // ...

  return app.exec();
}

QKeyEvent::KeyReleaseイベントは、キーが離されたときに発生します。以下の例は、QKeyEvent::KeyReleaseイベントを処理して、LineEditウィジェットの編集完了を検知するコードです。

#include <QtWidgets>

class MyClass : public QObject {
  Q_OBJECT
public:
  MyClass() {
    //LineEditウィジェットの作成
    lineEdit = new QLineEdit;

    //イベントフィルタの設定
    lineEdit->installEventFilter(this);
  }

private:
  bool eventFilter(QObject *obj, QEvent *event) override {
    if (obj == lineEdit && event->type() == QEvent::KeyRelease) {
      QKeyEvent *keyEvent = static_cast<QKeyEvent *>(event);

      // EnterキーまたはReturnキーが離された場合
      if (keyEvent->key() == Qt::Key_Enter || keyEvent->key() == Qt::Key_Return) {
        // 編集完了処理を行う
        // ...
      }
    }

    return QObject::eventFilter(obj, event);
  }

private:
  QLineEdit *lineEdit;
};

int main(int argc, char *argv[]) {
  QApplication app(argc, argv);

  MyClass myClass;

  myClass.lineEdit->show();

  return app.exec();
}

QLineEdit::textChanged()シグナルは、LineEditウィジェットのテキストが変更されたときに発生します。以下の例は、QLineEdit::textChanged()シグナルを使用して、LineEdit