Editing Multiple Design Objects

Altium Designer provides a range of editing tools and capabilities that have been designed to help with making large-scale edits to a design. The main tools for large-scale or global edits in Schematic, Schematic Symbol, PCB and PCB Footprint editors are the corresponding Filter panel, List panels and Find Similar Objects capabilities.

The process of editing multiple items in Altium Designer involves three steps:

  1. Select the objects to be targeted.
  2. Inspect the properties of those objects.
  3. Edit the properties that need to be amended.

With this editing paradigm in mind, Altium Designer offers a range of different ways to select, inspect, and edit multiple objects. Each method has its strengths and by having an understanding of how they work, you are equipped to choose the method that is most applicable to your specific editing challenge.

Selecting Objects

Objects can be selected in a variety of ways and they all fall into two categories:

  • Graphical selection – objects are selected in one of the following ways:
    • Individually by mouse clicks.
    • Accumulatively by Shift+mouse clicks.
    • Using one of the sub-menu selection commands from the main menu (Edit » Select).
  • Logical selection – objects are selected using an interactive or query-based process that targets and filters objects using specific parameters and/or attributes as the search criteria. GUI elements that support this type of selection are:
See the Design Object Selection page to learn more.

Inspecting Objects

The attributes of objects can be inspected or viewed in a variety of ways:

  • Direct Inspection – the attributes of one or more objects are inspected directly through the Properties panel or graphically in the main editor.
  • Indirect Inspection – the attributes of one or more objects that have previously been selected are viewed using the List panel.

Editing Objects

Similarly, objects can be edited in different ways:

  • Direct editing – the attributes of one or more objects are edited directly through the Properties panel or graphically in the main editor.

    To edit all selected objects, open the Properties panel by clicking the Panels button, then choose Properties. To edit only the last object selected, right-click and then choose Properties.
  • Indirect editing – the attributes of one or more objects that have previously been selected can be edited using the List panel.

Examples of viewing and editing properties of polygon pours selected in a PCB document directly through the Properties panel or indirectly through the PCB List panel.
Examples of viewing and editing properties of polygon pours selected in a PCB document directly through the Properties panel or indirectly through the PCB List panel.

Modifying Data Strings using the Properties Panel

Using Formulas

The Properties panel has the ability to modify data strings using formulas in the schematic and PCB editors. Formulas and expressions offer a convenient method of modifying attribute parameters of multiple selected objects to change their location or string-based values such as the Designator and Comment. This allows you to apply a specific expression to the selected string objects. The expression can include any built-in arithmetic operators and functions that apply to strings (found in Pascal). If you want to use the current value for the attribute as part of the expression, you will need to make reference to this original value either by using the full name of the attribute or by using the exclamation character (the supported substitute for the name of the attribute currently being modified). When using attribute names, if any names contain spaces, these must be replaced by the underscore character. For example, use of the Component Designator field within a formula should be entered as Component_Designator.

Using the Smart Edit Feature

Some parameter string fields also provide access to the Smart Edit dialog when multiple objects are selected, which is opened from the associated button.

The Properties panel offers further support for string modification through its Smart Edit feature. Select the cell entries pertaining to the attribute that you want to modify for all required objects, right-click then choose Smart Edit from the menu that appears. The Smart Edit dialog will open.

The dialog offers two methods for performing string modification accessed from the Batch Replace and Formula tabs.

Masking

Masking is a way of explicitly removing an object's eligibility for selection and/or editing. It can be faster to first mask out what is not required instead of selecting what is required.

Consider a design where all vias sitting under a specific BGA device need to have their diameter changed. One way to perform this operation would be to run a query that masks out all non-via objects on the design, then use the Edit » Select » Inside Area menu command to draw a rectangle around the BGA device to select the vias to be targeted. 

Masked objects appear faded, where the selected object passes the applied filter and is displayed normally, with all other design objects faded in gray. The level of fading can be adjusting using the Dimming options in the Highlight Methods region of the System - Navigation page of the Preferences dialog.

Clearing Selections

The current selection can be cleared in the following ways:

  • Pressing the Shift+C shortcut.
  • Using one of the Edit » Deselect sub-menu commands.

