一、QLineEditの基本機能

QLineEditは単一行テキスト編集ウィジェットで、QTextEditとは異なり一行のテキストのみを表示できます。一般的にユーザー名入力、パスワード入力、検索ボックスなどとして使用されます。また、一連のシグナルとスロットを提供しており、これらは便利な機能です。詳細な情報が必要な場合はQtの公式ドキュメントを参照してください。しかし、ここでは特にいくつかの重要なメソッドに焦点を当てます。これらは見過ごされがちですが、非常に有用で頻繁に使用される機能です。

• addAction(QAction *action, ActionPosition position)：編集ボックスの先頭または末尾にアクションを追加できます。これにより、洗練された検索ボックスを簡単に実装できます。
• setEchoMode(EchoMode)：テキスト表示モードを設定します。このメソッドを使用してパスワードボックスに変換できます。パラメータはそれぞれ、通常表示、非表示、パスワード表示、入力時一時表示→パスワード状態という意味です。
• setCompleter(QCompleter *c)：自動補完機能を設定します。これは検索エンジンの入力補完のような機能で、詳細についてはQCompleterのドキュメントを参照してください。
• setSelection(int start, int length)：テキスト選択を設定します。
• setValidator(const QValidator *v)：入力検証機能を提供します。

図1 addActionの使用例

図1はaddActionの使用例です。右側のボタンアイコンはstyle()->standardPixmap(QStyle::SP_TitleBarMinButton)を使用して追加しました。

二、右クリックメニューのカスタマイズ

ここで説明する3つの右クリックメニューのカスタマイズ方法は、QWidgetから継承される他のクラスにも同様に適用できます。

まず図2に示すように、Qtドキュメントにある列挙型です。これは右クリックメニュー作成において非常に重要な役割を果たします。多くの開発者はこれを見たことがあり、その意味も理解しているでしょう。

図2 ContextMenuPolicy列挙型

Qtの命名規則は比較的直感的で、これらの列挙値の名前からその役割を推測できます。以下に各値の意味を説明します。

1. 右クリックメニューなし
2. 右クリックメニューのポップアップを許可するが、親ウィンドウへのイベント伝達を阻止する
3. デフォルト値。ウィンドウクラスのcontextMenuEvent関数で右クリックメニューを処理する
4. ウィンドウのアクションを使用してメニューを表示する。これはテーブルやツリービューで便利です
5. customContextMenuRequested対応のスロット関数で右クリックイベントを実装する。このスロットは自分で実装する必要があります

方法1：

customContextMenuRequestedシグナルのスロットを実装し、setContextMenuPolicyでQt::CustomContextMenuを設定します。connectでシグナルとスロットを接続します。具体的なコード例は省略します。

方法2：

contextMenuPolicyをQt::DefaultContextMenu（デフォルト値）に設定し、QWidgetクラスのcontextMenuEvent関数をオーバーライドします。以下にコード例を示します：

1   void MyTextEdit::contextMenuEvent(QContextMenuEvent *event)
2   {
3       QMenu *menu = createStandardContextMenu(); // デフォルトの右クリックメニュー
4       menu->addAction(tr("カスタムメニュー項目"));
5       //...
6       menu->exec(event->globalPos());
7       delete menu;
8   }

方法3：

親クラスのmousePressEvent関数をオーバーライドしてマウス右クリックイベントを処理します。以下に類似のコード例を示します：

1 void CustomWidget::mousePressEvent(QMouseEvent *event)
2 {
3     if (event->button() == Qt::RightButton)
4     {
5         // 右クリック時の処理
6         showCustomContextMenu(event->globalPos());
7     }
8     QWidget::mousePressEvent(event);
9 }

上記のコードは説明のための簡略化された例です。

ここまで説明した内容で、基本的な右クリックメニューのカスタマイズ方法はほぼ網羅しました。方法1と方法2は伝統的なアプローチで、方法3は少し技巧的な方法です。

三、関連トピック

1. Qtのデフォルトメニュー言語設定
2. Qtのポップアップメニューに影響を加える
3. Qtでカスタム検索ボックスを実装する
4. QTextEditの最大文字数制限