Construct 3 icon

Construct 3

Documentation

The Find Results Bar

Published 11 Aug, 2017
464 words
~2-3 mins

Paid plans only The Find Results Bar is displayed either when you search for text in an event sheet (using Ctrl + F or Event sheetFind...), or when you use the Find all references feature (e.g. via the Project Bar to search for an object type's references). The results are listed with highlighting and information about their location, and they can be used to navigate to the result in the project.

The Find Results BarThe Find Results Bar

There are various different kinds of find results. These can be text matches for text searches, event matches for Find all references, instances on a layout, family members, and more. Normally navigating to a result locates and selects the relevant event in the Event Sheet View. However other types display in different ways; for example navigating to a reference which indicates a number of instances on a layout will instead open the Layout View, select those instances, and adjust the scroll and zoom so all the instances are visible on-screen.

To navigate to a result, simply double-click on it, or right-click and select Go to. This allows you to review the result in its original context.

Results can also be removed via the right-click menu, or the results cleared entirely. You can also choose Redo search to update the results with the latest state of the project.

Finding in projects, especially Find all references, is an excellent way to review large projects. It can also provide helpful reminders about what you've used and where. It's also a good way to check if something is unused and so can be safely deleted.

Ambiguous results

In some cases, Find all references is unable to determine if a reference is a match or not. For example if you use the system Create object by name action to create an object with a name based on TextInput.Text the editor doesn't know what the value at runtime will actually be, because it can't predict what the user will type in to the text input. It's possible it could refer to the object being searched for, but it can't be certain.

To handle these cases, they are listed anyway so you can check them yourself. Ambiguous results appear with a question mark icon to indicate they are not certain results.

One reason to avoid heavy usage of dynamic features like Create object by name is to avoid clogging up the Find all references results with ambiguous results that can't be proven to refer to one object or another. The standard Create object action, on the other hand, uses an object picker instead of a string expression. This means the editor does know in advance what kind of object will be created, and thus can list it accurately when using Find all references.