Selection Commands

The following selection-based commands are available from the Edit » Select sub-menu.

  • Select overlapped - use this command to single select the next design object in a set of co-located (overlapping) objects, without utilizing a selection pop-up window (shortcut: Shift+Tab).
  • Select next - with an initial object selected in the design, use this command to extend the selection to include the next higher-level object (or objects), based on logical hierarchy (shortcut: Tab).
  • Lasso Select - use this command to select design objects within a user-defined, free-form 'lasso' area.
  • Inside Area – use this command to select design objects within a user-defined area. All objects that fall completely inside this defined area will become selected.
  • Outside Area – use this command to select design objects outside of a user-defined area. All objects that fall completely inside the defined area will remain non-selected. All objects outside of this area will become selected.
  • Touching Rectangle – use this command to select design objects touched by a user-defined bounding rectangle.
  • Touching Line – use this command to select design objects touched by a user-defined line.
  • All – use this command to select all design objects in the current document, including the board shape. (Shortcut: Ctrl+A).
  • Board – use this command to select the board shape and all design objects that lay within its bounding rectangle. (Shortcut: Ctrl+B).
  • Net – use this command to select all routed track and electrical objects associated with a particular net. Simply click on an object within the required net. Click on an area of the design, away from any objects, to access the Net Name dialog in which the name of the net can be entered directly. If unsure of the name, enter ? and click OK to access the Nets Loaded dialog, which lists all currently loaded nets for the design.

    Selection is not cumulative for most of these commands including Net. When a new item is selected, the previous object will become deselected. Press the Spacebar to accumulate selected items.
  • Connected Copper – use this command to select all routed track and electrical objects that are all connected to the same piece of copper. Click on an electrical object (track, pad, fill, etc.) and all electrical objects that are connected by the same piece of copper will become selected. (Shortcut: Ctrl+H).
  • Physical Connection – use this command to select all routed track between two pad objects. Simply click on a track or pad and all contiguous tracks between the two pads will become selected, including any vias. The pads themselves will not be included in the selection.
  • Physical Connection Single Layer – use this command to select connected track segments on the current layer, i.e., to select contiguous copper until the layers change or a component pad is encountered.
  • Component Connections – use this command to select all routed connections emanating from the pads of a chosen component. The component's pads, along with connected tracks and vias will be selected, up to the next encountered pad in each case.
  • Component Nets – use this command to select all nets attached to a chosen component. All nets (and member net objects therein) attached to that component will be selected.
  • Room Connections – use this command to select all pad-to-pad routed connections that fall completely within the boundaries of the chosen room.
  • All on Layer – use this command to select all design objects on the current layer. The current layer is distinguished by the active tab at the bottom of the main design window.
  • Free Objects – use this command to select all free primitive objects within the design. Group objects (such as components, coordinates, dimensions, and polygons) will not be selected. These objects must be converted to their free primitives in order for this selection mode to apply.
  • All Locked – use this command to select all design objects that have their Locked property enabled.
  • Off Grid Pads – use this command to select all pads that are not placed on a defined snap grid.
  • Toggle Selection - use this command to change the selection status of one or more design objects in the current PCB document.
All currently selected objects will be deselected when using this command unless the Click Clears Selection option is disabled on the PCB Editor – General page of the Preferences dialog.
Various de-selection commands are available from the Edit » Deselect sub-menu, including deselection of all selected objects, all selected objects inside or outside of a user-defined area, all selected objects on the current layer, and all selected free objects.

List Panels

The Schematic, Schematic Symbol, PCB and PCB Footprint editors provide access to List panels (SCH List, SCHLIB List, PCB List and PCBLIB List panels, respectively) that display design objects in tabular format, enabling you to quickly inspect and/or modify object attributes. When used in conjunction with the corresponding Filter panel, it enables you to display just those objects falling under the scope of the active filter, allowing you to target and edit multiple design objects with greater accuracy and efficiency. Objects do not need to be selected in order for them to be displayed (and edited) in a List panel.

In addition to the main ways to access a panel (the Panels button at the bottom-right of the design space and the View » Panels sub-menu from the main menus), you can use the Shift+F12 shortcut key to toggle the visibility of the List panel on and off in the corresponding editor.

