CLion 2023.3 ヘルプ

QML 構文のサポート

CLion は、Qt5 と Qt6 の両方の .qml ファイルで構文サポートを提供します。以下に、QML コードインサイト機能の例をいくつか示します。

  • QML の型とプロパティのハイライトとコード補完:

    QML completion
  • QML シンボルの使用箇所の検索は、Alt+F7 を押すか、エディターでヒントをクリックして呼び出すことができます。

    QML symbols usage hints

    使用箇所ポップアップでは、それらの間を移動して検索を調整できます ():

    QML symbols usage popup
  • もう 1 つのナビゲーションオプションは、ファイルコンテンツの構造ビューです。これを開くには、Alt+7 を押すか、メインメニューから表示 | ツールウィンドウ | 構造を選択します。

    QML file structure
  • クイックドキュメントポップアップは QML シンボルにも使用できます。シンボルの上にマウスを置くか、Ctrl+Q を押して呼び出します。

    Quick documentation for QML symbols

QML 言語サーバーを有効にする

  1. 設定 | 言語 & フレームワーク | QML に移動し、QML 言語サーバーを有効にするチェックボックスを設定します。

    Enabling QML languafe server

    このオプションは、qmlls コンポーネントがインストールされている場合、QML 固有のコードインスペクションを有効にします。

  2. QML 言語サーバーからの補完を使用するを有効にして、CLion によって提供されるものではなく、QML シンボルの言語サーバーベースの補完候補を取得します。

追加の QML インポートパスを追加する

  1. 設定 | 言語 & フレームワーク | QML に移動します。

  2. 追加の QML インポートフィールドに、追加の QML モジュールを含むディレクトリへのパスを指定します。

QML コードスタイル

IDE 設定または qmlformat (英語) を使用して、QML のコードスタイルを構成できます。

  • デフォルトでは、qmlformat は無効になっており、CLion は組み込みのコードスタイル設定を使用します。これらにアクセスするには、設定 | エディター | コードスタイル | QML に移動します。

    Code style settings for QML

    設定にすばやくアクセスするには、下部のステータスバースイッチャーで qml QML のインデントを構成するを選択します。

    Configure QML code style options
  • qmlformat を有効にするには、ステータスバースイッチャー (上記を参照) を使用するか、設定 | 言語 & フレームワーク | QML に移動して「qmlformat」をフォーマッタとして有効にするチェックボックスを設定します。

    Enabling qmlformat

    qmlformat が有効になっている場合、そのインジケータが下部のステータスバーに表示されます。そこから qmlformat を無効にすることもできます:

    Qmlformat indicator in the status bar

トラブルシューティング: QML 構文サポートを手動で有効にする

CLion が Qt インストールパスまたは QML インポートディレクトリを見つけられなかったことを示すエディター通知を受け取った場合は、以下の手順に従ってください。

QML imports directory not found warning
  1. CMAKE_PREFIX_PATH が Qt インストールディレクトリを指していることを確認します。

    CMake の設定をクリックし、次を CMake のオプションに追加します。

    -DCMAKE_PREFIX_PATH=your_qt_installation

    例:

    Qt installation path in CMake options
  2. ほとんどの場合、CLion が Qt および QML パスを検出するには、CMake を構成するだけで十分ですが、通知がまだ存在する場合は、パスを手動で設定する必要があります。これを行うには、QML 設定をクリックするか、設定 | 言語 & フレームワーク | QML に移動します。

既知の問題と制限

QML のサポートは CLion であり、現在進行中の作業です。既知の問題のリストは次のとおりです。

  • 多くの標準関数とメソッドは、未解決 (CPP-31883(英語)) としてハイライトされています。

  • QML ファイルの構造ビューが改善されています (CPP-31886(英語))。

  • QML の配色とコードスタイルの設定は開発中です (CPP-30547(英語))。

関連ページ:

使用箇所を検索

使用箇所の検索アクションを使用すると、コードベース全体でコード要素の参照を検索できます。検索プロセスを管理し、単一のファイルのみで検索したり、検索をプロジェクト全体に拡張したり、特定の検索範囲を作成したりできます。さらに、使用箇所のハイライトの色を構成したり、用途の自動ハイライトを完全に無効にしたりできます。ファイル内の使用箇所を検索するキャレットをシンボルに置き、を押します。CLion は、ファイル内のシンボルの使用箇所をすべて表示します。に進みます。CLion は、ファイル内の最初の使用箇...

ファイル構造

構造ツールウィンドウまたは構造ポップアップを使用して、エディターで現在開いているファイルの構造を調べることができます。デフォルトでは、CLion は現在のファイルにあるすべてのクラスと機能を表示します。CMake プロジェクトでは、変数、関数、マクロ、ターゲットを含む CMakeLists.txt ファイルの構造を調べることもできます。ファイル構造を開くまたはこのツールウィンドウには、エディターで現在開いている、プロジェクトツールウィンドウで選択した、フォーカスを持っているファイルの構造が表示されます...

クイックドキュメント

クイックドキュメントポップアップ helps you get more information on a code element at caret: CLion shows quick documentation in a popup on mouseover automatically: Depending on the element you invoke it for, the popup can include: 関数のシグネチャーの詳細とコードのドキュメント (通常のコメントまたは Doxy...

Qt プロジェクト

Qt は、GUI アプリケーションを作成するためのクロスプラットフォームの C++ フレームワークです。Qt は独自のビルドシステム qmake を使用し、バージョン Qt4 以降の CMake でのビルドもサポートしています。純粋な Qmake プロジェクトを CLion に直接インポートすることはできません。ただし、CMake に変換すると、通常の CMake アプリケーションとして開いて管理できます。新規プロジェクトウィザードを使用して、CLion で CMake ベースの Qt プロジェクトを作成する...

React

React は、カプセル化されたコンポーネントから複雑なインタラクティブユーザーインターフェースを構築するための JavaScript ライブラリです。React オフィシャル Web サイトからライブラリの詳細を参照してください。CLion は、React と統合され、lint の設定、編集、実行、デバッグ、アプリケーションの保守を支援します。始める前に:お使いのコンピューターに Node.js がインストールされていることを確認してください。設定 | プラグインページのインストール済みタブで、J...