Qtのコントロール - ラインエディット

概要

Qtのコントロールであるラインエディットについて記載する。

入力文字の確認

QValidatorクラスを使用する

入力文字を確認するには、QValidatorクラスを継承した派生クラスを作成して、以下の処理を記述する。

1. QValidatorクラスを継承した派生クラスを作成する。
2. QValidator::validateメソッドをオーバーライドして、確認処理を実装する。
3. QLineEdit::setValidatorメソッドを使用して、派生クラスのオブジェクトを代入する。

以下の例では、ラインエディット(QLineEditクラス)とQValidatorクラスを継承した派生クラスを使用して、半角カナを入力不可としている。

 // MainWindow.cpp
 
 #include "MainWindow.h"
 #include "ui_MainWindow.h"
 #include "HalfKanaValidator.h"
 
 MainWindow::MainWindow(QMainWindow *parent) : QMainWindow(parent), ui(new Ui::MainWindow)
 {
    ui->setupUi(this);
    ui->lineEdit->setValidator(new HalfKanaValidator(this));
 }
 
 MainWindow::~MainWindow()
 {
    delete ui;
 }

 // MainWindow.h
 
 #pragma once
 
 #include <QValidator>
 #include <QMainWindow>
 
 namespace Ui {class MainWindow;}
 
 class MainWindow : public QMainWindow
 {
    Q_OBJECT
 
 public:
    explicit MainWindow(QMainWindow *parent = nullptr);
    ~MainWindow();
 
 private:
    Ui::MainWindow *ui;
 };

 // HalfKanaValidator.cpp
 
 #include "HalfKanaValidator.h"
 
 HalfKanaValidator::HalfKanaValidator(QObject *parent) : QValidator(parent)
 {
 }
 
 QValidator::State HalfKanaValidator::validate(QString &text, int &pos) const
 {
    if(!text.isEmpty() && (pos > 0))
    {
       ushort ch = text.at(pos - 1).unicode();
 
       // 半角カナの判定
       if(ch >= 0xFF61 && ch <= 0xFF9F)
       {
          return Invalid;
       }
    }
 
    return Acceptable;
 }

 // HalfKanaValidator.h
 
 #include <QValidator>
 
 class HalfKanaValidator : public QValidator
 {
 public:
    explicit HalfKanaValidator(QObject *parent = nullptr);
    QValidator::State validate(QString &, int &) const override;
 };

ただし、上記のサンプルコードでは、コピー&ペーストに対応できない。
例えば、ｱｱあという文字列をコピー&ペーストする場合、validateメソッドの引数には、以下の値が代入される。

• 第1引数 QString &text

  ｱｱあ

• 第2引数 int &pos

  3

また、validateメソッドの引数からは、コピー&ペーストされた文字列の内容や文字数は不明となる。
例えば、"12"と入力済みの状態から、"1"と"2"の間に"ｱｱあ"をコピーする場合、validateメソッドの引数には、以下の値が代入される。
コピーした場所は判別できるが、何文字コピーされたかは不明となる。

• 第1引数 QString &text

  1ｱｱあ2

• 第2引数 int &pos

  4

そのため、以下のような対策が必要となる。

• ラインエディットに対するコピー&ペーストを不可にする。
• QValidatorクラスを継承した派生クラスにて、以前の文字数を保存しておき、増加した文字数分の内容を全てを確認する。

貼り付けを無効にする

キーボード入力以外の入力方法として、ラインエディットに文字列を入力するには、以下の方法がある。

• コンテキストメニュー(右クリックメニュー)から貼り付ける。
• 文字列を選択してドラッグ&ドロップする。
• [Ctrl] + [V]キーで貼り付ける。

1. コンテキストメニューの無効化

   Qt Designerにて、contextMenuPolicyプロパティをNoContextMenuにする。

   また、ソースコードにて以下を記述する。

   setContextMenuPolicy(Qt::NoContextMenu);

   無効にしない場合、NoContextMenuではなくCustomContextMenuにして、独自のコンテキストメニューを作成してもよい。

   
   

2. ドラッグ&ドロップの無効化

   Qt Designerにて、acceptDropsプロパティのチェックを外す。

   また、ソースコードにて以下を記述する。

   setAcceptDrops(false);

   
   

3. [Ctrl] + [V]キーの無効化

   QLineEdit::keyPressEventメソッドをオーバーライドする。

以下の例では、ラインエディットをQLineEditクラスを継承した派生クラスQLineEditExクラスに昇格している。 また、ラインエディットのcontextMenuPolicyプロパティをacceptDropsに設定している。

押下されたキーの組み合わせが貼り付けに該当する場合、該当イベントを無視するようにしている。

 // QLineEditEx.cpp
 
 #include "QLineEditEx.h"
 
 QLineEditEx::QLineEditEx(QWigedt *parent) : QLineEdit(parent)
 {
 }
 
 void QLineEditEx::keyPressEvent(QKeyEvent *event)
 {
    if(event->matches(QKeySequence::Paste))
    {
       event->ignore();
    }
    else
    {
       return QLineEdit::keyPressEvent(event);
    }
 }

 // QLineEditEx.h
 
 #pragma once
 
 #include <QWigedt>
 #include <QLineEdit>
 #include <QKeyEvent>
 
 class QLineEditEx : public QLineEdit
 {
    Q_OBJECT
 
 public:
    explicit QLineEditEx(QWigedt *parent = nullptr);
 
 protected:
    void keyPressEvent(QKeyEvent *) override;
 };

 // MainWindow.cpp
 
 #include "MainWindow.h"
 #include "ui_MainWindow.h"
 
 MainWindow::MainWindow(QMainWindow *parent) : QMainWindow(parent), ui(new Ui::Widget)
 {
    ui->setupUi(this);
 }
 
 MainWindow::~MainWindow()
 {
    delete ui;
 }

 // MainWindow.h
 
 #pragma once
 
 #include <QMainWindow>
 
 namespace Ui {class MainWindow;}
 
 class MainWindow : public QMainWindow
 {
    Q_OBJECT
 
 public:
    explicit MainWindow(QMainWindow *parent = nullptr);
    ~MainWindow();
 
 private:
    Ui::MainWindow *ui;
 };