The List panels are divided into two main regions:

  • Filtering controls to define which objects are displayed in the panel (display scope).
  • A tabular, spreadsheet-like region listing all objects falling under the defined display scope.

Defining Panel Display Scope

Controls at the top of the panel allow you to filter which objects are displayed in the panel and also define the current mode of the panel, allowing you to enable/disable the panel's direct editing functionality.

View/Edit Mode

Use the first field to choose the List panel mode. Click it and choose from the following options:

  • View – this mode allows you only to view the object attributes. Direct editing from within the panel will not be possible in this mode, as indicated by the gray background of the tabular region.
  • Edit – this mode allows you to view and edit the attributes of design objects directly in the tabular region of the panel.

Display Scope

Click on the next highlighted control to choose from the following options:

  • non-masked objects (default) – select this option to display in the tabular region only design objects that are not masked out in the design space (i.e. only those objects that fall under the scope and specific query expression of the currently applied filter). This option is most effective when filtering is applied to the design space and the associated masking highlight option is enabled.
  • selected objects – select this option to display in the tabular region only design objects that are currently selected in the design space.
  • all objects – select this option to display all design objects in the tabular region.
When any filtering currently applied to the design space is cleared, the option to display non-masked objects in the panel will produce the same result as choosing the option to display all objects.

Document/Component Scope

This control is available in the SCH List, SCHLIB List, and PCBLIB List panel and allows you to select the documents/components from which object attributes should be displayed in the panel (the PCB List panel always displays design objects from the active PCB document). Click on the next highlighted control to choose from the following options:

  • current document (SCH List) – only display target objects from the active schematic document in the design space.
  • current component (SCHLIB List, PCBLIB List) – only display target objects from the active library component in the design space.
  • open documents (SCH List) – display target objects from all open schematic documents regardless of their parent project.
  • open documents of the same project (SCH List) – display target objects from all open schematic documents that are source documents of the same parent project.
  • all project documents (SCH List) – display target objects from all schematic documents (including closed ones) that are source documents of the same parent project.
  • all components (SCHLIB List) / whole library (PCBLIB List) – display target objects from all components contained in the active schematic/PCB library document.

Types of Objects

The right-most highlighted control allows you to determine the type of objects that can be displayed in the tabular region. Click on the control to reveal a selection pop-up.

Use the pop-up to choose which object types you want to include in the currently displayed list – either all objects (Display all objects) or specific objects. To choose one or more specific object types, enable the Display only option, then enable the checkbox next to the required object(s) in the list beneath. The list will only contain those object types currently displayed in the tabular region of the panel.

The No option in the PCB List panel refers to other object primitives that are featured in the PCB document but are not denoted in this list, such as Layer Stack Table and Drill Table objects.

When enabling specific object types for display, the control will reflect the choice by listing the enabled types, separated by commas.

Working with Filtered Objects

The main tabular region of the panel displays all design objects that pass the defined display scope for the panel in spreadsheet form.

Object data is initially unsorted. Data may be sorted by any attribute by clicking on the header for that attribute's column. Clicking once will sort in ascending order; click again to sort in descending order.

Making Selections in the List Panel

As objects are selected in the panel, those objects will appear distinguished in the list by the use of a blue background for all of its cells. The list supports single or multiple selections, the latter using standard Ctrl+Click, Shift+Click, and click-and-drag features.

Design objects selected in the List panel become selected in the design space. Conversely, as you select objects in the design space, the corresponding entries for those objects will appear selected in the list.

Javascript ID: Pnl_List_ObjectSelection

Double-clicking on an entry will open the Properties panel for that object, in which you can make changes as required.

In the PCB List panel, user-defined classes can only be edited with respect to their name. As such, double-clicking on a class entry will have no effect.

Displaying Filtering Results

When a filter has been applied based on a query expression entered into the corresponding Filter panel, only those objects under the scope of the filter will be shown, provided that:

  • The Mask out option is enabled in the Objects not passing the filter region of the SCH Filter or SCHLIB Filter panel or the Mask option is selected in the Non-matching region of the PCB Filter or PCBLIB Filter panel.
  • The display scope option for the List panel is set to non-masked objects.
