filter-strings ("fs")

See this command in the command table.

To access this command:

  • Format ribbon > Filter > Strings.

  • Using the command line, enter "filter-strings" and press ENTER.

  • Use the quick key combination "fs".

  • Display the Find Command screen, locate filter-strings and click Run.

Command Overview

Filter all visible strings overlays.

This command makes it possible to selectively  display and work with strings using a filter expression. As soon as the command is invoked any previously set string filters is removed.

It is advisable not to use coordinate data in the expressions but to use attribute fields. If any one point in a string fails to pass, then this string is "turned off".

Existing filters can be removed by running this command without any filters. The redraw-display command will display all the data.

For more information on filtering data, click here.

Command steps:

  1. Run the command.

    The Expression Builder displays.

  2. Enter or construct a valid filter expression. See Filtering Data.

  3. Click OK.

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("filter-strings 'AU>1.0' '$'";

Where:

  • 'AU>1.0' is the filterExpressionToken(s): one or more argument tokens parsed and concatenated into the filter expression string.

  • '$' is the '$': a terminator token that can be used to end expression parsing explicitly.

Parameters Table

Parameter Description Reqd? Example Syntax
filterExpressionToken(s)

One or more argument tokens parsed and concatenated into the filter expression string.

 Y 'AU>1.0'
'$'

A terminator token that can be used to end expression parsing explicitly.

 Y '$'

Related topics and activities: