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