If the Select option has also been enabled in the Objects passing the filter region (SCH Filter, SCHLIB Filter, PCBLIB Filter) or in the Matching region (PCB Filter, PCBLIB Filter) of the Filter panel, all filtered objects will appear selected in the list.
Javascript ID: Pnl_List_FilteringResults

Editing Object Attributes

Editing is only possible if the panel is in Edit mode. When the panel is in View mode, you will be able to only view object properties.

You can edit attributes of an object by editing the relevant entry in the List panel. Click on a cell to focus it and then either right-click and choose Edit or click again to edit the attribute value directly. Depending on the attribute, you will need to type a value, toggle a checkbox, or select an option from a drop-down. The change will take effect after pressing Enter or clicking outside of the cell being edited. This is one of the advantages of using the panel to edit object properties; the panel will remain open, allowing you to change many attributes as needed.

Another advantage of using the panel for editing is that multiple objects can be edited from one place. Selected objects can be of the same or differing types. Those attributes that are common to all objects in the selection will be displayed in the panel. Select the required cells – across all required objects – for the shared attribute to be modified. Then either right-click and choose the Edit command or press the F2 key (or the Spacebar). Edit the value for the chosen attribute with respect to the focused object in the selection (whose cell is distinguished by a dotted outline). Clicking outside the attribute's cell or pressing Enter will effect the change, which will subsequently be applied to all remaining objects in the selection.

By using filtering, you can apply a query (an expression for the filter) to target a specific group of objects in the design/library and then use the List panel to edit the attributes for these multiple objects directly.

Editing Attributes with the Smart Grid Tools

There are two Smart Grid commands available from the panel's right-click menu. These commands allow any Windows-compliant tabular data such as an external table (e.g., PDF) or a spreadsheet (e.g., Microsoft Excel or Google Sheets) to be used to either update the values of existing objects in a List panel (Smart Grid Paste, shortcut: Shift+Ctrl+V) or insert newly-created objects (Smart Grid Insert, shortcut: Ctrl+Ins).

The List panel must be in the Edit mode in order to have copy and paste commands enabled.

Respective dialogs (Smart Gride Paste and Smart Grid Insert) for these commands are used to map the external tabular data coming in on the Windows clipboard to the attributes of objects in the List panel, providing a preview of what changes will be made.

Using the Smart Grid Paste Command

Before opening the Smart Grid Paste dialog, copy the required tabular data and select the List panel content you would like to update. The top half of the dialog (the Clipboard Table View region) will contain the table information from the clipboard. The selected tables from the List panel fill the bottom half of the dialog (the List View region). Information moved into this region using the provided controls will be saved into the List panel after clicking OK to exit the dialog.

There are two ways to update attributes of design objects using the Smart Grid Paste command: updating attributes one at a time with no header data and updating attributes as a group in one operation with header data.

You need to determine whether the tabular data has a Header Row or No Header Row. These options are located at the top right of the Smart Grid Paste dialog. If the tabular data has the header row, you can map and update multiple attributes in one operation. Otherwise, you will have to do different attributes one by one.

  • Header Row – if a header row is included in the information copied to the clipboard, enable this option. The header information will be used to form a header row of columns.
  • No Header Row – if no header row is included in the information copied to the clipboard, enable this option. If a header row is included in the copied information and this option is enabled, the header information will be included in the main table area instead of being placed into column headers.

Use the following controls to copy information from the Clipboard Table View into the List View:

  • Paste Column to Attribute – select a column in both sections of the dialog then click this button to copy the information from the Clipboard Table View and paste it into the List View.
  • Undo Paste to Attribute – undo the last performed instance of the Paste to Attribute command (using the Paste Column to Attribute or Automatically Determine Paste buttons).
  • Automatically Determine Paste – use this button to allow the software to automatically determine where in the List View the clipboard information belongs.
  • Reset All reset the entire dialog. The Clipboard Table View is refreshed. If new information is in the Clipboard, the top panel of the dialog will contain the new information. The List View will revert any changes that have not been saved, including which columns are visible.
  • Choose Visible Columns – click to open the Choose Visible Columns dialog and select which columns to display in the List View section of the Smart Grid Paste dialog. Enable/disable options to Show/Hide columns.

