<doc>
  <legacy_id>1731</legacy_id>
  <name>mnemonic</name>
  <type>property</type>
  <syntax>
    <example>set the mnemonic of <i>button</i> to <i>number</i></example>
  </syntax>
  <library></library>
  <objects>
    <button/>
  </objects>
  <synonyms>
  </synonyms>
  <classification>
    <category>User Interaction</category>
  </classification>
  <references>
    <property tag="acceleratorText">acceleratorText Property</property>
  </references>
  <history>
    <introduced version="1.0">Added.</introduced>
  </history>
  <platforms>
    <windows/>
    <ios/>
    <android/>
  </platforms>
  <classes>
    <desktop/>
    <server/>
    <web/>
    <mobile/>
  </classes>
  <security>
  </security>
  <summary>Specifies which <keyword tag="character">character</keyword> of a <glossary tag="button">button's</glossary> name can be used with the <glossary tag="Alt key">Alt key</glossary> to <glossary tag="trigger">trigger</glossary> the <keyword tag="button">button</keyword>.</summary>
  <examples>
    <example>set the mnemonic of button "Avant!" to 1 <code><i>-- uses the first letter, A</i></code></example>
  </examples>
  <description>
    <p>Use the <b>mnemonic</b> <glossary tag="property">property</glossary> to provide a keyboard substitute for clicking a button on <glossary tag="Windows">Windows systems</glossary>.</p><p/><p><b>Value:</b></p><p>The <b>mnemonic</b> of a <keyword tag="button">button</keyword> is a positive <keyword tag="integer">integer</keyword>. Zero indicates that there is no shortcut provided.</p><p/><p>By default, the <b>mnemonic</b> <glossary tag="property">property</glossary> of newly created <glossary tag="button">buttons</glossary> is set to zero.</p><p/><p><b>Comments:</b></p><p>The <b>mnemonic</b> is any number between 1 and the number of <keyword tag="characters">characters</keyword> in the <glossary tag="button">button's</glossary> name. The <keyword tag="character">character</keyword> at that position is underlined, and pressing the <glossary tag="Alt key">Alt key</glossary> with that <keyword tag="character">character</keyword> sends a <message tag="mouseUp">mouseUp</message> message to the <keyword tag="button">button</keyword>. If the <i>number</i> is zero, the <keyword tag="button">button</keyword> does not have an <glossary tag="Alt key">Alt key</glossary> equivalent.</p><p/><p>This property has no effect on Mac OS or Unix systems.</p>
  </description>
</doc>