ADD_ACTIVE_ATTRIBUTE
Add an attribute to the Active attributes pane.
Parameters
| Parameter number | Description | Values | Optional |
|---|---|---|---|
| 1 | Field name | String | No |
| 2 | Value type to store | 0. String 1. Signed byte 2. Unsigned byte 3. Signed short integer 4. Unsigned short integer 5. Signed integer 6. Unsigned integer 7. Signed 64-bit integer 8. Unsigned 64-bit integer 9. Single-precision floating point 10. Double-precision floating point 11. Date If omitted, the field is a string. |
Yes |
| 3 | Value to assign | A value compatible with the type, or the name of a database macro | Yes |
Examples
delete_active_attributes
add_active_attribute=Nombre
add_active_attribute=Edad 2
add_active_attribute=Escala 4 1000
add_active_attribute=Altura 9 %ENTITY_FIRST_VERTEX_Z%
Notes
Use this command to set, in the Active attributes pane, the attributes to store when drawing a new entity.
Without parameters, the command displays an error message and adds nothing. If the field already exists in the pane, the command replaces its type and value. If the value is omitted, the field takes the empty or zero value of the specified type.
If the value is not a macro, the command converts it to the specified type. Accepted formats do not depend on Windows regional settings:
- Integers: digits only, with an optional sign (
1000,-5). - Real numbers: decimal point and optional exponent (
12.5,1e3). Commas are not accepted. - Dates: year-month-day, with an optional time (
2026-10-03,2026-10-03 14:30).
If the value does not match that format or is outside the type's range, such as -1 for an unsigned integer, the command displays an error message and does not add the field.
If you enter a database macro as the value, the program displays the macro name in the Active attributes pane and makes the field read-only. When storing the entity, the program stores the value calculated by the database macro.
Of the macros with parameters, %ENTITY_ATTRIBUTE=nombre% is supported; it retrieves the value of the entity's nombre attribute. %CENTROID_VALUE=…% is not supported: it only has a value when exporting topologies.
Command characteristics
| Command type | Immediate command |
|---|---|
| Repeats automatically | No |
| Menu option | This command has no associated menu option |
| Toolbar | This command has no associated toolbar button |
| Extension | DigiNG.OrdenesStandard.dll |
| Implementation | Native |
| Related variables | No related variables |
| Related commands | ASSIGN_ATTRIBUTE DELETE_ACTIVE_ATTRIBUTES RESET_BBDD_ATTRIBUTES |
| Internal name |