gRevSmallAppIcon

A special global that specifies the small application icon to be used on OS X with the ask, ask password, and answer commands.

# Metadata

Platforms: desktop, server OS: mac Introduced: 2.0 Security:

# Syntax

gRevSmallAppIcon

# Examples

global gRevSmallAppIcon

put 8799 into gRevSmallAppIcon

# Description

According to Aqua user-interface standards, the application's icon should appear in modal dialog boxes to identify which application the dialog box belongs to. Use the gRevSmallAppIcon keyword to specify which image to use for the icon.

In the LiveCode development environment, when running on an OS X system, the LiveCode icon is displayed in the ask, ask password, and answer dialog box. In your own applications, however, the application icon should appear instead. (This icon is specified by the gRevAppIcon keyword.)

If you specify an iconType (information, question, error, or warning) with the answer, ask, or ask password command, the standard icon for that type of dialog box appears instead, "badged" with a small version of your application's icon. You specify that small icon in the gRevSmallAppIcon variable.

To make the correct icon appear, create an image in one of your application's stacks. (The image does not need to be visible, and the stack window it's in does not need to be open. The stack file needs only to be loaded into memory for the application to be able to use the image.)

>*Note:* The standard size for the small application icon is 32x32 > pixels.

Make a note of the image's ID. Then, in your application, put the ID number into the gRevSmallAppIcon global. For example, if the image ID is 3446, you can place the following statements in your application startup handler :

global gRevSmallAppIcon put "3446" into gRevSmallAppIcon

Thereafter, the answer, ask, and ask password commands will use the image you specified.

# Tags

# See

- **keyword:** image, gRevAppIcon - **property:** pixels, ID - **message:** startup - **command:** answer, ask, ask password - **glossary:** dialog box, OS X, global, handler, statement, keyword, command, application