「Qtのコントロール - キーボード」の版間の差分

📢 Webサイト閉鎖と移転のお知らせ

このWebサイトは2026年9月に閉鎖いたします。

移転先はhttps://mochiu.net/index.php?title=Qtのコントロール - キーボードです。

新しい記事は移転先で追加しております。（旧サイトでは記事を追加しておりません）

← 古い編集

ビジュアルウィキテキスト

@@ 1行目: / 1行目: @@
 == 概要 ==
+Qt Widgetでのキーボードの入力制御は、ユーザインターフェースの重要な要素である。<br>
+基本的には、<code>QKeyEvent</code>クラスを使用して、キーボードイベントを処理する。<br>
+<br>
+主な方法として、<code>keyPressEvent</code>メソッドおよび<code>keyReleaseEvent</code>メソッドをオーバーライドすることが挙げられる。<br>
+これらのメソッドは、キーの押下あるいはリリースした時に呼び出される。<br>
+<br>
+例えば、特定のキーが押下された時に任意の動作を実行する場合、以下に示すように記述する。<br>
+<br>
+ <syntaxhighlight lang="c++">
+ void MyWidget::keyPressEvent(QKeyEvent *event)
+ {
+    if (event->key() == Qt::Key_Return) {
+       // [Enter]キーが押下された場合
+    }
+    else {
+        QWidget::keyPressEvent(event);
+    }
+ }
+ </syntaxhighlight>
+<br>
+また、ショートカットキーを設定する場合は、<code>QShortcut</code>クラスを使用する。<br>
+これにより、特定のキーの組み合わせに対してアクションを割り当てることができる。<br>
+<br>
+フォーカスの制御も重要な要素である。<br>
+[Tab]キーを使用してウィジェット間を移動できるようにするには、<code>setFocusPolicy</code>メソッドを使用してフォーカスポリシーを設定する。<br>
+<br>
+キーボードイベントをフィルタリングする場合は、<code>eventFilter</code>メソッドを使用することもできる。<br>
+これにより、特定のウィジェットに対するキーボードイベントをインターセプトして、カスタム処理を行うことが可能である。<br>
+<br>
+アクセシビリティの観点からは、キーボードナビゲーションを適切に実装することが重要である。<br>
+これには、ショートカットキーの提供、論理的なタブ順序の設定、フォーカスインジケータの実装等が含まれる。<br>
+<br>
+使用例としては、カスタムキーシーケンスの実装やテキスト入力のカスタマイズ等がある。<br>
+これらは、より複雑なユーザインターフェースや特殊な入力要件がある場合に役立つ。<br>
+<br>
+キーボードの入力制御を実装する場合は、異なるプラットフォームや言語での動作の違いに注意する必要がある。<br>
+Qtでは、多くの場合これらの違いを抽象化するが、特定のケースでは追加の対応が必要になることがある。<br>
 <br><br>
 == 単一キーの取得 ==
-フォーカスを持つオブジェクトに破棄されたイベントは、<code>keyPressEvent</code>メソッドで受け取れない。<br>
+単一キーが押下された場合を取得するには、<code>keyPressEvent</code>メソッドを使用する。<br>
+<br>
+ただし、フォーカスを持つオブジェクトに破棄されたイベントは、<code>keyPressEvent</code>メソッドで受け取れない。<br>
 イベント一括処理で破棄されたイベントは受け取れない。<br>
+<br>
+<u>※注意</u><br>
+* 基底クラスの呼び出し
+*: 未処理のキーイベントを適切に処理するため、デフォルトケースで基底クラスの<code>keyPressEvent</code>を呼び出すことが推奨される。
+* キーの繰り返し
+*: 長押しによるキーの繰り返しを区別する場合は、<code>QKeyEvent</code>クラスの<code>isAutoRepeat</code>メソッドを使用する。
+* イベントの受理
+*: 特定のキーイベントを完全に処理したことを示すため、<code>QKeyEvent</code>クラスの<code>accept</code>メソッドを呼び出す。
+*: <br>
+*: イベントを完全に処理した後、それ以上の伝播を望まない場合は、<code>QKeyEvent</code>クラスの<code>accept</code>メソッドを呼び出す。
+*: イベントを処理した後、他のウィジェットやハンドラにも処理の機会を与える場合は、<code>QKeyEvent</code>クラスの<code>ignore</code>メソッドを呼び出す、あるいは、何もしない。
+<br>
   <syntaxhighlight lang="c++">
   // Mainwindow.h
