<doc>
  <legacy_id>1092</legacy_id>
  <name>gRevAppIcon</name>
  <type>keyword</type>
  <syntax>
  </syntax>
  <library></library>
  <objects>
  </objects>
  <synonyms>
  </synonyms>
  <classification>
    <category>Windows &amp; Dialog Boxes</category>
  </classification>
  <references>
    <command tag="ask">ask Command</command>
    <command tag="answer">answer Command</command>
    <keyword tag="gRevSmallAppIcon">gRevSmallAppIcon Keyword</keyword>
  </references>
  <history>
    <introduced version="2.0">Added.</introduced>
  </history>
  <platforms>
    <mac/>
  </platforms>
  <classes>
    <desktop/>
    <server/>
    <web/>
  </classes>
  <security>
  </security>
  <summary>A special <glossary tag="global">global variable</glossary> that specifies the application icon to be used on <glossary tag="OS X">OS X systems</glossary> with the <command tag="ask">ask</command>, <command tag="ask password">ask password</command>, and <command tag="answer">answer</command> <glossary tag="command">commands</glossary>.</summary>
  <examples>
    <example>global gRevAppIcon</example>
    <example>put the short ID of image "Icon" into gRevAppIcon</example>
  </examples>
  <description>
    <p>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 <b>gRevAppIcon</b> <glossary tag="keyword">keyword</glossary> to specify which <keyword tag="image">image</keyword> to use for the icon.</p><p/><p><b>Comments:</b></p><p>In the LiveCode development environment, when running on an OS X system, the LiveCode icon is displayed in the <b>ask</b>, <command tag="ask password">ask password</command>, and <command tag="answer">answer</command> <glossary tag="dialog box">dialog boxes</glossary>. In your own applications, however, the <glossary tag="application">application's</glossary> icon should appear instead.</p><p/><p>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.)</p><p/><p><code/><b>Note:</b><code/> The standard size for the application icon is 64x64 <property tag="pixels">pixels</property>.</p><p/><p>Make a note of the image's <b>ID</b>. Then, in your application, put the ID number into the <keyword tag="gRevAppIcon">gRevAppIcon</keyword> <glossary tag="global">global variable</glossary>. For example, if the <keyword tag="image">image</keyword> <property tag="ID">ID</property> is 3445, you can place the following <glossary tag="statement">statements</glossary> in your <glossary tag="application">application's</glossary> <message tag="startup">startup</message> <glossary tag="handler">handler</glossary>:</p><p/><p><code>  global gRevAppIcon</code></p><p><code>  put "3445" into gRevAppIcon</code></p><p/><p>Thereafter, the <b>ask</b>, <command tag="ask password">ask password</command>, and <command tag="answer">answer</command> <glossary tag="command">commands</glossary> will use the <keyword tag="image">image</keyword> you specified.</p><p/><p><code/><b>Note:</b><code/> If you specify an <i>iconType</i> in the <command tag="answer">answer</command>, <command tag="ask">ask</command>, or <command tag="ask password">ask password</command> <glossary tag="command">command</glossary>, the image specified by the <keyword tag="gRevSmallAppIcon">gRevSmallAppIcon</keyword> <glossary tag="variable">variable</glossary> appears instead, along with the standard icon specified by the <i>iconType</i>.</p><p/>
  </description>
</doc>