Writing Code Working with Sidebars

Working in Edit Mode

This section describes how to use the Edit mode. For more information about using the sidebar, see Browsing Project Contents.

Using the Editor Toolbar

The editor toolbar is located at the top of the editor view. The editor toolbar is context sensitive and shows items relevant to the file currently open in the editor.

Use the toolbar, Window menu items, or keyboard shortcuts to navigate between open files and symbols in use.

To browse backward or forward through your location history, click (Go Back) and (Go Forward).

To return to the last location where you made a change, select Window > Go to Last Edit.

To go to any open file, select it from the Open files drop-down menu (1). To open a context menu that has commands for managing open files, right-click the file name or icon on the toolbar. In addition to the commands also available in the File menu, you can copy the path and name of the current file and the number of the line where the cursor is currently located to the clipboard by selecting Copy Full Path, Copy File Name, or Copy Path and Line Number.

To jump to any symbol used in the current file, select it from the Symbols drop-down menu (2). By default, the symbols are displayed in the order in which they appear in the file. Right-click the menu title and select Sort Alphabetically to arrange the symbols in alphabetic order.

To jump to a line and column in the current file, select the line and column indicator (3) or press Ctrl+K (or Cmd+K on macOS) to open the locator. Enter the line number and column number in the locator, separated by a colon (:).

Note: You can also use the sidebars to move around in Qt Design Studio.

Selecting Line Ending Style

To switch between Windows line endings (CRLF) and Unix line endings (LF), select the ending style on the editor toolbar (6). To hide this field, select Edit > Preferences > Text Editor > Display, and deselect Display file line ending.

To set the line endings to use for all projects by default, select Edit > Preferences > Text Editor > Behavior, and then select the ending style in the Default line endings field.

To set the line endings to use for a project, select Projects > Project Settings > Editor.

Editing Selected Lines

The Edit > Advanced menu has options for editing selected lines of text.

To duplicate the selected lines, select Duplicate Selection. To format the duplicated lines as a comment, select Duplicate Selection and Comment.

To turn selected text into lowercase, select Lowercase Selection or press Alt+U. To turn it into uppercase, select Uppercase Selection or press Alt+Shift+U.

To sort selected lines alphabetically, select Sort Selected Lines or press Alt+Shift+S.

Select Add Next Occurrence to Selection or press Ctrl+D to add a cursor at the next occurrence of selected text for multi-cursor editing.

Multi-Cursor Editing

To apply a change to several places simultaneously, press and hold Alt, and click to place cursors in several places. Any changes you make are applied simultaneously at all the cursor positions.

Use the arrow keys to move all the cursors up and down. The Home and End key move all the cursors to the beginning or to the end of the line.

Press and hold Alt and double-click strings to select several strings simultaneously.

Press Alt+Shift+I to create cursors at the ends of selected lines.

Press Esc to remove all the cursors and selections.

Splitting the Editor View

Split the editor view or open the editor in a new window when you want to work on and view multiple files on the same screen or on multiple screens.

You can view multiple files simultaneously in the following ways:

  • To split the editor view into a top and bottom view, select Window > Split, press Ctrl+E, 2, or select the (Split) button and then select Split.

    Split command creates views below the currently active editor view.

  • To split the editor view into adjacent views, select Window > Split Side by Side, press Ctrl+E, 3, or select Split > Split Side by Side.

    Side by side split command creates views to the right of the currently active editor view.

  • To open the editor in a detached window, press Ctrl+E, 4, or select Window > Open in New Window.

    The new window behaves basically in the same way as the editor area in the main window. For example, you can split this window, as well. Documents are opened in the currently active editor window.

To move between split views and detached editor windows, select Window > Go to Next Split or Window or press Ctrl+E, O.

To remove a split view, place the cursor within the view you want to remove and select Window > Remove Current Split, press Ctrl+E, 0, or select the (Remove Split) button. To remove all but the currently selected split view, select Window > Remove All Splits or press Ctrl+E, 1.

Using Bookmarks

To insert or delete a bookmark in the Edit mode:

  • Right-click the line number and select Toggle Bookmark.
  • Press Shift and click the left margin at a line.
  • Press Ctrl+M when the cursor is on a line.

Adding Notes to Bookmarks

To add a note to a bookmark:

  • Select Tools > Bookmarks > Edit Bookmark.
  • Press Ctrl+Shift+M.
  • Right-click a bookmark and select Edit Bookmark in the context menu.

To view the note, move the mouse pointer over the bookmark or open the Bookmarks view in the sidebar.

To go to the previous bookmark in the current session, select Tools > Bookmarks > Previous Bookmark or press Ctrl+,.

To go to the next bookmark in the current session, select Tools > Bookmarks > Previous Bookmark or press Ctrl+..

To use the locator to go to a bookmark, press Ctrl+K (or Cmd+K on macOS) to open the locator. Enter b and a space to display a list of bookmarks. To filter the bookmarks by line number or a text string, enter the number or string after the space. Double-click a bookmark in the list to go to it in the editor.

"Filtering bookmarks in locator"

Viewing Bookmarks

Bookmarks are listed in the Bookmarks view in the sidebar. To move between bookmarks, select the Previous Bookmark or Next Bookmark button or use the keyboard shortcuts.

"Listing bookmarks in Bookmarks view"

Moving to Symbol Definition or Declaration

You can move directly to the definition or the declaration of a symbol in the Edit mode by holding the Ctrl key and clicking the symbol. If you have multiple splits opened, you can open the link in the next split by holding Ctrl and Alt while clicking the symbol.

To enable this moving function, select Edit > Preferences > Text Editor > Behavior > Enable mouse navigation.

There are several additional ways of moving between symbol definitions and declarations. All the functions described below are also available from the Tools > C++ menu. The functions supported for QML and JavaScript code are available from the Tools > QML/JS menu.

You can select the symbol and press F2, or right-click the symbol and select Follow Symbol Under Cursor to move to its definition or declaration. To follow the symbol in the next split, select Follow Symbol Under Cursor in Next Split. Following symbols is supported for namespaces, classes, functions, variables, include statements, and macros.

To move to the type definition of a symbol, select Follow Symbol Under Cursor to Type or press Ctrl+Shift+F2. To follow the symbol in the next split, select Follow Symbol Under Cursor to Type in Next Split or press Ctrl+E, Ctrl+Shift+F2.

When the cursor is on a string literal and the string is a QRC file path, following the symbol opens the specified resource file for editing in the Resource Browser.

To switch between the definition and declaration of a function, place the cursor on either and press Shift+F2 or right-click and select Switch Between Function Declaration/Definition or Open Function Declaration/Definition in Next Split. For example, this allows you to navigate from anywhere within a function body directly to the function declaration.

Links are opened in the same split by default. To open links in the next split, prepend Ctrl+E to the shortcut. For example, press Ctrl+E,F2 to follow the symbol in the next split. If necessary, the view is automatically split. To change the default behavior, select Edit > Preferences > Text Editor > Display > Always open links in another split. Additional symbols are displayed and switching between definition and declaration is done in another split. If you change the default behavior, the shortcuts for opening link targets in the next split are used to open them in the current split.

To switch between C++ header and source files, right-click anywhere in a file and select Switch Header/Source or Open Corresponding Header/Source in Next Split. You can also press F4 or Ctrl+E,F4, respectively.

Writing Code Working with Sidebars

Available under certain Qt licenses.
Find out more.