このページでは

Qt Quick アプリケーションのプレビュー

コードエディタから、Qt Quick アプリケーションや個々のQMLファイルをプレビューできます。コードに加えた変更は、プレビュー画面に即座に反映されます。

Qt Quick アプリケーションのプレビュー。

アプリケーション全体のプレビュー

Qt Quick アプリケーションを起動してプレビューするには:

  1. アプリケーションを起動するには:
    • エディタのツールバーから「アプリケーション上でQMLコードの変更をリアルタイムでプレビューする 」を選択します。
    • Command Palette 」に移動し、「Qt: Preview changes to QML code live in your application 」を選択します。
  2. 起動先としてアプリケーションの実行ファイルを選択します。

ビルドディレクトリがワークスペース外にある場合は、「Qt: Open Qt Extension settings 」> Qt Qml Configuration を選択し、Preview: Additional Build Dirs で設定します。これにより、QML プレビュー中に QRC ファイルをどこで検索するかを Qt Extension for VS Code に指示します。

コマンドパレットからアプリケーションを起動する際にコマンドライン引数を渡すには、Qt: Open Qt Extension settings > Qt Qml Configuration > [Preview: Args] で設定します。

単一のファイルをプレビューする

単一の QML ファイルをプレビューするには:

  • エディタツールバーから「現在のQMLファイルをリアルタイムでプレビューする 」を選択します。
  • Command Palette 」に移動し、「Qt: Preview current QML file live 」を選択します。

実行中のアプリケーションに接続してライブプレビューを行う

実行中のQt Quick アプリケーションに接続してライブプレビューを行うには:

  1. Terminal で、次の引数を指定してアプリケーションを起動します:
    <your_executable_path> -qmljsdebugger=host:<IP_address>,port:<port_number>,block,services:QmlPreview,DebugTranslation

    ここで、IP_addressはアプリケーションが実行されているホストの IP アドレス、port_numberはデバッグ用ポート番号です。

  2. Command Palette にアクセスし、「Qt: Attach to a running QML application for live preview 」を選択します。
  3. アプリケーションが実行されているホストのIPアドレスを入力します。
  4. アプリケーションが実行されているポート番号を入力します。

プレビューを停止する

Qt Quick アプリケーションまたは QML ファイルのプレビューを停止するには:

  • プレビューウィンドウを閉じます。
  • エディタのツールバーで「QMLのプレビューを停止する 」を選択します。
  • Command Palette 」に移動し、「Qt: Stop QML Preview 」を選択します。

プレビューウィンドウを再読み込みする

プレビューウィンドウを再読み込みするには、[Command Palette] に移動し、[Qt: Reload QML Preview] を選択します。

Qt の設定も参照してください

© 2026 The Qt Company Ltd. 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.