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.
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.