Sch_Dlg-FindTextDlgFind Text_AD

Now reading version 17.1. For the latest, read: Sch_Dlg-FindTextDlg((Find Text))_AD for version 22

The Find Text dialog.

Summary

This dialog allows the designer to quickly find specific text, or partial text, in accordance with defined search options. In terms of scope, the dialog can be used to search for text on the active schematic document, across all source schematics in the active project, across all open schematics (irrespective of project). You can even constrain the search to project physical documents only - ideal when needing to search for a physical designator across the Compiled Document tab(s) of one one or more schematic documents.

Access

From the Schematic Editor, or Schematic Library Editor:

  • Use the Edit » Find Text command, from the main menus.
  • Use the Ctrl+F keyboard shortcut.

Options/Controls

Text to find

  • Text To Find - use this field to enter the text string that you wish to search for. Either enter the full word, or search for a partial string. The latter requires the Whole Words Only option to be disabled. The string can contain the wildcard characters ? (single character) and * (any group of characters).
Wildcards are always case insensitive.
Each string searched will be added to the field's drop-down list, for quick retrieval.

Scope

  • Sheet Scope - use this field to determine the scope of the text search, in terms of the schematic documents involved. Choose one of the following options:
    • Current Document - search the active document only.
    • Project Documents - search across all schematic documents in the active project.
    • Open Documents - search across all open schematic documents, irrespective of the project they belong to.
    • Project Physical Documents - search across the Compiled Document tabbed views of the active project's source schematic documents.
To search for text across Project Physical Documents requires the active project to be first compiled. If this is not done, the search will simply be across the logical sheets (Editor tabbed view of the document).
  • Selection - use this field to further constrain the scope of the search, based on the current selection status of objects. Choose one of the following options:
    • Selected Objects - limit the search to only those objects that are currently selected.
    • DeSelected Objects - limit the search to only those objects that are currently deselected.
    • All Objects - no limitation, search all objects irrespective of their selection status.
  • Identifiers - use this field to further constrain the scope of the search, based on the type of text-based object. Choose one of the following options:
    • All Identifiers - no limitation, search across all text-based objects (text strings, text frames, pins, net identifiers, and designators).
    • Net Identifiers Only - limit the search to only net identifiers (ports, power ports, sheet entries, offsheet connectors, and net labels).
    • Designators Only - limit the search to only component designators.

Options

  • Case sensistive - enable this option to perform a case-sensitive search, whereby the target text must match the case of the search text entered into the Text To Find field.
  • Whole Words Only - enable this option to restrict the search to whole words only. This means the search text must exist fully as is, and not be part of a larger text string. For example if this option is enabled, when looking for "cat", the software will not consider the first three letters of "category" a valid search match. Disable this option to freely search for partial strings.
  • Jump to Results - enable this option to have matching/found text zoomed and centered in the main design window (where possible).

Tips

  1. Where a search yields multiple matches, the Find Text - Jump dialog is opened. Use this dialog to jump between the matching search results.
  2. The found text (or all instances for multiple match results) is also listed in the Messages panel. Double-click a message entry to jump to that text in the workspace.

 

If you find an issue, select the text/image and pressCtrl + Enterto send us your feedback.
Note

The features available depend on your Altium product access level. Compare features included in the various levels of Altium Designer Software Subscription and functionality delivered through applications provided by the Altium 365 platform.

If you don’t see a discussed feature in your software, contact Altium Sales to find out more.