For example, to change attributes as a group using the Smart Grid Paste tool, copy the data using the Copy With Header command from the right-click menu from the List panel, then paste the tabular data, including the header row, in an Excel workbook. The updated tabular data from this workbook can then be pasted back into the same List panel using the Smart Grid Paste command from the pop-up menu. Make sure the selected entries in the List panel correspond to the pasted tabular data; however, you can always select the entries first before doing a paste.

Make sure the Header Row option on the top right of the dialog is enabled. The Smart Grid Paste dialog is then updated with the top half of the dialog representing the copied table data, while the bottom half shows the proposed List panel content. Click the Automatically Determine Paste button to map the attributes from the Clipboard Table View region to the List View region.

All proposed data object mappings set by the Automatically Determine Paste button can be previewed before committing the new attributes to your document(s). Attributes that are being targeted by the Paste action are marked with a blue flag (the icon), and those whose values are changing are marked in a bold font.

You also can use the Paste Column to Attribute and Undo Paste to Attribute buttons to selectively update attributes. To restore all the attributes to their original values, click the Reset All button in the Smart Grid Paste dialog.

Likewise, if you copy the tabular data without the row header and update the tabular data in an external spreadsheet then do a smart paste back into the List panel, you can only do a singular update of each attribute. That is, you use the Paste Column to Attribute and Undo Paste to Attribute buttons to update each targeted attribute and to undo this same attribute each time. The proposed changes are not committed to the document until the OK button is pressed.

Using the Smart Grid Insert Command

With the Smart Grid Insert command, you can create new objects using the Smart Grid Insert dialog from the List panel. You must specify the object type in your tabular data before you can successfully insert new objects in the List panel and its associated document. When the Smart Grid Insert dialog is opened, the List View region of the dialog is populated with information to be added to the List panel. Once the new data objects are mapped from the Clipboard Table View region to the proposed List View region, they are flagged with green indicators (the  icon). Click OK to close the dialog and to add information from the List View region into the List panel and create new objects in the document.

  • The easiest way is to copy the existing object data from the List panel using the Copy with Header command, make additions/changes in a spreadsheet then insert the updated data back into the List panel.
  • The Smart Grid Insert tool in the SCHLIB List panel can be used to import multiple pins from a spreadsheet into the current schematic symbol – learn more about Accelerating Schematic Symbol Creation with the Smart Grid Insert Tool.

Editing Attributes with Numeric Values

For a numerical-based attribute of a selected object, the simplest modification to that attribute's value is made by typing a new value to replace the existing one. The plus and minus operators can be used to specify the value's sign. A value entered without a specified sign is assumed to be positive. Therefore, entering 20 is the same as entering +20.

You can enter specific units of measurement for a value entered. The software will convert the value into the current units defined for the document. If no units are specified, the default units set for the document will be used.

Modification Using an Expression

More advanced modification can be achieved by using an arithmetic expression. Select the entry for the attribute you want to modify and type the expression that will be used to modify its value. You can enter any arithmetic expression using any built-in arithmetic operators and functions (found in Pascal).

If you want to use the current value for the attribute as part of the expression, you will need to make reference to this original value either by using the full name of the attribute or by using the exclamation character (the supported substitute for the name of the attribute currently being modified). If you want, you may use any other attribute field name in an expression. When using attribute names, if any names contain spaces, these must be replaced by the underscore character.

To illustrate an example of using a simple expression, consider a component pin, the Length attribute of which is currently 30. If you wanted to extend this length to 45, you could enter the expression:

Length + 15

or, in shortened form:

! + 15

Note that the spaces are optional. When you press Enter, the value will be updated to 45.

If instead you want to shorten the pin to a length of 20, you could use the subtraction operator as illustrated by the following expressions:

Length - 10
! - 10

To illustrate use of a function, the previous expression could be rewritten as:

! - sqrt(100)

The result would be the same – a length of 20.

