Control Circuit 2026 › Tutorial › Chapter 9

Chapter 9: The Border Editor and Manager

Goal Choose the Border for a project, then open the Border Manager, make your own copy of a shipped Border, and customise its grid zones, logo area and title block Fields.

Where we are

The Border is a single, project wide template made up of graphics, images and dynamically populated text that is common to every Sheet in the circuit. It can carry a company logo, title block information, and all the lines and formatting that make your drawings look professional and well organised.

A finished Sheet, SS01 AHU Multi-Speed Ventilation Fan, showing the Border: grid reference letters and numbers around the edge, and a title block along the bottom with a logo, project, title, drawn by, date, sheet and revision

The Border Manager lets you create new Borders and modify existing ones, using an integrated XML text editor and a WYSIWYG style editor side by side. That gives you granular control over the position of every graphic and text field.

Control Circuit ships with some standard Borders. You can use them as they are, or readily modify them and save the result as your own custom Border.

In this chapter we will select a Border for a project, then customise one to show off the tools available.

Part 1: Selecting the Border

There are two ways to choose the Border for a project.

  1. In the New Project wizard

    The Standards & defaults page has a Selected border section where you can pick one of the common sizes, or choose More… to browse them all.

    The New Project wizard Standards and defaults page with the Selected border section outlined, offering A0 Landscape, A2 Landscape, A3 Landscape (selected), A3 Portrait, A4 Landscape and More
  2. In an existing project

    Choose Project › Project Properties…, open the Drawing tab, and pick from the drop down list.

    The Drawing tab of Project Settings and Properties with the Border drop down list open, showing A0 Landscape through A4 Portrait plus Blank A3 and Blank A4 with no title block
Project wide The Border applies to every Sheet in the project. As the wizard says, it is a project-wide setting. The project also keeps its own copy of the Border, refreshed each time you save, so it still draws if the Border is later removed from your library, or the project is opened on a machine that never had it.

Part 2: The Border Manager

  1. Open the Border Manager

    Choose Tools › Manage Borders…

    The Border Editor window with the Borders list on the left, an empty XML Editor at the top right and an empty Live Preview below it

    The shipped Borders are listed on the left. They all carry a padlock, which means they can be used as sources for your own customisation but cannot be altered themselves. You can of course create a Border from scratch, but why would you? Use a template!

  2. Select A3 Landscape

    Click A3 Landscape in the list.

    A3 Landscape selected in the list, with its XML in the XML Editor and the rendered Border in the Live Preview

    The top right pane is the XML Editor: the plain text XML that describes the Border layout. The bottom right pane is the Live Preview: the visual (WYSIWYG) render of that very same text. They are two editors pointing at the same Border, so edit one and the other updates.

    Note The XML notation is closely related to HTML, with a much more focused subset of features. Consult the Help reference for the elements that are actually supported.
  3. Select an element from either side

    As an example, click into the Zones text in the XML Editor and the Zone strips are selected in the Live Preview. You can select any element how you like, and you can edit any element how you like too: in text, or with the mouse and arrow keys.

    The HZones line selected in the XML Editor with a green arrow to the highlighted column strips along the top and bottom of the Live Preview

    For moving shapes like lines and rectangles the visual editor is probably more convenient. For changing text values the XML editor may serve you better. You have the choice.

  4. Zoom in and out

    As with the main canvas in the circuit editor, you can use the common mouse features to pan and zoom the Live Preview.

    The Live Preview zoomed in on the top left of the title block, showing the logo area, the PROJECT and TITLE labels and the column strip numbers

    You can also zoom the XML Editor to change its font size.

    The XML Editor shown at a larger font size
  5. Nudge a shape with the arrow keys

    Selecting a rectangle in the Live Preview selects the matching XML in the text editor. Use the arrow keys to nudge it around and the new co-ordinates update in the text automatically.

    The LogoArea element selected in the XML Editor and the matching blue rectangle highlighted in the Live Preview, with a green arrow showing it moving

    As it happens, this particular rectangle has a special function: it is the Logo Area. If you want to put a company logo on a Border, this is the built in object for the purpose. We will come back to it.

Part 3: Make your own copy

