icon | ||||||||||
Type | property | |||||||||
Dictionary | LCS | |||||||||
Library | LiveCode Script | |||||||||
Syntax |
| |||||||||
Summary | Specifies an image that is displayed in a button, or used as the desktop icon of a stack file or application. | |||||||||
Introduced | 1.0 | |||||||||
Changes | The order in which LiveCode searches for icons was changed in version 3.5. Previously, the current stack was searched first, followed by the list of open stacks. | |||||||||
OS | mac, windows, linux, ios, android | |||||||||
Platforms | desktop, server, mobile | |||||||||
Parameters |
| |||||||||
Example |
| |||||||||
Values |
| |||||||||
Related | Property: visitedIcon, hilitedIcon, icon, behavior, armedIcon, disabledIcon Message: iconifyStack Keyword: default, image, button Glossary: property, OS X, global, stack file, dock, desktop, Windows, Mac OS, Unix, iconify, application Function: stacks Command: global Object: stack, button | |||||||||
Description | Use the icon property to change a button's appearance, or to set the icon used for a stack or application in the OS X dock. LiveCode looks for the specified image in the following order:
If a button has been clicked during the current session and its visitedIcon property is set, its visitedIcon is displayed instead of its icon. If the button is disabled and its disabledIcon property is set, its disabledIcon is displayed instead of its icon. *Cross-platform note:* On OS X systems, a stack's icon is displayed in the dock when the stack is minimized. On Unix systems, the stack's icon is displayed on the desktop when the stack is iconified. Setting a stack's icon property has no effect on Mac OS and Windows systems. *Cross-platform note:* On OS X systems, the global icon property specifies the current application's dock (glossary) icon. The engine will attempt to find an image with the given id, resize it to 128x128 and then set it as the dock icon for the application. The setting of the global icon property has no effect on Mac OS, Unix, or Windows systems.
The ability to specify an icon for an application or stack file on OS X systems was added in version 2.1. In previous versions, the icon was a button and stack property but not a globalproperty, and the icon of a stack had no effect on OS Xsystems. | |||||||||
Tags | file system |