Text Frame

Parent page: Schematic Objects

A placed Text Frame

Summary

A text frame is a non-electrical drawing primitive. It is used to define an area on a schematic to contain textual information. The frame is a resizable rectangular area that can contain multiple lines of text and can automatically wrap and clip text to keep it within the bounds of the frame.

Availability

Text frames are available for placement in both Schematic and Schematic Library Editors:

• Schematic Editor - click Home | Graphical Elements |  from the main menus.
• Schematic Library Editor - click Home | Place |  from the main menus.

Placement

After launching the command, the cursor will change to a cross-hair and you will enter text frame placement mode. Placement is made by performing the following sequence of actions:

1. Position the cursor and click or press Enter to anchor the first corner of the text frame.
2. Move the cursor to adjust the size of the text frame then click or press Enter to complete placement.
3. Continue placing further text frames, or right-click or press Esc to exit placement mode.

Additional actions that can be performed during placement – while the text frame is still floating on the cursor, and before its first corner is anchored – are:

• Press the Tab key to access an associated properties dialog, from where properties for the text frame can be changed on-the-fly.
• Press the Alt key to constrain the direction of movement to the horizontal or vertical axis, depending on the initial direction of movement.
• Press the Spacebar to rotate the text frame counterclockwise or Shift+Spacebar for clockwise rotation. Rotation is in increments of 90°.
• Press the X or Y keys to mirror the text frame along the X-axis or Y-axis respectively.

Graphical Editing

This method of editing allows you to select a placed text frame object directly in the workspace and change its size, shape or location graphically.

When a text frame object is selected, the following editing handles are available:

A selected Text Frame

• Click and drag A to resize the text frame in the vertical and horizontal directions simultaneously.
• Click and drag B to resize the text frame in the vertical and horizontal directions separately.
• Click anywhere on the text frame – away from editing handles – and drag to reposition it. While dragging, the text frame can be rotated (Spacebar/Shift+Spacebar) or mirrored (X or Y keys to mirror along the X-axis or Y-axis respectively).

The textual content of a text frame can be edited in-place by:

1. Single-clicking the text frame to select it.
2. Single-clicking again (or pressing the Enter key) to enter the in-place editing mode. Sufficient time between each click should be given to ensure the software does not interpret the two single-clicks as one double-click (which would open the text frame's properties dialog).
3. To finish editing in-place text, either click away from the text frame or press the green check button (). If you decide the change made is not needed, press the red cross button () to discard the change.

Example in-place editing, with word wrapping enabled (top)
and disabled (bottom).

Non-Graphical Editing

The following methods of non-graphical editing are available:

Via an Associated Properties Dialog

Dialog page: Text Frame

This method of editing uses the Text Frame dialog to modify the properties of a text frame object.

The Text Frame dialog

The dialog can be accessed during placement by pressing the Tab key.

After placement, the dialog can be accessed in one of the following ways:

• Double-click on the placed text frame object.
• Place the cursor over the text frame object, right-click then choose Properties from the context menu.

Clicking the Change button associated with the Text field will open the TextFrame Text dialog, from where you can enter the text for the frame as required.

Entering text using the associated TextFrame Text dialog.

Wrapping and Clipping Text

In addition to providing a Word Wrap option, the main Text Frame dialog provides a Clip to Area option. This option comes into play if word wrapping is disabled. With this option enabled, text will be kept within the bounds of the frame. When disabled, text will spill out of the frame onto the schematic sheet.

Example of word wrapping and the effect of clipping

Specifying Text Margins

Specify a single value to apply equally to Left, Top, Right and Bottom margins for the current frame using the Text margin property in the Text Frame dialog.

Example text frame with a Text margin setting of 20 (Default DXP Units, equivalent to 200mil)

When editing text in-situ directly within the text frame (as opposed to using the TextFrame Text dialog), the defined margins are not present. They will be reapplied after editing is complete and the text changes are applied.

Margins are not shown while graphically modifying the text in-situ.

Via an Inspector Panel

Panel pages: SCH Inspector, SCHLIB Inspector

An Inspector panel enables you to interrogate and edit the properties of one or more design objects in the active document.

Notes

1. While text frames can be rotated or mirrored along the X or Y axis, this has no effect on the orientation of the text within.
2. For simple one line text annotations, consider using the Text String object.