このページの内容

チュートリアル:Qt Widgets のUIとPython

まず、Qt for Python アプリケーションプロジェクトを作成します。次に、組み込みのQt Widgets Designer を使用して、ウィジェットベースのUIを設計します。

Qt Widgets を使った小さなアプリケーション

Qt for Python アプリケーションの作成に関するその他の例については、「Qt for Python の例とチュートリアル」を参照してください。

ウィンドウUIプロジェクトの作成

メインクラスのソースファイルを含むQt for Python アプリケーションを作成するには:

  1. File 」>「New Project 」に移動します。
  2. 以下を選択します Application (Qt for Python) >Window UI >Choose を選択して、「Project Location 」ダイアログを開きます。

    [プロジェクトの場所] ダイアログ

  3. Name 」で、プロジェクト名を入力します。例:hello_world_ui
  4. Create in 」で、プロジェクトファイルのパスを入力します。例:C:\Examples
  5. Next 」(Windows および Linux)または「Continue 」(macOS)を選択して、「Define Class 」ダイアログを開きます。

    「クラスの定義」ダイアログ

  6. Class name 」で、クラス名として「MainWindow」を選択します。
  7. Base class では、 QMainWindow を基底クラスとして選択します。

    注: 「 Source fileフィールドは 、クラスの名前に合わせて自動的に更新されます。

  8. [Project file] で、プロジェクトファイルの名前を入力します。
  9. Next 」または「Continue 」を選択して、「Define Python Interpreter 」ダイアログを開きます。

    「Python インタプリタの定義」ダイアログ

  10. PySide version 」で、生成されるコードの PySide バージョンを選択します。
  11. Next 」または「Continue 」を選択して、「Kit Selection 」ダイアログを開きます。

    Pythonプロジェクト用のキットの選び方

  12. プロジェクトのビルド、デプロイ、実行に使用する Python キットを選択します。デフォルトでは、ソースディレクトリ内にプロジェクト用の仮想環境が作成されます。グローバルインタプリタを使用するには、Details でキットの Python と同じ名前のビルド構成を選択してください。
  13. Next 」または「Continue 」を選択します。
  14. プロジェクト設定を確認し、Finish (Windows および Linux)またはDone (macOS)を選択してプロジェクトを作成します。

ウィザードにより、以下のファイルが生成されます:

  • form.ui、これはウィンドウ UI 用の UI ファイルです。
  • pyproject.toml:Python プロジェクト内のファイルやその他の設定を一覧表示するファイルです。
  • mainwindow.py:クラス用の定型コードが含まれています。
  • requirements.txt:生成されたコードの PySide バージョンを格納するファイルです。このファイルを使用して、pip を通じて必要な PySide バージョンをインストールできます。

プロジェクト用に PySide6 をインストールする

Edit 」モードで、「Install 」を選択し、プロジェクト用に PySide6 をセットアップします。

PySide6のインストールを促すメッセージ

ウィジェットベースの UI を設計する

  1. Edit 」モードで、「Projects 」ビュー内の「form.ui 」ファイルをダブルクリックし、統合されたQt Widgets Designer を起動します。
  2. Widget Box から以下のウィジェットをフォームにドラッグします:

    UIへのウィジェットの追加

    注: ウィジェットを簡単に見つけるには Widget Box の上部にある検索ボックスを使用してください。たとえば、「Text Edit 」ウィジェットを探すには、「text」という単語の入力を開始してください。

  3. Text Edit 」ウィジェットをダブルクリックし、「Enter text here」というテキストを入力します。
  4. Check Box ウィジェットをダブルクリックし、「Select me」というテキストを入力します。
  5. Push Button 」ウィジェットをダブルクリックし、「Click me」というテキストを入力します。
  6. Ctrl+S(またはCmd+S)を選択して、変更を保存します。

Qt Widgets Designer を使用した UI の設計の詳細については、『Qt Widgets Designer マニュアル』を参照してください。

アプリケーションの実行

「実行」ボタン (Run) を選択して、アプリケーションを実行します。

「チュートリアル:Qt Quick と Python」、「チュートリアル:Qt Widgets と Python」、および「 Qt for Python アプリケーションの開発も参照してください

Copyright © The Qt Company Ltd. and other contributors. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.