By using the attribute's name (or substitution character (!)), the previous expressions add to or subtract from the current value for the attribute. Without such entries in the expression, you would be setting the attribute's value to the evaluated result of the expression. For example, if the attribute name or substitution character had been left out of the previous expressions, the resulting pin length would have been 15 and -10.

Again, you can enter specific units of measurement for a value entered into an expression. Altium Designer will convert the value into the current units defined for the document. If no units are specified, the default units set for the document will be used.

By selecting multiple objects in the panel, you can change numerical attributes simultaneously using an expression. For example, you may want to adjust the length of a series of component pins or shift components vertically or horizontally by a specific distance.

Batch Replacement of String-based Attributes

There are times when you may want to modify a string-based attribute that is common to multiple selected objects in the design space. For example, you may want to rename selected data bus net label objects from D1, D2, D3, etc., to Data1, Data2, Data3, etc. To perform this type of batch replacement, the use of string substitution syntax is supported in the panel.

A string substitution entry is enclosed in braces and has the form:

{oldstring=newstring}

An entry of this form causes all occurrences of oldstring found in the attribute's value to be replaced with newstring. In the case of the data bus net labels, you would select the associated Text attribute cell for each net label, right-click then choose Edit (or press F2), then enter {D=Data} in the active value field.

If you want to replace multiple, differing string portions in the same target string, type multiple substitution entries, each enclosed in its own set of curly braces. For example, consider the following net labels, associated to the output wiring of a WB_PRTIO component, configured to have four, 8-bit I/O ports:

XPort8A_Out[7..0]
XPort8B_Out[7..0]
XPort8C_Out[7..0]
XPort8D_Out[7..0]

Now consider having placed a second WB_PRTIO component configured to have four, 32-bit I/O ports. Instead of placing individual net labels of a similar fashion on each output wire of each port in this second device, you could select all four of the above net labels, copy them, paste them onto the corresponding wires of the new port device, then rename them. It is in this last operation that batch string substitution comes into play.

If the intended format of the new net labels is to be YPort32x_Out[31..0], where x represents the port (A, B, C or D), then you could select the Name attribute for the four net labels in the panel, enter edit mode then enter the following into the active value field:

{X=Y}{8=32}{7=31}

Altium Designer takes this entry and effectively performs a batch substitution – substituting for the first expression, then the second, and so on.

Smart Editing of String-based Attributes

A List panel offers support for string modification through its Smart Edit feature. Select the cell entries pertaining to the attribute to be modified for all required objects, right-click, then choose Smart Edit from the context menu. This opens the Smart Edit dialog. The dialog offers two methods for performing string modification accessed from the Batch Replace and Formula tabs.

Batch Replace Tab

The Batch Replace tab provides straightforward substitution, along the lines of the string substitution discussed previously (but without having to enter the curly braces). Click inside the From field and enter the portion of the current string that you want to replace. Then click inside the To field and enter the string to be used as the replacement. Note that the string substitution that is about to be performed is displayed at the bottom of the tab.

For example, consider pins of a component that currently have the prefix B and you need to change them to the prefix A instead. In this case, select the Pin Designator attribute for each of the pins in the panel, then open the dialog. On the Batch Replace tab, enter B in the From field and A in the To field (the replacement string is therefore {B=A}). After clicking OK, the pin designators will be modified accordingly.

As with basic string substitution, the Batch Replace tab provides for replacement of multiple, differing string portions in the same target string. Enter the various substitutions as distinct From-To entries. Consider the previous WB_PRTIO example (see Batch Replacement of String-based Attributes), where strings of the form XPort8x_Out[7..0] need to be changed to YPort32x_Out[31..0]. In this case, you would enter three distinct substitution entries on the Batch Replace tab, as shown in the image above.

The change is only applied to the characters entered into the From field. Any other characters in each targeted string, such as an incrementing numerical identifier, is not changed.

Formula Tab

The Formula tab provides for more advanced modification, allowing you to apply a specific expression to the selected string objects. The expression can include any built-in arithmetic operators and functions that apply to strings (found in Pascal). Once again, if you want to use the current value for the attribute as part of the expression, you will need to make reference to this original value, either by using the full name of the attribute or by using the exclamation character (the supported substitute for the name of the attribute currently being modified). When using attribute names, if any names contain spaces, these must be replaced by the underscore character. For example, use of the Component Designator field within a formula should be entered as Component_Designator.

