This function appends the search path for dialog files that can be called from a custom application, such as one that uses the AOM Application.createDialogFromFile method (documented in the Programmer's Reference. The append_dialogs_path function appends dir to the directories specified by the set dialogspath command. If the optional prepend argument is specified and non-zero, dir is added to the beginning of the path list, removing any later occurrence of the directory. If prepend is zero or omitted and if dir is already present in the path list, the path list is returned.

For example, if you want to append your dialog file directory stored in the mydialogs subdirectory of the company directory, so your dialog file path is searched last:

If you want to prepend your dialog files directory, so your dialog file path is searched first:

If there is an Arbortext-path\custom\dialogs subdirectory at startup, the custom\dialogs path is automatically prepended to the path for dialog files. Putting your custom dialog files in the custom\dialogs subdirectory makes them automatically available, avoiding manual steps to add them to the path.