# Artwork to Folder Icon

This function is used to place artwork on the icon of the folder containing a file, the file's parent folder or a specified folder's icon. 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. When saving to a specified folder, the operation is only performed once and if running stepwise, the first file's artwork is used. The folder field 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 Preferences - Artwork - Round corners when saving to icons setting, you can do so via the Preferences statement.