Searching user-defined macro locations
Users may define up to three macro locations, called user libraries. In many cases, such as when the user is selecting a macro to play, the user selects both the specific user location and macro name. But there are a few cases, listed below, where all of the user libraries are searched, looking for the given macro name. In these cases, the user libraries will be searched in their then-current order, and the first macro name match that is found will be used. Because the order of the user libraries can change, it is important in these situations that the macro name be unique across all of the user libraries, to ensure that the correct macro is found.
Below is a list of the situations in which a macro name is searched across all of the user locations:
- A key is pressed which has been assigned to run a macro located in a user library. When the user initially assigns the key to a macro, the key binding is to the macro name in a user location, but not to the specific directory path of the user library. Therefore, when the user subsequently presses the assigned key, all user locations are searched for the given macro name.
- A toolbar button is clicked, which is configured to run a macro located in a user library. Like the key binding in #1 above, the toolbar button is associated with a macro name in a user location, but not to a specific user location path. Therefore, when the user clicks the button, all user locations will be searched for the given macro name.
- A poppad button is clicked which has been assigned to run a macro in a user library. This situation is identical to the key assignment case in #1 above, and all user locations will be searched for the given macro name.
- A session is launched which is configured to autostart a macro. This situation is slightly different than the three described above, in that all macro locations are searched, not just the user locations. When an autostart macro is configured, only the macro name is configured. So when it is time to run the macro, there is no associated location information, and so all locations are searched. See Auto-Start options for more information.