findText.incremental parameter

Use the findText.incremental parameter to set or query whether the find dialog is in incremental find mode.

Availability

query command
set command
current parameter
default parameter
install parameter

Scope

findText.incremental is scoped to the current view.
current.findText.incremental is scoped to the current view.
default.findText.incremental is globally scoped.
install.findText.incremental is globally scoped.

Syntax

query findText.incremental
set findText.incremental [ default | on | off ]
query current.findText.incremental
query default.findText.incremental
set default.findText.incremental [ install | on | off ]
query install.findText.incremental 

Parameters

default If you specify the default parameter for the set findText.incremental command, the current view will use the value of default.findText.incremental to decide whether the find dialog is in incremental find mode.
on If you specify the on parameter for the set findText.incremental command, the find dialog will be in incremental find mode in the current view.  If you specify the on parameter for the set default.findText.incremental command, the find dialog will be in incremental find mode in all the views that have findText.incremental set to default.
off If you specify the off parameter for the set findText.incremental command, the find dialog will not be in incremental find mode in the current view.  If you specify the off parameter for the set default.findText.incremental command, the find dialog will not be in incremental find mode in all the views that have findText.incremental set to default.
install If you specify the install parameter for the set default.findText.incremental command, all views with findText.incremental set to default will use the value of install.findText.incremental to determine whether the find dialog should be searching incrementally.

Description

If you do not specify any of the parameters for the set findText.incremental command, default is assumed.  If you do not specify any of the parameters for the set default.findText.incremental command, install is assumed.

The query current.findText.incremental command returns on if, for the current view, the find dialog is in incremental find mode.  The query current.findText.incremental command returns off if, for the current view, the find dialog is not searching incrementally.

In incremental (or live) find mode, the editor finds the next occurrence of the text and updates the search result (cursor location, and emphasis or selection of the found text) when the find or find and replace dialog is brought up, after each change to the search text, and after each change to the find options.

Examples

query findText.incremental
set findText.incremental off
query current.findText.incremental
query default.findText.incremental
set default.findText.incremental on
query install.findText.incremental 

Related reference
findText command
query command
set command
current parameter
default parameter
install parameter