evaluator:applicable_contexts:rename_control_keys

The Control Keys Preferences page lets you define Ctrl key sequences for inline rename that use the evaluator to select, replace or delete text, or to move the cursor.

The evaluation expression is called every time its defined key is pressed.

In this evaluation context, the following variables are available:

Variable Type Description

dir

bool

True if the item being renamed is a directory, false for a file.

exthidden

bool

True if the filename extension is currently hidden.

is_dir

bool

True if the item being renamed is a directory, false for a file (same as dir).

file_name

string

Original name of the file.

name

str

Original name of the file.

nameext

str

Original filename extension of the file.

namestem

str

Original filename stem (i.e. without the extension).

path

path

Path the file is located in (does not include the filename).

selend

int

Current selection range end position.

selstart

int

Current selection range start position.

valext

str

Filename extension of the current value in the edit field.

valstem

str

Filename stem of the current value in the edit field.

valleft

str

The part of the current value to the left of the current selection range.

valright

str

The part of the current value to the right of the current selection range.

valsel

str

The part of the current value that is currently selected.

value

str

The current value in the edit field.

The evaluation expression can return a string to update the value in the edit field.

It can also modify the selection range by changing the values of the selstart and selend variables.

To update the selection range without changing the contents of the string, simply return true instead of a string.

It can also return false if it doesn't want to make any changes to the value or selection.

Context-specific functions

The evaluator has two functions that are specific to this context.

RestoreExt

The expression can call the RestoreExt() function to reveal the filename extension if its currently hidden from the edit field (i.e. if exthidden is true).

ShowTips

The expression can call the ShowTips() function to show a tooltip as a "cheatsheat" of all rename control keys. By default the rename field shows this if you hold down the Ctrl key - this function lets you assign your own key sequence to display the tooltip.