A shipped Border is locked, so first let us create a custom one that we can actually edit.

  1. Duplicate the Border

    With A3 Landscape still selected, tap Duplicate on the toolbar.

    The Duplicate toolbar button outlined, with a green arrow to the Duplicate Border dialog asking for a new border ID, pre-filled with A3_Landscape_Copy

    The dialog asks for a new Border ID. This is the unique ID of the Border, rather like a filename. Give it something useful and press OK. I named mine A3_Landscape_FRED. What shows in the list is the display name, which at this point is still “A3 Landscape (Copy)”. We will change that next.

  2. Open Properties & Page Setup

    Right-click the new Border in the list and choose Properties & Page Setup…

    The right-click menu on A3 Landscape (Copy) with Properties and Page Setup outlined, above Delete Border, Export Border XML and Open Borders Folder in Explorer

    From here we can edit everything to do with our custom Border.

  3. General & Page Size

    On the General & Page Size tab we can change the Display Name if required, plus the page dimensions and orientation.

    The General and Page Size tab of Border Properties and Page Setup showing the Border ID A3_Landscape_FRED, the Display Name outlined, the paper size and dimensions, and a live layout preview
  4. Drawing Area & Zones

    The Drawing Area & Zones tab holds the usable drawing area and the all important Grid Reference Zones.

    The Drawing Area and Zones tab with the Grid Reference Zones section outlined: horizontal columns count 12 and vertical rows count 8, each with a strip size and position

    These are the actual values that the Auto Numbering engine uses to build the grid reference part of symbol names, on the circuit Sheets, when Auto Numbering by grid is required (see Chapter 7). You may set up to 50 Horizontal Zones and up to 26 Vertical Zones.

    When you change these and press Apply, the Zones in the XML are updated too. You can also edit the values directly in the XML for the same result.

    The HZones and VZones elements in the XML Editor, now with 24 columns labelled 1 to 24 and 20 rows labelled A to T
    Caution Be careful to make sure the H and V count values are accurately reflected in the list of text values supplied in labels, or strange things will happen!
  5. Logo Area

    The Logo Area tab has various options, including whether to use the Logo Area at all. Bear in mind you can use <Image /> placeholders as an alternative.

    The Logo Area tab with Enable Dedicated Logo Area Slot in Title Block ticked, the slot coordinates and size, a Fitment Mode drop down set to Contain, and Default Bottom-Left and Align to Bottom-Right buttons
  6. Add or clear the logo

    To actually add your logo, choose Logo › Set Logo… from the toolbar. A dialog opens so you can browse to a suitable image file. To remove the logo, choose Logo › Clear Logo.

    The Logo toolbar drop down open in the Border Editor, showing Set Logo and Clear Logo, outlined in green
    The logo belongs to the Border It is stored with the Border, not the project, so you can keep one Border per customer, each with its own branding. The image path is absolute, so keep the file somewhere stable. If it moves, or the project is opened on a machine where the path does not exist, the logo will quietly not draw. The exception is a project whose Border is missing from the library: it carries a copy of the logo image along with its copy of the Border, and draws that.

    As mentioned, extra images can be added with the <Image /> element, placed inside the <Graphics> block. For example:

    <Image x="6" y="258" width="58" height="33" src="logo.png" fitment="Contain" />

    The src is looked for beside the Border’s own XML file first, then as a full path, so an image kept beside the Border travels with it. fitment is Contain, Cover, Stretch or Centre.

Part 4: Fields

To populate project specific values into the title block (or any other area) we use Fields. A Field’s name corresponds directly to a project wide value. The Fields are found as a block of elements at the bottom of the XML text.

The Fields block in the XML: ProjectName, SheetTitle, DrawnBy, Date, SheetNum, Revision and Standard, each with a position, font size and maximum width

To move a Field, or change its font size, simply edit the element’s XML and the preview updates live. To cycle through all the elements of the Border, Fields included, put the caret in the text of any element and its graphic highlights. Now move the caret up or down with the arrow keys and the highlight follows along.

  1. Insert a new Field

    Suppose we want to add a new one? There are tools for that. From the toolbar tap Insert Field…, then scroll to (or filter for) the token you need and press Insert Token.

    The Insert Field dialog with a filter box and a tree of tokens grouped by Electrical and Power, then Governance and Sign-off, with AccountManager selected

    New Fields are always added after the last Field in the list, wherever the caret is. The new element appears in the Fields block and its graphic appears on the Border.

    A new AccountManager Field element at the end of the Fields block, with a green arrow to the new text it adds to the title block in the Live Preview
  2. Remove a Field

    To remove a Field, delete its element from the XML text.

    Names that do not match If you type in a Field with a name like “Alice”, the Border cannot resolve the name, so the actual text “Alice” is displayed instead.

There is another way to add Fields, covered in the next part.

Part 5: Reference resources

  1. The data-bound Fields

    In the Border Manager, choose Help › Border Template & Fields Reference… to open a resource to assist you.

    The Data-Bound Fields tab lists every Field available in the project, together with its current actual value.

    The Border Template and Field Reference dialog on the Data-Bound Fields tab, listing Name, Category, Actual Value, Description and Sample Tag for fields such as ProjectTitle, ProjectName and ProjectDate, with Copy Field Name and Copy Field Tag buttons

    Double-click any row to insert the full Field element into the Border you are editing. Or use Copy <Field> Tag to put it on the Windows Clipboard, for example:

    <Field name="ProjectTitle" x="10" y="10" fontSize="5.0" anchor="Left" />

    The copy options matter when you are rolling your own Border templates outside of the editor.

  2. The XML schema

    For that purpose, the XML Syntax & Schema tab is a reference for creating your own Borders outside of this editor.

    The XML Syntax and Schema tab showing a commented complete Border template with the DrawingArea, Zones and LogoArea elements

    Press Copy Complete XML Template, paste it into a text editor, then use the copy buttons on the previous tab to collect the Field elements you would like to include.

What you just did

Next

That completes the introduction to Border templates and the Border Manager. Control Circuit supports Borders up to A0 in size, though most folks will be using A3, possibly A4, so that is the extent of the shipped templates for now. As you have seen, the tools make it easy to create your own custom templates as you need them.

In the final chapter we turn to the Publisher Tools: the Web Portal, Smart PDF, DXF Portfolio and Symbol Library PDF, where your finished Border and Sheets are put to work.