evaluator:applicable_contexts:evaluator_columns

The Evaluator Columns Preferences page lets you create columns that generate their contents using the evaluator.

When the column is displayed, the evaluation expression is invoked once per file or folder. In this evaluation context, the following variables are available:

Variable Type Description

column name

varies

All the column keywords are available as variables in this evaluation context.

Note that some keywords may use characters like a : that aren't valid in variable names - to access them, use the Val function.

file_name

string

Returns the full name of the file the column is being invoked for. This may be different from file which (as a column keyword), returns the value of the Name column (which e.g. may have file extensions hidden).

is_dir

bool

True if the expression is being run for a folder, false if it's being run for a file.

operation

string

Returns "sort" if the column is being used for sorting (in case you want to control the sort order). Returns "group" if the column is being used for grouping (the Custom grouping option must be enabled in the column definition). Otherwise returns "display".

The return value from the evaluation expression will be used as the data for the column. The way this value is shown in the column depends on the Type setting in the column definition.

Columns can control their sort order by returning a different value when they're being called to establish sort order. For example, your column might want to sort in proper date order (e.g. based on the modifieddate column) but return a text string for display. The operation value will be set to "sort" when the evaluation is being used for sorting.

Columns can also choose their default groups if the Custom grouping option is turned on in the column definition. The operation value will be set to "group" and you should return the name of the group you want the item placed in.

Context-specific functions

The evaluator has one functions that is specific to this context.

HasLabel

The expression can call the HasLabel() function to test if the current file or folder has a particular label assigned to it.

For example, if (HasLabel("green")) { ... }.