Using Queries

Underlying Altium Designer's schematic and PCB editors is a powerful query engine. By entering queries into this engine, you can logically scope precisely those objects you require. A query is a string you enter using specific keywords and syntax, which will return the targeted objects.

There are a number of places where you can apply a query but command central is the Filter panels shown in the images below.

The PCB Filter and SCH Filter panels with queries

The PCBLIB Filter and SCHLIB Filter panels with queries

Queries can be defined in a Filter panel to select a group of objects in the schematic, schematic symbol, PCB, or PCBLIB editor. To use a Filter panel to select a required group of objects, perform the following steps:

1. Open the Filter panel by clicking the  button in the lower right corner of the design space or by pressing F12 to display/hide the panel.

2. In the text field of the panel, define a query by typing into the field. As you type, a prompt list of possible keywords appear as an aid. To provide aid in the creation of queries, a number of tools are available:

   • Query Helper dialog.

   • Defining the objects to be found in the Find Similar Objects dialog with the Create Expression option enabled.

   • Using the PCB Filter or PCBLIB Filter panel settings in the Object and Layer regions of the panel and the Query Builder dialog.

3. Enable the Select option in the panel.

4. Configure other settings in the panel to define the scope of searching, i.e., what should be done with non-matching objects, etc.

5. Click the Apply / Apply to All / Apply to Selected button.

All of the objects that are members of the query result set subsequently acquire a selected state, ready to be edited.