evaluator:applicable_contexts:functions:tooltips

You can use the evaluator to generatge the tooltip for a toolbar button dynamically.

Unlike Evaluator Button Icons and Evaluator Button Labels, there's no @ modifier for tooltips - instead, you enter a = character followed by the evaluation expression, directly into the tooltip field in the button editor.

A number of variables are available to the evaluator in this context. Note that some are only applicable to toolbars in the standalone image viewer, and some only apply to Lister toolbars.

Variable Type Description

dest

path

The current destination path.

dest_shell

bool

True if the destination is a shell (virtual) folder hosted by Explorer, otherwise false.

expanded

uint

Returns the number of expanded directories.

fullscreen

bool

Viewer only. True if the viewer is fullscreen, otherwise false.

key_repeat

bool

True if the function was launched from a repeated key press (i.e. the key was held down).

seldirs

uint

Returns the number of selected directories.

selfiles

uint

Returns the number of selected files.

selimage

bool

Viewer only. True if an area of the image has been selected, false otherwise.

selitems

uint

Returns the total number of selected items.

source

path

The current source path.

source_shell

bool

True if the source is a shell (virtual) folder hosted by Explorer, otherwise false.

totaldirs

uint

Returns the total number of directories.

totalfiles

uint

Returns the total number of files.

totalitems

uint

Returns the total number of items.

viewmode

str

Returns the current view mode in the file display. Values are largeicons, smallicons, list, details, power, thumbnails and tiles.

As well as the above variables, you can also use evaluator functions like IsChecked and IsEnabled to query other information about the state of the Lister.

The return value from the evaluation expression will be used as the tooltip for the button.