Configuring the Editor

Qt Creator allows you to configure the text editor to suit your specific needs. To configure the editor, select Tools > Options... > Text Editor.

These settings apply to all projects. To specify editor behavior for an open project, select Projects > Editor Settings. For more information, see Specifying Editor Settings.

You can perform the following configuration actions:

• Set the font preferences and apply color schemes for syntax highlighting in Font & Colors.
• Specify definition files for syntax highlighting for other types of files than C++ or QML in Generic Highlighter.
• Set tabs, indentation, the handling of whitespace, and mouse operations in Behavior.
• Set various display properties, for example, highlighting and folding blocks, text wrapping or moving to symbol definition or declaration in Display.
• Add, modify, and remove code snippets in Snippets.
• View and remove text editing macros in Macros.
• Configure code completion in Completion.

Configuring Fonts

You can select the font family and size. You can specify a zoom setting in percentage for viewing the text. You can also zoom in or out by pressing Ctrl++ or Ctrl +-, or by pressing Ctrl and rolling the mouse button up or down. To disable the mouse wheel function, select Tools > Options... > Text Editor > Behavior and deselect the Enable scroll wheel zooming check box.

Antialiasing is used by default to make text look smoother and more readable on the screen. Deselect the Antialias check box to turn off antialiasing.

Defining Color Schemes

You can select one of the predefined color schemes for syntax highlighting or create customized color schemes. The color schemes apply to highlighting both C++ and QML files and generic files.

To create a color scheme:

1. Select Tools > Options... > Text Editor > Fonts & Color > Copy.
2. Enter a name for the color scheme and click OK.
3. In the Foreground field, specify the color of the selected code element.
4. In the Background field, select the background color for the code element.

   The backgound of the Text element determines the background of the code editor.

When you copy code from Qt Creator, it is copied in both plain text and HTML format. The latter makes sure that syntax highlighting is preserved when pasting to a rich-text editor.

Indenting Code

When you type code, it is indented automatically according to the selected options. Select a block to indent it when you press Tab. Press Shift+Tab to decrease the indentation.

When you press Backspace the indentation is decreased by one level, instead of one space, by default.

By default, the tab-length in code editor is 8 spaces, but you can change it. The code editor can also determine whether tabs or spaces are used on the previous or next line and copy the style.

You can determine whether the block indent style includes braces, or you can use the GNU indent style. The GNU style places braces on a separate line, indented by 2 spaces, except when they open a function definition, where they are not indented.

You can also specify whether continuation lines are aligned with the previous code or just indented to the logical depth. You can always use spaces for alignment or use spaces or tabs depending on the other options you selected.

The following code snippet illustrates excluding braces from the indented block:

 void foobar(bool zoo)
 {
     if (zoo)
     {
         foo();
     }
 }

The following code snippet illustrates including braces in the indented block:

 void foobar(bool zoo)
 {
     if (zoo)
         {
         foo();
         }
 }

The following code snippet illustrates the GNU style:

 void foobar(bool zoo)
 {
   if (zoo)
     {
       foo();
     }
 }

File Encoding

To define the default file encoding, select the desired encoding in Default encoding. By default, Qt Creator uses the file encoding used by your system.