This function is primarily intended to place artwork on the icon of the folder containing a file or a file's parent folder. Note that the default artwork item is used (the first artwork item in a file). Regardless as to the number of files selected, the operation is performed at most once per folder.
The statement can also be used to place artwork on the icon of any file or folder. When Specified path is selected, you can specify the full path of any file system item. The function is only performed once and if running stepwise, the first file's default artwork item is used. The specified path may contain any of the escape sequences described in Escape Sequences.
To automatically issue a search request for missing artwork, select a search template. To automatically search for newer artwork if the existing artwork is smaller than a certain size, specify a size. 0 implies do not test. The search template can be chosen from the popup list or manually entered. The only reason to manually enter the template name is if you wish to specify the name at runtime. The template field may contain any of the escape sequences described in Escape Sequences.
When doing a size test the default method is to test if either of an artwork item's width or height is less than the specified size. If you wish the test to fail only if both the width and height are less than the specified size, select the w & h option.
If a search is issued, the action processing will be paused and the Action Pending dialog will be presented. If you find artwork you like, you can drag it in to the artwork tab and continue the action processing. Alternately, you can cancel the action step or skip the step. If the search was triggered due to the size option, remember to make any new artwork added the first in the list before you continue.
When issuing a search request, the specified folder option cannot be used and the Silent option is not available. When Silent is enabled, no errors are displayed and the action test state will be set to false if any errors occurred, otherwise true.
While implemented to be very efficient in stepwise mode, this function is valid in all execution contexts.
If you want to override the current Settings - Artwork - General - Round corners when saving to icons setting, you can do so via the Modify Application Settings statement.