@@ 22行目: / 72行目: @@
   void MainWindow::keyPressEvent(QKeyEvent *pEvent)
   {
-     switch (pEvent->key())
+     switch (pEvent->key()) {
-    {
         case Qt::Key_Escape:
            qDebug() << "Esc keyPress";
+          pEvent->accept();
            break;
         case Qt::Key_Return:
@@ 32行目: / 82行目: @@
         case Qt::Key_Enter:
            qDebug() << "Enter(keypad) keyPress";
+          pEvent->accept();
            break;
         case Qt::Key_Home:
            qDebug() << "Home keyPress";
+          pEvent->accept();
            break;
         case Qt::Key_Left:
            qDebug() << "Left keyPress";
+          pEvent->accept();
            break;
         case Qt::Key_Down:
            qDebug() << "Down keyPress";
+          pEvent->accept();
            break;
         case Qt::Key_Space:
            qDebug() << "Space keyPress";
+          pEvent->accept();
            break;
         case Qt::Key_F1:
            qDebug() << "F1 keyPress";
+          pEvent->accept();
            break;
         case Qt::Key_0:
            qDebug() << "0(keypad) keyPress";
+          pEvent->accept();
            break;
         default:
            qDebug("keyPress %x", pEvent->key());
+          QMainWindow::keyPressEvent(pEvent);  // 基底クラスの呼び出し
            break;
+    }
+    // 自動繰り返しを区別する場合
+    if (pEvent->isAutoRepeat()) {
+       qDebug() << "Key is auto-repeating";
+    }
+ }
+ </syntaxhighlight>
+<br><br>
+== モディファイアキーとの組み合わせ ==
+[Ctrl]キーあるいは[Shift]キー等のモディファイアキーと組み合わせる場合は、<code>QKeyEvent</code>クラスの<code>modifiers</code>メソッドを使用する。<br>
+<br>
+<u>※注意</u><br>
+<u>モディファイアキーと組み合わせた特定のアクションを実行する場合、そのアクションが完全にイベントを消費するならば、<code>accept</code>メソッドを実行する。</u><br>
+<u>モディファイアキーの状態を記録または確認するだけの場合、<code>accept</code>メソッドは実行せずに、そのイベントを他のハンドラへ渡すほうがよい。</u><br>
+<br>
+ <syntaxhighlight lang="c++">
+ // Mainwindow.h
+ // ...略
+ protected:
+    void keyPressEvent(QKeyEvent *pEvent);
+ </syntaxhighlight>
+<br>
+ <syntaxhighlight lang="c++">
+ // Mainwindow.cpp
+ // 押下したキー名をデバッグ出力する
+ // その他のキーは、16進数を出力する
+ void MainWindow::keyPressEvent(QKeyEvent *pEvent)
+ {
+    // モディファイアキーの制御
+    if (pEvent->modifiers() & Qt::ControlModifier) {
+       if (pEvent->key() == Qt::Key_C) {
+          // 特定のキーイベントのみを消費する場合
+          qDebug() << "[Ctrl] + [C] pressed";
+          pEvent->accept();
+       }
+       else {
+          // ロギングのみを行う場合
+          qDebug() << "Ctrl is pressed with" << pEvent->key();
+       }
+    }
+    else {
+       // それ以外の場合は、基底クラスを呼び出すことにより、他のウィジェットやハンドラがイベントを処理する機会を与えることが可能
+       QMainWindow::keyPressEvent(pEvent);  // 基底クラスの呼び出し
      }
   }
@@ 478行目: / 584行目: @@
 </center>
 <br><br>
+{{#seo:
+|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
+|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,Podman,電気回路,電子回路,基板,プリント基板
+|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
+|image=/resources/assets/MochiuLogo_Single_Blue.png
+}}
 __FORCETOC__
 [[カテゴリ:Qt]]