For example, three selected memory components are specified in a design with designators U1, U3 and U5. You might want to extend the designators of these components by including some indication of their role. First, select the cell entries for the Component Designator attributes of these components in the List panel and open the Smart Edit dialog. Then, on the Formula tab of the dialog, you could write an expression using the addition operator to add to the existing string value of the Component Designator attribute. This would take the existing (original) string value and concatenate it with a specified new string, as illustrated below:

Component_Designator + '_MEM'

or, in shortened form:

! + '_MEM'

Note that the spaces are optional. After clicking OK, the designators of the components will be updated to U1_MEM, U3_MEM and U5_MEM, respectively.

Expressions entered in the Formula tab of the Smart Edit dialog are saved so they can easily be used again in the future. To re-use previously entered expressions, click  at the right end of the text field, then select an expression from the drop-down menu.

To illustrate the use of string-based functions, consider the Copy function that can be used to take a portion of an original string and place it within an expression to create a new string. Using the previous WB_PRTIO example (see Batch Replacement of String-based Attributes), where strings of the form XPort8x_Out[7..0] need to be changed to YPort32x_Out[31..0], you could select the cell entries for each net label's Text attribute, access the Smart Edit dialog, then write the following expression on the Formula tab:

'Y' + Copy(Text,2,4) + '32' + Copy(Text,7,6) + '31..0]'

or, in shortened form:

'Y' + Copy(!,2,4) + '32' + Copy(!,7,6) + '31..0]'

Another formula example – change the middle character of component designators CAB and CYB to X:

Copy(!, 1, 1) + 'X' + Copy(!, 3, 1)

If the replacement is more complex, such as if the parts of the string have varying lengths, use the Length function to calculate the values for the starting position and amount of characters, as shown below.

Component designators CAAAAAB and CYYYB have a varying length middle part:

  • Replace the entire middle part with a single X:

    Copy(!, 1, 1) + 'X' + Copy(!, Length(!), 1)

  • Replace the last character of the middle part with an X:

    Copy(!, 1, Length(!)-2) + 'X' + Copy(!, Length(!), 1)

Panel Right-click Menu

