RENAMCOD_SEL

Replace one code with another on the entities you select.

Parameters

Parameter number Description Optional
1 Code to replace Yes
2 New code Yes

Notes

Codes

Without parameters, the command displays the Replace code on selected entities dialog box immediately, before any entities are selected:

Replace code on selected entities dialog box

Field Description
Replace code Code to replace
To this code New code

The dialog box does not suggest any codes: both fields are empty. Accept is disabled while either field is empty. Click Cancel to end the command without changes.

If you supply both parameters, the command skips the dialog box. If you supply only one, it sounds an error tone and ends. Parameters after the second are ignored.

Both codes support * and ? wildcards. The new code is combined, position by position, with each matching code on the entity, as in RENAMCOD:

  • A character in the new code replaces the character at that position in the entity's code.
  • ? retains the character from the entity's code.
  • * retains the rest of the entity's code.

If the new code is not in the code table, the command assigns it anyway.

Select entities

After the dialog box, or immediately if you supplied parameters, the command line displays Select an entity or entities to rename their codes. The command does not use entities selected before it was run.

  • Single selection: select an entity with the data or snap pedal. The command runs SNAP with the string LPTBGH*@, which selects lines, points, texts, images, complex entities, and polygons from the active drawing file. If the entity does not belong to the active drawing file, the command sounds an error tone and continues waiting.
  • Multiple selection: use a multiple selection command, such as SELECT_WINDOW. The command ignores deleted entities and those outside the active drawing file.

Change codes

For each selected entity, the command replaces all codes matching the code to replace. Entities without that code do not change. The command marks each modified entity as deleted and adds a copy with the new codes.

The new code does not retain the replaced code's database attributes. RENAMCOD's DB attributes of the target code setting does not affect this command.

The command ends after processing the first selection, even if no entity had the code. UNDO undoes the change.

If you supply parameters and REPEAT is enabled, the command repeats with the same codes. If you specify codes in the dialog box, the command does not repeat.

Each entity is handled independently: if Digi3D.AI rejects an entity with the new code, the corresponding original entity is preserved unchanged; new codes are assigned to entities whose changes are accepted.

Command characteristics

Command type Interactive command
Repeats automatically Only when parameters are supplied
Menu option Edit/Rename one code of the selected entities...
Toolbar This command has no associated toolbar button
Extension DigiNG.OrdenesStandard.dll
Implementation Native
Related variables REPEAT — repeat the last command executed
Related commands RENAMCOD
RENAMCOD_E
UNDO
Internal name