Eplan Platform API
EPLAN API / API Reference / Interactions / XGedIaFormatSymbol
In This Topic
    XGedIaFormatSymbol
    In This Topic
    Formats all property texts of a symbol reference. Can be offered for configurable toolbar.
    Parameter Description

    language

    Language (optional). Possible values are: "AllLanguagesColumn", "AllLanguagesRow", "OneLanguageVariable", "de_DE", "en_US", ...
    

    height

    Text height (optional). Value in mm or In or "-16002" for "from layer".
    

    color

    Text color (optional).
     0 = black,
     1 = red,
     2 = yellow,
     3 = green,
     4 = cyan,
     5 = blue,
     6 = magenta,
     7 = black,
     8 = white,
     9 = light gray,
     252 = dark gray,
     253 = gray,
     -16002 = from layer;
     The user can set other values in the color selection. Possible values are from 0 to 256.
    

    justification

    Adjustment (optional).
     1 = kTopLeft,
     2 = kTopCenter,
     3 = kTopRight,
     4 = kMiddleLeft,
     5 = kMiddleCenter,
     6 = kMiddleRight,
     7 = kBottomLeft,
     8 = kBottomCenter,
     9 = kBottomRight,
     10 = kBaseLineLeft,
     11 = kBaseLineCenter,
     12 = kBaseLineRight,
     13 = kSpecialLeft (Special Attachment-Types for PathTexts in DIN- and USA-Project),
     14 = kSpecialCenter (Should not be used in new projects, just to be compatible to E5),
     15 = kSpecialRight,
     16 = kJicSpecialLeft (Special Attachment-Types for PathTexts in JIC-Project),
     17 = kJicSpecialCenter(Should not be used in new projects, just to be compatible to E5),
     18 = kJicSpecialRight)
    

    angle

    Angle to the X-axis in ° (optional).
     Possible values are: 0°,45°, 90°, 135°, 180°, -45°, -90°, -135°
    

    font

    Text font (optional).
     Possible values are:
     0 = font 1 of company settings,
     1 = font 2 of company settings,
     ...,
     9 = font 10 of company settings
    

    visible

    Text visibility (optional).
     Possible values are: 0 = invisible, 1 = visible, 2 = from layer
    

    bold

    Text accentuation (optional). Possible values are: 0 = normal, 1 = bold
    

    italic

    Text accentuation (optional). Possible values are: 0 = normal, 1 = italic
    

    underline

    Text accentuation (optional). Possible values are: 0 = normal, 1 = underlined
    

    showtextbox

    Defines whether to use a text box (optional).
     Possible values are: 0 = no text box, 1 = rectangular text box, 2 = elliptic text box, 3 = from layer
    

    setframeactive

    Defines whether there should be an activate frame (optional).
     Possible values are: 0 = should not be active, 1 = should be active
    

    showframe

    Defines whether to show a frame (optional).
     Possible values are: 0 = no alignment box, 1 = show alignment box
    

    framewidth

    Frame width in mm or In (optional).
    

    frameheight

    Frame height in mm or In (optional).
    

    adjustframe

    Adjustment of frame (optional).
     1 = do not fit in,
     16 = Text: width fixed - never word-wrap,
     32 = Text: height fixed - never word-wrap,
     64 = Text: word-wrap,
     80 = Text: width fixed - word-wrap,
     128 = Text: remove line breaks,
     144 = Text: width fixed - never word-wrap - remove line breaks,
     208 = Text: width fixed - word-wrap - remove line breaks
    

    propertyId

    ID (of 5 digits) of a property of the symbol (optional).
     If this ID is set, only this property text will be changed.
    

    propertyIndex

    Index of the property ID (optional). Negative values are possible. Example of possible values: ... -1, 1, 2, 3, ...
    

    linespacing

    Row spacing in number of lines (optional). Please use value -160.02 to set "from layer".
    

    paragraphspacing

    Paragraph spacing in mm or In (optional).
    

    layer

    Layer name (optional). Example: "EPLAN501"
    

    Remarks
     In properties which should not be changed, simply leave a question mark ("?").
     
    
     The settings are the same as in the characteristic text dialog.
     
    

    Example
     See Interaction "XGedIaFormatText"