erase-string ("ers")

See this command in the command table.

To access this command:

  • Home ribbon > Unload > Strings.

  • Data ribbon > Unload > Strings.

  • Draw (Sketches) ribbon > Edit > Delete Strings.

  • Using the command line, enter "erase-string" and press ENTER.

  • Use the quick key combination "ers".

  • Display the Find Command screen, locate erase-string and click Run.

Command Overview

Erase (delete) string(s) from memory. If string data is preselected, it is deleted when the command is run (after confirmation), otherwise, string data can be picked interactively after running the command.

Note: physical string file data is not affected by the command until the data object is saved.

Command steps:

  1. Optionally, preselect string data in a 3D window.

  2. Run the command.

  3. If no string was selected before running the command, select individual (left or right-click) or drag a selection box over multiple strings.

  4. Click Done to complete the command.

Command Automation

You can automate by passing this command and parameters into oDmApp.ParseCommand(), using any COM-aware scripting language.

Note: For more information on scripting in Studio NPVS+, please refer to your Scripting Tutorial (Help > Scripting Tutorial).

Example Parameter String (JS):

oDmApp.ParseCommand("erase-string @point=100.0,200.0,0.0,1 'yes'";

Where:

  • @point=100.0,200.0,0.0,1 is the ParsePointArguments: X,Y,Z,nButton.

  • 'yes' is the confirmToken: a string value and expects yes or no (quoted and unquoted variants are accepted in different delete paths).

Parameters Table

Parameter Description Reqd? Example Syntax
ParsePointArguments

X,Y,Z,nButton.

  • X is a numeric (double) world coordinate value.

  • Y is a numeric (double) world coordinate value.

  • Z is a numeric (double) world coordinate value.

  • nButton is an integer value parsed as part of @point input. Enumerated types are:

    • 1: Left mouse button behaviour

    • 2: Middle mouse button behaviour

    • 4: Right mouse button behaviour

 Y @point=100.0,200.0,0.0,1
confirmToken

A string value and expects yes or no (quoted and unquoted variants are accepted in different delete paths).

 Y 'yes'

Related topics and activities