Toolbar Buttons > Button Edition: Commands

The commands for toolbar buttons can be any predetermined macro, the name of a file to be opened inside the ebook, a program to be run or an Internet address.
By default the buttons are linked to macros in order to perform standard actions like find, close, print, etc.
When you select a Standard Button from the list, both a macro and its corresponding image will be selected for the button, but you can write your own button command as well.

How button Commands work

When an Ebook button is clicked, the command linked to that button will be evaluated in the following order:

Evaluation Order Action

Macros

Compares the command with the list of supported macros, if the command is a macro, the Ebook will perform it right away, but it the command doesn't match any macro the Ebook then will evaluate the other options.

Links pointing to an Internet Address (starting with http or https)

The default Internet Browse will open the URL.

HTML, Only Text or supported image files

The file will opened by the Ebook. If an internal file is not found and an external one is in the Ebook directory it will be used.

The file will be loaded in Ebook the Main Frame if the Ebook uses frames and the Main Frame is set.

Any other kind of command

The command will be executed. If points to a file inside the ebook, it will be decompressed to a temporary location before executing or opening it.
When executing files associated with other programs (like PDF documents are associated with Acrobat and DOC documents with Word), the related program will be used to open the file.

If the file is an executable it will be executed as well.

If the executable file is an external file (not included inside the Ebook) and it is in the search path it can be executed without problems. Otherwise it should be located in the same folder than the Ebook or in the place indicated by the its path, if any.

Since it is not possible to know disk drivers letters before compiling the ebook, using fixed paths is not advisable, unless you know well what you are doing.

Evaluation Order	Action
Macros	Compares the command with the list of supported macros, if the command is a macro, the Ebook will perform it right away, but it the command doesn't match any macro the Ebook then will evaluate the other options.
Links pointing to an Internet Address (starting with http or https)	The default Internet Browse will open the URL.
HTML, Only Text or supported image files	The file will opened by the Ebook. If an internal file is not found and an external one is in the Ebook directory it will be used. The file will be loaded in Ebook the Main Frame if the Ebook uses frames and the Main Frame is set.
Any other kind of command	The command will be executed. If points to a file inside the ebook, it will be decompressed to a temporary location before executing or opening it. When executing files associated with other programs (like PDF documents are associated with Acrobat and DOC documents with Word), the related program will be used to open the file. If the file is an executable it will be executed as well. If the executable file is an external file (not included inside the Ebook) and it is in the search path it can be executed without problems. Otherwise it should be located in the same folder than the Ebook or in the place indicated by the its path, if any. Since it is not possible to know disk drivers letters before compiling the ebook, using fixed paths is not advisable, unless you know well what you are doing.