動作

C++ や QML コードを含まないテキストファイル（Python コードファイルなど）のインデント設定を行うには、[Preferences ] > [Text Editor ] > [Behavior] を選択します。

テキストエディタの設定にある「動作」タブ

Tab キーやBackspaceキーの押下をどのように解釈するか、また続き行をどのように揃えるかを設定できます。

タブ設定

タブの設定は、以下のレベルで設定できます。

すべての C++ ファイルに対して
すべての QML ファイルに対して
その他のすべてのテキストファイル
プロジェクト内のC++ファイル
プロジェクト内のQMLファイル
プロジェクト内のその他のテキストファイル

タブとインデントの設定

「Tabs and Indentation 」グループで、タブのルールとタブ幅を設定できます。「Default Tab policy 」フィールドで、インデントにスペースのみ、タブのみ、またはその両方を併用するかを選択します。

デフォルトでは、コードエディタでのタブ長は8スペース、インデントサイズは4スペースです。タブ長とインデントサイズは、プロジェクトごとやファイルの種類ごとに個別に設定できます。

続き行を前の行に合わせて揃えることができます。「Align continuation lines 」フィールドで、「Not at all 」を選択すると、自動揃えが無効になり、続き行は論理的なインデント深度に合わせてインデントされます。常にスペースを使用して揃えるには、「With Spaces 」を選択します。「Tab policy 」に従うには、「With Regular Indent 」を選択します。

入力設定

テキストやコードを入力すると、選択したテキストエディタまたはコードスタイルの設定に従って、自動的にインデントされます。入力設定を行うには、[Preferences ] > [Text Editor ] > [Behavior ] > [Typing] の順に選択します。

次の表は、設定可能な入力設定について説明しています。

設定項目	説明
Enable automatic indentation	テキストエディタまたはコードスタイルの設定に従って、改行を自動的にインデントします。
Backspace indentation	「Backspace 」を選択した際に、インデントをどのように縮小するかを設定します。 1 スペースずつ戻すには、「None 」を選択します。先頭の空白文字を1レベル分減らすには、「Follows Previous Indents 」を選択します。カーソルの左側の文字がスペースの場合、タブ幅分だけ戻すには、「Unindents 」を選択します。
Tab key performs auto-indent	Tabキーを押したときにテキストを自動的にインデントする設定: 常にテキストをインデントするには、「Always 」を選択します。カーソルが先頭の空白領域内にある場合にのみテキストをインデントするには、「In Leading White Space 」を選択します。テキストをインデントしない場合は、「Never 」を選択します。
Prefer single line comments	ハイライト定義ファイルに複数行コメントと単一行コメントの両方の定義が含まれている場合、選択範囲をコメントアウトする際に単一行コメントの定義を適用するには、このオプションを選択します。
Preferred comment position	選択範囲をコメントアウトする際の 1 行コメントの位置を設定します: ファイルのハイライト定義に基づいて単一行コメントの位置を決定するには、[Automatic] を選択します。ハイライト定義が利用できない場合、コメントは先頭の空白の後に配置されます。 1行コメントを常に先頭の空白の後に配置するには、「After Whitespace 」を選択します。 1行コメントを行末に配置するには、[At Line Start] を選択します。

保存時の空白の整理

ファイルを保存するたびに空白を自動的に整理するには、[Preferences ] > [Text Editor ] > [Behavior] を選択し、[Cleanups Upon Saving] に移動します。

次の表は、設定可能なクリーンアップ設定について説明しています。

設定項目	説明
Clean whitespace	保存時に末尾の空白を削除する。
In entire document	変更した部分だけでなく、ドキュメント全体の空白をクリーンアップします。「Clean whitespace 」が選択されている場合に利用可能です。
Clean indentation	タブ設定に従って先頭の空白を修正します。「Clean whitespace 」が選択されている場合に利用可能です。
Skip clean whitespace for file types	末尾の空白が削除されない、ワイルドカードを含むファイルパターンを、コンマまたはセミコロンで区切って指定します。デフォルトでは、`.md, .MD, Makefile` はスキップされます。「Clean whitespace 」が選択されている場合に利用可能です。
Ensure newline at end of file	ファイルの末尾に常に改行文字を書き込みます。

