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

概要

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

テキストの入力

 QString str = "";
 
 // ...略
 
 if(!str.isEmpty())
 {
    lineEdit->setText(str);
 }

テキストの取得

 QString str = lineEdit->text();

パスワード入力モードにする

Qt Designerのプロパティ[echoMode]を[Password]に設定する。
または、ソースコードで以下を記述する。

 lineEdit->setEchoMode(QLineEdit::Password)

入力文字の確認

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]キーで貼り付ける。

上記の方法を無効化する方法を以下に示す。

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

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

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

  setContextMenuPolicy(Qt::NoContextMenu);

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

  
  

• ドラッグ&ドロップの無効化

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

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

  setAcceptDrops(false);

  
  

• [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);
 };