API Help
EPLAN API / API Reference / Actions / changelayer
In This Topic
    changelayer
    In This Topic
    Changes graphical layer properties.
    

    Parameter Description

    PROJECTNAME

    Project name with full path. Optional.
    If not entered, the selected project is used when the action is called from GUI (like from a script or button bar). 
    If called from the windows command line, PROJECTNAME must be set or the  must be used first, otherwise an  exception is thrown. 
    

    LAYER[n]

    Name of layer. Parameter name may be followed by a number.
    

    VISIBLE[n]

    The layer is visible. Parameter name may be followed by a number. This parameter is optional.
    

    PRINTED[n]

    The layer is printed. Parameter name may be followed by a number. This parameter is optional.
    

    TEXTHEIGHT[n]

    Specifies text height of layer. Parameter name may be followed by a number. This parameter is optional.
    

    COLORID[n]

    Specifies color index of layer (0-255). Parameter name may be followed by a number. This parameter is optional.
    

    TRANSPARENCY[n]

    Specifies transparency of 3D layer as double with a value between 0.0 and 1.0. Parameter name may be followed by a number. This parameter is optional.
    

    Remarks
    It is possible to change properties of more than one layer in single action call. First it is necessary to add /LAYER parameter followed by a number - /LAYER1:EPLAN100, then each parameter should be followed by the same number /VISIBLE1:1 /COLORID1:10 etc.
    In this way we can add next layers to change - /LAYER2:EPLAN110 /VISIBLE2:1 /COLORID2:55 (...) /LAYER15:EPLAN200 /TEXTHEIGHT15:3.75. Please look at the example.
    

    Example
            changelayer /LAYER:EPLAN100 /VISIBLE:1 /PRINTED:1 /TEXTHEIGHT:2.75 /COLORID:1 
            changelayer /PROJECTNAME:C:\Projects\EPLAN\ESS_Sample_Project.elk /LAYER:EPLAN200 /VISIBLE:1 /PRINTED:0 /TEXTHEIGHT:5.5 /COLORID:15 
            changelayer /LAYER:560 /VISIBLE:1 /COLORID:9 /TRANSPARENCY:0.1
            changelayer /LAYER1:110 /VISIBLE1:1 /PRINTED1:1 /TEXTHEIGHT1:5 /COLORID1:1 /LAYER2:300 /VISIBLE2:1 /PRINTED2:1 /TEXTHEIGHT2:6 /COLORID2:11