フォーカスイベント

QLineEditクラスには、textChangedシグナルやtextEditedシグナルは存在するが、フォーカスに関係したシグナルが存在しない。

例えば、エディットコントロールの初期表示において、"キーワードを入力してください..."等を表示して、フォーカスインで消去する場合、
QLineEditクラスのfocusInEventメソッドおよびfocusOutEventメソッドをオーバーライドすることで実現できる。

以下の例では、QLineEditクラスを継承した派生クラスを作成して、フォーカスイベントを処理している。
Qt Designerで配置したラインエディットのコントロールは、QLineEditクラスを継承した派生クラスに昇格させる。

 // QLineEditEx.cpp
 
 #include "QLineEditEx.h"
 
 QLineEditEx::QLineEditEx(QWigedt *parent) : QLineEdit(parent)
 {
 }
 
 void QLineEditEx::focusInEvent(QFocusEvent *e)
 {
    QLineEdit::focusInEvent(e);
 }
 
 void QLineEditEx::focusOutEvent(QFocusEvent *e)
 {
    QLineEdit::focusOutEvent(e);
 }

 // QLineEditEx.h
 
 #pragma once
 
 #include <QWigedt>
 #include <QLineEdit>
 
 class QLineEditEx : public QLineEdit
 {
    Q_OBJECT
 
 public:
    explicit QLineEditEx(QWigedt *parent = nullptr);
 
 protected:
    void focusInEvent(QFocusEvent *) override;
    void focusOutEvent(QFocusEvent *) override;
 };

 // MainWindow.cpp
 
 #include "MainWindow.h"
 #include "ui_MainWindow.h"
 
 MainWindow::MainWindow(QMainWindow *parent) : QMainWindow(parent), ui(new Ui::Widget)
 {
    ui->setupUi(this);
 }
 
 MainWindow::~MainWindow()
 {
    delete ui;
 }

 // MainWindow.h
 
 #pragma once
 
 #include <QMainWindow>
 
 namespace Ui {class MainWindow;}
 
 class MainWindow : public QMainWindow
 {
    Q_OBJECT
 
 public:
    explicit MainWindow(QMainWindow *parent = nullptr);
    ~MainWindow();
 
 private:
    Ui::MainWindow *ui;
 };

ただし、focusInEventメソッドおよびfocusOutEventメソッドのオーバーライドでは、
各ラインエディットでフォーカスインおよびフォーカスアウトの処理が異なる場合は煩雑となる。

各ラインエディットにて、異なるフォーカスイベントの処理を記述する場合、シグナルを作成する。

以下の例では、各ラインエディットの外部から、フォーカスイベントを取得している。
動作結果は、上記のサンプルコードと同様である。

 // QLineEditEx.cpp
 
 #include "QLineEditEx.h"
 
 QLineEditEx::QLineEditEx(QWigedt *parent) : QLineEdit(parent)
 {
 }
 
 void QLineEditEx::focusInEvent(QFocusEvent *e)
 {
    QLineEdit::focusInEvent(e);
    emit focused(true);
 }
 
 void QLineEditEx::focusOutEvent(QFocusEvent *e)
 {
    QLineEdit::focusOutEvent(e);
    emit focused(false);
 }

 // QLineEditEx.h
 
 #pragma once
 
 #include <QWigedt>
 #include <QLineEdit>
 
 class QLineEditEx : public QLineEdit
 {
    Q_OBJECT
 
 public:
    explicit QLineEditEx(QWigedt *parent = nullptr);
 
 protected:
    void focusInEvent(QFocusEvent *) override;
    void focusOutEvent(QFocusEvent *) override;
 
 signals:
    void focused(bool);
 };

 // MainWindow.cpp
 
 #include "MainWindow.h"
 #include "ui_MainWindow.h"
 
 MainWindow::MainWindow(QMainWindow *parent) : QMainWindow(parent), ui(new Ui::Widget)
 {
    ui->setupUi(this);
    connect(ui->lineEdit, &QLineEditEx::focused, this, &MainWindow::focusEvent);
 }
 
 MainWindow::~MainWindow()
 {
    delete ui;
 }
 
 void MainWindow::focusEvent(bool focused)
 {
 }

 // MainWindow.h
 
 #pragma once
 
 #include <QMainWindow>
 #include "QLineEditEx.h"
 
 namespace Ui {class MainWindow;}
 
 class MainWindow : public QMainWindow
 {
    Q_OBJECT
 
 public:
    explicit MainWindow(QMainWindow *parent = nullptr);
    ~MainWindow();
 
 private:
    Ui::MainWindow *ui;
 
 private slots:
    void focusEvent(bool);
 };