Command for numbering wires. On account of the complexity of the wire numbering function with more than 20 available setting possibilities per numbering type, the Settings dialog available in EPLAN should be preferably used. The command allows for taking over the default settings from configurations, with a configuration consisting of a list of properties with the associated values.
In order to be able to use the command sensibly, the configuration should be determined first; then the individual values can easily be overwritten.
setParam(....,EPL_PARAM_WN_CONFIGNAME,"<enter configuration_name here>") //and then determine the deviating values: e.g.: setParam(....,EPL_PARAM_CHARSET,"01"); // number in the dual system... |
All parameters have the prefix "EPL_PARAM_WN_".
ParameterID | Type | Description |
---|---|---|
PROJECT | [IN] EplHandle |
Name of the project whose wires are to be numbered. |
CONFIGNAME | [IN] String |
Name of the configuration to be used as template. |
FORCECOUNTER | [IN, OPTIONAL] String |
Use counter on/off. |
USEIOADRESS | [IN, OPTIONAL] String |
Use PLC I/O addresses. |
XREFFORMAT | [IN, OPTIONAL] String |
Format string (property user is wire). |
DOOVERWRITE | [IN, OPTIONAL] String |
Overwrite mode on/off. |
DOUSEDET | [IN, OPTIONAL] String |
Use preferably device-end terminals. |
GKLEMMFORMAT | [IN, OPTIONAL] String |
Transfer format of GE terminals (default "" is ok!). |
DOHOLDNAM | [IN, OPTIONAL] String |
Compatibility to 2.15 (do not use). |
DOHIDEMULTI | [IN, OPTIONAL] String |
Display wiring text only on unique wires. |
PREFIX | [IN, OPTIONAL] String |
Prefix (format string and/or text. Property user is connection "From"). |
POSTFIX | [IN, OPTIONAL] String |
Postfix(format string and/or text. Property user is connection "To"). |
STARTNUMBER | [IN, OPTIONAL] Integer |
Start number. |
INCREMENT | [IN, OPTIONAL] Integer |
Increment value. |
ANZAHLSTELLEN | [IN, OPTIONAL] Integer |
Number of characters to be used. |
NUMBERPOTENTIAL | [IN, OPTIONAL] String |
Potential-based numbering on/off. |
FORMATFROMSOURCE | [IN, OPTIONAL] String |
Format string for "From." |
FORMATFROMDESTINATION | [IN, OPTIONAL] String |
Format string for "To." |
FORMATFROMPOTENTIAL | [IN, OPTIONAL] String |
Format string from potential. |
FORMATFROMPOSITION | [IN, OPTIONAL] String |
Format string from position (wiring position). |
ALPHANUMERICCOUNTER | [IN, OPTIONAL] String |
Use alphanumeric counter. |
TXTONLYONCEPERWIRE | [IN, OPTIONAL] String |
Display texts only once per wire. |
SEP | [IN, OPTIONAL] String |
Separating character between name and counter. |
CHARSET | [IN, OPTIONAL] String |
Character set for the numbering (example: 01 for binary 0123456789ABCDEF for hexadecimal). |
MARKASMANUALSET | [IN, OPTIONAL] String |
Mark as manually set. |
If no new configuration name is entered, EPL_ERROR is returned.