The right-click menu for the main list area of the panel provides the following commands:

  • Switch to View Mode / Switch to Edit Mode – toggle between View and Edit mode.
  • Edit – edit single or multiple selected objects with respect to a particular attribute in the list. When editing a single object, the command becomes available when an attribute cell entry for a design object is editable. After launching the command, you will be able to edit the value in the selected cell directly. Click outside the cell or press Enter to effect the change. When simultaneously editing multiple objects, the command will become available only if the chosen attribute is editable for all objects in the selection. After launching the command, you will be able to edit the value in the focused cell directly. Click outside the cell or press Enter to effect the change across all cells in the selection. The List panel must be in Edit mode to access this command.
  • Smart Edit – open the Smart Edit dialog, in which you can specify the criteria used to perform batch replacement of string-based attributes. The List panel must be in Edit mode to access this command. Learn more about Smart Editing of String-based Attributes.
  • Copy – copy the selected cells in the list to the Windows clipboard for use in other applications.
  • Copy with Header – copy tabular data, including the header row.
  • Paste – paste the current content of the Windows clipboard into the list. Combined with the Copy command, Paste enables you to copy cell content out to another spreadsheet application, make modifications, and then paste the modified data back into the List panel. The List panel must be in Edit mode to access this command.
  • Smart Grid Paste – open the Smart Grid Paste dialog to change the value of existing objects from pasted tabular data. The List panel must be in Edit mode to access this command. Learn more about Editing Attributes with the Smart Grid Tools.
  • Smart Grid Insert – open the Smart Grid Insert dialog to create new objects from the tabular data. The List panel must be in Edit mode to access this command. Learn more about  Editing Attributes with the Smart Grid Tools.
  • Show Children (SCH List, SCHLIB List) – add object entries to the list with respect to the primitives that constitute group objects (e.g., Parts).
  • Zoom Selected – zoom and center (where possible) the selected objects in the design space.
  • Apply Filter (PCB List, PCBLIB List) – apply filtering based on the selected object(s) in the list. The object(s) will be displayed in the design editor window in accordance with the Mask / Dim / Normal, Select and Zoom options defined in the corresponding Filter panel. The object(s) will be selected regardless of the status of the Select option in the Filter panel. Only those objects in the selection will be displayed in the list.
  • Clear Filter (PCB List, PCBLIB List) – clear the currently applied filter and repopulate the list with all objects in the design.
  • Remove Non-Selected (PCB List, PCBLIB List) – remove all objects from the list that are not currently selected.
  • Report – generate a report containing all objects displayed in the list. After launching the command, the Report Preview dialog will open, in which you can view, print and export the report in various file formats. The report will contain only data that is visible in the panel.
  • Report Selected – generate a report containing only those objects that are currently selected in the list. After launching the command, the Report Preview dialog will open, in which you can view, print and export the report in various file formats. The report will contain only data that is visible in the panel.
  • Show Component Children (PCB List, PCBLIB List) – add object entries to the list with respect to the primitives that constitute components.
  • Show Net Children (PCB List, PCBLIB List) – add object entries to the list with respect to all net objects that constitute nets in the design.
  • Show Polygon Children (PCB List, PCBLIB List) – add object entries to the list with respect to the primitives that constitute polygons.

    The Show Children-based commands are particularly useful when a small selection of parent objects have been previously selected and filtered.
  • Advanced (sub-menu) (PCB List, PCBLIB List) – this sub-menu has commands that allow you to switch to owner components, owner nets or owner polygons from selected child primitives or members belonging to those group objects. In each case, filtering will be applied to each owner object affected and the list will display only those owner objects and their primitives/members if the corresponding option to show children for an object is enabled.
  • Select All – select all objects in the list. The corresponding design objects will become selected in the design space.
  • Select Column(s) – select all cells in the column(s) associated with the currently selected cell(s). All corresponding objects will become selected in the design space. This command is particularly useful when editing a particular attribute of multiple objects.
  • Select Row(s) – select all cells in the row(s) associated with the currently selected cell. All corresponding objects will become selected in the design space. This command is particularly useful when editing a particular attribute of multiple objects.
  • Choose Columns – open the Columns Setup dialog, in which you can select the available columns that are displayed in the panel and the order in which the columns appear. By default, the Display Mode for each attribute is set to Automatic. In this mode, an attribute column will be automatically displayed if it is common to all design objects currently displayed in the panel. Click on the mode to open options that allow you to force the display of the attribute (Show) or hide it completely (Hide).

    • Enable the Show All Attributes option to show all possible attributes.
    • Clicking the Default button will reset the Available Columns to present attributes only for enabled primitives in the design space and reset the Display Mode to Automatic for all.
    • Commands are also available on the right-click context menu for the Available Columns region with which to curate the attributes presented:
      • Edit Selected - edit the selected attribute's Display Mode.
      • Show All Attributes - show all possible attributes.
      • Show Enabled Primitive Attributes - show only attributes with enabled primitives in the design space.
      • Advanced - from the sub-menu, select specific attributes to display. The Hide All Attributes option will clear the Attribute column.
    • In terms of the ordering of columns, their display (left-to-right) in the panel reflects the top-to-bottom order in the Visible Columns region of the dialog. Use the Up and Down buttons to move a selected column entry, or click and drag it to the required position. 

Panel Shortcuts

The following table summarizes key shortcuts that are available when using the main list region of the panel.

Arrow Keys

Shift focus to next cell in direction of arrow key

Left-Click+Drag

Multi-select in direction of mouse movement

Ctrl+Click

Multi-select (non-sequential)

Shift+Click

Multi-select (sequential)

Spacebar or F2

Edit selected cell

Enter

Finish editing current cell and enter edit mode for the cell below

Ctrl+C (or Ctrl+Insert)

Copy

Ctrl+V (or Shift+Insert)

Paste

Page Up

Jump selection to top of visible list area

Page Down

Jump selection to bottom of visible list area

Mouse-wheel

Pan up or down

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.

Content