ファイルのエンコーディング設定

ファイルの作成または保存時に使用されるデフォルトのテキストエンコーディング、バイト順マーク（BOM）、および改行形式を設定するには、[Preferences ] > [Text Editor ] > [Behavior] を選択し、[File Encodings] に移動します。

次の表は、設定可能なファイルエンコーディングの設定項目について説明しています。

設定項目	説明
Default encoding	新しいファイルや、エンコーディングを自動的に検出できないファイルに使用するテキストエンコーディングを選択します。
UTF-8 BOM	UTF-8 のバイト順マークの処理方法を設定します。 Add If Encoding Is UTF-8 UTF-8 エンコーディングでファイルを保存する際に、常に BOM を追加します。エンコーディングが `System` の場合、テキストエディタはそのエンコーディングが実際に何であるかを判別できないため、この設定は機能しません。 Keep If Already Present 読み込み時にすでにBOMが含まれていた場合、BOMを含んだ状態でファイルを保存します。 Always Delete UTF-8のBOMを一切書き込まない。これにより、既存のBOMが削除される可能性がある。 UTF-8のBOMは一般的ではなく、一部のエディタでは正しく処理されないため、通常はBOMを追加しても意味がありません。この設定は、UTF-16およびUTF-32のBOMの使用には影響しません。
Default line endings	新規ファイルのデフォルトの行末スタイルとして、「Unix (LF) 」または「Windows (CRLF) 」を選択します。

設定項目

説明

Default encoding

新しいファイルや、エンコーディングを自動的に検出できないファイルに使用するテキストエンコーディングを選択します。

UTF-8 BOM

UTF-8 のバイト順マークの処理方法を設定します。

Add If Encoding Is UTF-8 UTF-8 エンコーディングでファイルを保存する際に、常に BOM を追加します。エンコーディングが `System` の場合、テキストエディタはそのエンコーディングが実際に何であるかを判別できないため、この設定は機能しません。
Keep If Already Present 読み込み時にすでにBOMが含まれていた場合、BOMを含んだ状態でファイルを保存します。
Always Delete UTF-8のBOMを一切書き込まない。これにより、既存のBOMが削除される可能性がある。

UTF-8のBOMは一般的ではなく、一部のエディタでは正しく処理されないため、通常はBOMを追加しても意味がありません。この設定は、UTF-16およびUTF-32のBOMの使用には影響しません。

Default line endings

新規ファイルのデフォルトの行末スタイルとして、「Unix (LF) 」または「Windows (CRLF) 」を選択します。

マウスとキーボードの設定

テキストエディタでのマウスおよびキーボードの使用に関する設定を行うには、[Preferences ] > [Text Editor ] > [Behavior] を選択し、[Mouse and Keyboard] に移動します。

次の表は、設定可能なマウスおよびキーボードの設定について説明しています。

設定項目	説明
Hide mouse cursor while typing	入力中にマウスカーソルを非表示にします。macOS では利用できません。
Enable mouse navigation	マウスを使用してエディタ内を移動します。たとえば、Ctrl キーを押しながらクリック（macOS ではCmd キーを押しながらクリック）してリンクをたどることができます。
Enable scroll wheel zooming	Ctrl キーを押しながらマウスホイールを回転させると、エディタ内のテキストを拡大表示できます。
Enable built-in camel case navigation	カーソルによる移動や選択を行う際、camelCase および snake_case の名前を、1 つの「こぶ」または単語の一部ずつ移動します。
Enable smart selection changing	Select Block Up およびSelect Block Down による選択操作をよりスマートにします。
Show help tooltips using keyboard shortcut (Alt)	Alt キーを押すと、コンテキストに応じたヘルプや型情報をツールチップとして表示するようにします。
Show help tooltips using the mouse	「On Mouseover 」を選択すると、マウスオーバー時にコンテキストに応じたヘルプや型情報が表示され、「On Shift+Mouseover 」を選択すると、ホバー中にShift キーを押したときにのみ表示されます。

Beautifier C++ コードスタイル

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.