Using some actions which you can store as buttons on toolbars, you have the option of setting the formatting settings of components, texts, graphical elements, or connection and potential definition points to exactly determined values. The available settings are the same as those that can be made in the individual property dialogs on the Display, Format and Connection graphic tabs.
For the formatting of properties, the following actions are available:
- Set component format (action name: XGedIaFormatSymbol)
- Set text format (action name: XGedIaFormatText)
- Set format of graphical elements (action name: XGedIaFormatGraphic)
- Set graphical format of connections (connection definition point, potential definition point) (action name: XGedIaFormatDefPoints).
In the following table, all possible parameters of these actions are listed. The exact syntax for each action can be seen in the example entry on the command line. This sample entry is shown in the Configure button dialog when you add a button with an action to a toolbar. If a property should not be changed, then leave the corresponding question mark "?" on the command line alone.
The following parameters are possible on the command line for the formatting settings:
Command line parameters |
Meaning |
Values |
---|---|---|
/height:? |
Font size |
Numeric values in "mm" or in "In" (Inch). With the value "-16002", the "From layer" setting will be applied. |
/color:? |
(Text or line) Color |
The predefined values are:
However, other values can also be specified in the Color selection dialog. Values from 0 to 256 are possible. The color values are displayed in the color selection tooltips. |
/justification:? |
(Text) Alignment |
The following values are possible:
|
/angle:? |
Angle to the X-axis by which the text should be rotated in the counter-clockwise direction. |
The following values are possible:
Angle specifications are always in degrees. The "°" character need not be specified, but may be. |
/font:? |
Font |
The values for fonts 1-10 can be determined under the Options > Settings > Company > Graphical editing > Fonts menu items. The following values are possible:
|
/visible:? |
Invisible (text or line invisible / visible) |
The following values are possible:
|
/bold:? |
Font style / Bold |
The following values are possible:
|
/italic:? |
Font style / Italic |
The following values are possible:
|
/underline:? |
Font style / Underlined |
The following values are possible:
|
/showtextbox:? |
Draw text box |
The following values are possible:
|
/graphic:? |
Graphic |
The following values are possible:
|
/setframeactive:? |
Activate alignment box |
The following values are possible:
|
/showframe:? |
Draw alignment box |
The following values are possible:
|
/framewidth:? |
Width of the alignment box |
Numeric values in "mm" or in "In" (Inch) |
/frameheight:? |
Height of the alignment box |
Numeric values in "mm" or in "In" (Inch) |
/adjustframe:? |
Fit (alignment box) |
The following values are possible:
|
/width:? |
Line thickness |
Numeric values in "mm" or in "In" (Inch). With the value "-16002", the "From layer" setting will be applied. |
/type:? |
Line type |
The following values are possible:
|
/patternlength:? |
Pattern length |
Numeric values in "mm" or in "In" (Inch). With the value "-16002", the "From layer" setting will be applied. |
/sizefromsettings:? |
Size from project setting |
The following values are possible:
|
/leaderline:? |
Activate leader line |
The following values are possible:
|
/lineendstyle:? |
Line end style |
The following values are possible:
|
/filled:? |
Fill surface |
The following values are possible:
|
/rounded:? |
Rounded (only applies to rectangles) |
The following values are possible:
|
/radius:? |
Arc Radius (only applies to rounded rectangles; fillet radius of the corners) |
Numeric values in "mm" or in "In" (Inch) |
/language:? |
Language (as on the Display / Format tab in the Property dialog); only for the 'Set component format' and 'Set text format' actions |
The following values are possible:
|
/propertyId:? |
Identifier of a component property to be defined (= Property number)
|
5-digit number |
/propertyIndex:? |
The index, if the property has indices; usually 0 |
|
/linespacing:? |
Row spacing |
Numeric values. The value "1" corresponds, e.g., to single row spacing, value "2" is double spacing, etc. |
/paragraphspacing:? |
Paragraph spacing |
Numeric values in "mm" or in "In" (Inch) |
/layer:? |
Layer |
Layer name (e.g. "EPLAN501") |
/donttranslate:? |
Do not translate automatically (as in the Text tab in the Property dialog); only for the "Set text format" action |
The following values are possible:
|
Note:
Size values such as those for the Font size or Line thickness fields may be entered in 'mm' or 'In' (inches). If no unit is specified for a value, the displayed measuring unit set in the properties (Options > Settings > User > Display > Displayed units of measure) will be used in the user interface settings.
The following values are to be set for certain texts: Font size: 10 mm, Color: Green, Angle: -90°. In addition an alignment box with the following values is to be shown: Width: 45 mm, Height: 20 mm. Then the entry in the command line looks as follows:
XGedStartInteractionAction /Name:XGedIaFormatText /height:10mm /color:3
/angle:-90 /setframeactive:1 /showframe:1 /framewidth:45mm /frameheight:20mm
For certain graphical elements, the line thickness should be set to 5.5 mm and the graphic filled with cyan. The graphical elements should always be visible. Then the entry in the command line looks as follows:
XGedStartInteractionAction /Name:XGedIaFormatGraphic /width:5,5mm /color:4 /visible:1
You want to change the function text and other placed property texts for specific components on a schematic page to French. Then the entry in the command line looks as follows:
XGedStartInteractionAction /Name:XGedIaFormatSymbol /language:fr_FR
In the case of certain components on a schematic page, only the function text of all placed properties is to be assigned the color "Red". Then the entry in the command line looks as follows:
XGedStartInteractionAction /Name:XGedIaFormatSymbol /color:1 /propertyId:20011
If the parameter /propertyId is not specified in the command line, all property texts of the selected components receive the color "Red".
See also