1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
|
// Copyright (C) 2024 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only
/*!
\page creator-editor-locator.html
\previouspage creator-how-tos.html
\ingroup creator-how-to-search
\title Navigate with locator
Locate not only files, but any items defined by \e{locator filters},
as well as trigger global actions and perform other tasks, such as build
projects or run external tools.
\image qtcreator-locator.webp {List of locator filters}
\section1 Go to the locator
To activate the locator:
\list
\li Press \key {Ctrl+K} (\key {Cmd+K} on \macos).
\li Go to \uicontrol Tools, and then select \uicontrol Locate.
\li Go to \uicontrol Edit, and then select \uicontrol {Go to Line}.
\li Click the line and column indicator on the
\l{Edit Mode}{editor toolbar}.
\endlist
By default, you can find the locator in the bottom left of the \QC window.
To open it as a centered popup, select \inlineimage icons/magnifier.png, and
then select \uicontrol {Open as Centered Popup}.
\section1 Use locator filters
The filters that are available depend on the current document and project.
If the locator field is empty, a list of available filters is shown.
A list of filters is also shown when selecting \inlineimage icons/magnifier.png.
For more information about what a particular locator filter does, see the
tooltips that appear when you hover over a filter.
To use a locator filter:
\list
\li Type the locator filter prefix followed by \key Space. The prefix
is usually short, from one to three characters. Then type the search
string (for example, a filename or class name) or the command to
execute.
\li Select a locator filter in the filter list to use it. Press
the up and down arrow keys or press \key Ctrl+P and \key Ctrl+N
to move up and down the list, and then press \key Enter to use the
selected filter.
\endlist
As you type a search string,
the locator shows the occurrences of that string regardless of where in the
name of an object it appears. Some locator filters, such as colon, \c m,
and \c t, support \e fuzzy matching, which means that you can enter the
uppercase letters to locate a symbol when using camel case or the letters
after the underscore when using snake case.
\section2 Use wildcard characters in search strings
To narrow down the search results, use the following wildcard characters:
\list
\li To match any number of any or no characters, enter \c{*}.
\li To match a single instance of any character, enter \c{?}.
\endlist
\section1 Omit default filters
By default, you can use the following preset locator filters without a
prefix:
\list
\li Going to a line and column in the current file (\c {l}).
\li Going to an open file (\c {o}).
\li Going to a file in any open project (\c {a}).
\endlist
\section1 Locate lines and columns
To move directly to a particular line and column in the document when you
open the document, append the line and column number to the file name in
the locator, separated by plus signs (+) or colons (:).
For example, to open \e HelloWorld.qml to line
41 and column 2, enter:
\code
HelloWorld.qml:41:2
\endcode
\section1 Search the web
Use the \uicontrol {Web Search (r)} locator filter to perform web searches.
URLs and search commands for Bing, Google, Yahoo! Search, cplusplus.com, and
Wikipedia are configured by default. Add search commands for other web search
engines in the locator preferences.
\section1 Create files and directories from the locator
To create a new file and open it in the editor:
\list 1
\li Type \c f followed by \key Space, followed by path and file name
\li Press \key Enter or select \uicontrol {Create and Open File}.
\endlist
To create a directory, select \uicontrol {Create Directory}.
\sa {Search}{How To: Search}, {Manage sessions}, {Perform calculations},
{Locator}
*/
/*!
\page creator-preferences-locator.html
\previouspage creator-reference.html
\ingroup creator-reference-preferences
\title Locator
\brief Add and change locator filters.
To set locator preferences, go to \preferences > \uicontrol Environment >
\uicontrol Locator, or select
\inlineimage icons/magnifier.png > \uicontrol Configure in the locator field.
\image qtcreator-locator-customize.webp {Locator preferences}
\section1 Changing Locator Filters
You can change the preset locator filters to match your use case. For
example, change the filter prefix and restrict the search to
items that match the filter.
To configure a locator filter:
\list 1
\li Go to \preferences > \uicontrol Environment > \uicontrol Locator.
\li Select a filter, and then select \uicontrol Edit.
\li Specify the prefix string.
\image qtcreator-locator-filter-edit-ai.webp {Filter Configuration dialog}
\li To implicitly include the filter even when not typing a prefix as a
part of the search string, select \uicontrol {Include by default}.
\endlist
\section1 Adding Web Search Engines
By default, the \uicontrol {Web Search (r)} locator filter includes the URLs
and search commands for Bing, Google, Yahoo! Search, cplusplus.com, and
Wikipedia.
To find out the format of the search command to use for your favorite
web search engine, perform a search in your browser and copy the resulting
URL to the locator filter configuration. Replace the search term with the
variable \c {%1}.
To add URLs and search commands to the list:
\list 1
\li Go to \preferences > \uicontrol Environment > \uicontrol Locator.
\li Select \uicontrol {Web Search} > \uicontrol Edit.
\li Select \uicontrol Add to add a URL filter to the list.
\image qtcreator-add-online-doc.webp {List of URLs in Filter Configuration dialog}
\li Double-click the new entry to specify a URL and a search command.
For example, \c {http://www.google.com/search?q=%1}.
\li Click \uicontrol OK.
\endlist
To add a new separate web search locator filter instead of updating the
default filter, select \uicontrol Add > \uicontrol {URL Template}.
\section1 Creating Locator Filters
To quickly access files not directly mentioned in your project,
create your own directory filters. That way you can locate files in a
directory structure you have defined.
To create custom locator filters:
\list 1
\li Go to \preferences > \uicontrol Environment > \uicontrol Locator.
\li Select \uicontrol Add > \uicontrol {Files in Directories} to add
a directory filter.
\image qtcreator-locator-generic-directory-filter.png {Filter Configuration dialog}
\li In \uicontrol Name, enter a name for your filter.
\li Select \uicontrol Add to add directories to \uicontrol Directories.
The locator searches directories recursively.
\li In \uicontrol {File pattern}, specify file patterns to
restrict the search to files that match the pattern.
Separate the patterns with commas. For example, to search for all
\c {.qml} and \c {.ui.qml} files, enter \c{*.qml,*.ui.qml}
\li In \uicontrol {Exclusion pattern}, specify file
patterns to omit files from the search.
\li In \uicontrol Prefix, specify the prefix string.
To implicitly include the filter even when not typing a prefix
as a part of the search string, select
\uicontrol {Include by default}.
\li Select \uicontrol OK.
\endlist
\section1 Configuring Locator Cache
The locator searches the files matching your file pattern in the directories
you have selected and caches that information. \QC updates the cache for all
preset filters as you write code. By default, \QC updates your custom
filters once an hour.
To update the cached information manually, select
\inlineimage icons/magnifier.png > \uicontrol Refresh in the locator.
To set a new cache update time:
\list 1
\li Go to \preferences > \uicontrol Environment > \uicontrol Locator.
\li In \uicontrol {Refresh interval}, set a new time in minutes.
\endlist
\section1 Hiding Long Paths
To hide the common part of absolute paths in the locator:
\list 1
\li Go to \preferences > \uicontrol Environment > \uicontrol Locator.
\li Select \uicontrol {Show Paths in Relation to Active Project} to
show relative paths.
\endlist
\sa {Navigate with locator}, {Search}{How To: Search}, {Perform calculations},
{Locator}
*/
|
