https://docs.dopus.com/ 2026-04-14T22:30:20+00:00 https://docs.dopus.com/ https://docs.dopus.com/lib/exe/fetch.php?media=logo.png text/html 2024-06-28T19:00:49+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=evaluator:applicable_contexts:functions:colors&rev=1719601249&do=diff In a toolbar or menu button, you can use the @color modifier to set the text and background colors of the button dynamically using the evaluator. As a very basic example, would set the text color to black and the background color to red. To specify separate colors for light and dark modes, you could use something like this: text/html 2025-12-01T06:53:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=evaluator:applicable_contexts:functions:commands&rev=1764572027&do=diff The evaluator can be used to generate entire command lines. There are two types of command lines it can generate. Executable commands When the function is run, the return value from the evaluation expression will be executed as if it had always been part of the function. text/html 2023-08-25T05:36:18+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=evaluator:applicable_contexts:functions:conditional_behavior&rev=1692941778&do=diff You can use the evaluator with the various @if and @ifset command modifiers to introduce simple conditional behavior in functions. Note that these modifiers can also be used without the evaluator, so to use the evaluator you must begin the expression with a character. A number of variables are available to the evaluator in this context. Note that some are only applicable to toolbars in the text/html 2023-08-25T05:31:26+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=evaluator:applicable_contexts:functions:dynamic_state&rev=1692941486&do=diff You can use the evaluator with the various command modifiers that affect the state of toolbar buttons: * @hideif / @showif - dynamically hide or show the button * @disableif / @enableif - dynamically disable or enable the button * @toggle - control whether the button appears checked/selected or unchecked/unselected text/html 2023-08-25T05:52:48+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=evaluator:applicable_contexts:functions:evaluation_clauses&rev=1692942768&do=diff The @eval and @evalalways command modifiers let you run evaluation expressions inline in your functions. The main purpose of this is to set variables that can then be used later on in the function by other modifiers like @if, @icon, @label etc. * Variables set via text/html 2026-03-14T02:26:49+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=evaluator:applicable_contexts:functions:functions&rev=1773455209&do=diff A function (button/hotkey) can be written entirely using the evaluator if desired. * An evaluator function can use the GetItems function to query for selected files/folders. * Dialogs can be displayed to query for basic information with the Dialog function. text/html 2023-08-25T05:19:17+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=evaluator:applicable_contexts:functions:icons&rev=1692940757&do=diff In a toolbar or menu button, you can use the @icon, @iconp and @icon! modifiers to set button icons dynamically using the evaluator. Note that these modifiers can also be used without the evaluator, so to use the evaluator you must begin the expression with a character. text/html 2024-07-25T05:41:23+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=evaluator:applicable_contexts:functions:insertion_code&rev=1721886083&do=diff You can insert the result of an evaluation expression into a command line using the insertion code. The expression can insert the value of a variable - for example, or perform a complicated calculation and return the value. A number of variables are available to the evaluator in this context. Note that some are only applicable to toolbars in the text/html 2024-06-11T06:20:07+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=evaluator:applicable_contexts:functions:labels&rev=1718086807&do=diff In a toolbar or menu button, you can use the @label modifier to set the button label dynamically using the evaluator. As a very basic example, would set the label to "Hello!". Spacer (with labels turned on) and Label fields can also use the evaluator; you don't need the text/html 2025-08-25T05:40:29+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=evaluator:applicable_contexts:functions:standard_variables&rev=1756100429&do=diff 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. pathboolTruefalseuintboolViewer onlyTruefalseboolTrueboolTrueboolTruestringboolTrue text/html 2023-08-25T05:19:33+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=evaluator:applicable_contexts:functions:tooltips&rev=1692940773&do=diff 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. text/html 2025-07-04T00:31:26+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=evaluator:applicable_contexts:functions:usequalkeys&rev=1751589086&do=diff You can use the evaluator to override the default behaviour of the command. Normally this auto-generates buttons that read a folder normally, in a dual display (with the key), in a new tab (with the key), or in a new Lister (with the key). The evaluator clause can return a string to replace the default arguments of the