Changing Text Label Properties
Displaying Parameter Data in Text Labels
Text can be displayed on component graphics by using a Text Label object. Text labels can be one line of text only, and the user may select alignment and size.
To add a text label to your component definition, the most straightforward method is to use the ribbon control bar Shapes tab:
Simply left-click the Text button, drag it to where you want it placed and left-click again.
Text label properties can be adjusted through the Text Properties dialog: Either left double-click or right-click over the text label and select Properties....
Appearance:
Alignment: Select the down arrow to bring up the alignment list. Select Left, Centre or Right justification for your text.
Font: Select the font and size of the text. Click the '...' box to bring up the Font dialog.
Angle: Enter a text display angle in degrees.
Colour: Select the down arrow to bring up the colour palette. Left-click on a colour box to change the text colour. Note the slider bar across the top can be used to adjust the opaqueness of the colour.
Data:
Text: Enter the text you wish to appear on the label.
Visibility:
Expression: Enter an expression to determine under what input conditions the object is to be visible. See Expressions Statements and Operators for more details.
It is possible to use text labels to display the contents a specific input parameter field. For example, you can display the MVA rating of a transformer model according to what is entered in its Rated MVA input field.
Linking a text label to an input parameter is accomplished by simply entering the Symbol name of an associated input parameter into the text label, preceded by either a percent (%) or a dollar ($) symbol. If the $ prefix is used, just the value of the linked input field will be displayed. If the % prefix is used, both the value and the specified unit will be displayed. The following example illustrates how to link to an input field. See The Parameters Section and Substitutions for more details.
EXAMPLE 1:
A user wants to display the value of an input field with Symbol name timec, which represents the component time constant. The user adds a text label to the component graphic and adds the following to the Text input field in the Format Text Label dialog:
Component Graphic section |
Text Label Properties |
If the timec input field has a value of say 10.0 [s], then the resulting display on the Circuit canvas would be similar to:
NOTE: If the % prefix above is replaced by the $ prefix, the units will not be displayed.