<doc>
  <legacy_id>2038</legacy_id>
  <name>autoHilite</name>
  <type>property</type>
  <syntax>
    <example>set the autoHilite of {<i>button</i> |<i> field</i>} to {true | false}</example>
  </syntax>
  <library></library>
  <objects>
    <button/>
  </objects>
  <synonyms>
    <synonym>autoHilight</synonym>
  </synonyms>
  <classification>
    <category>User Interaction</category>
    <category>Appearance &amp; Positioning</category>
  </classification>
  <references>
    <command tag="hilite">hilite Command</command>
    <property tag="hilitedButtonName">hilitedButtonName Property</property>
    <property tag="listBehavior">listBehavior Property</property>
    <property tag="showHilite">showHilite Property</property>
  </references>
  <history>
    <introduced version="1.0">Added.</introduced>
  </history>
  <platforms>
    <mac/>
    <windows/>
    <linux/>
    <ios/>
    <android/>
  </platforms>
  <classes>
    <desktop/>
    <server/>
    <web/>
    <mobile/>
  </classes>
  <security>
  </security>
  <summary>Specifies whether a <keyword tag="button">button</keyword> <glossary tag="highlight">highlights</glossary> when it's pressed, or whether <property tag="selected">selected</property> text in a <keyword tag="field">field</keyword> is <property tag="hilite">highlighted</property>.</summary>
  <examples>
    <example>set the autoHilite of last button to false</example>
    <example>if the autoHilite of me is false then beep</example>
  </examples>
  <description>
    <p>Use the <b>autoHilite</b> <glossary tag="property">property</glossary> to give visual feedback to users when they click a <keyword tag="field">field</keyword> or <keyword tag="button">button</keyword>.</p><p/><p><b>Value:</b></p><p>The <b>autoHilite</b> of a <keyword tag="button">button</keyword> or <keyword tag="field">field</keyword> is true or false.</p><p/><p><b>Comments:</b></p><p>If a button's <b>autoHilite</b> <glossary tag="property">property</glossary> is true, clicking it changes its appearance. This provides visual feedback to the user. (The exact change in appearance depends on the <property tag="style">style</property> <glossary tag="property">property</glossary> of the <keyword tag="button">button</keyword> and on the current setting of the <property tag="lookAndFeel">lookAndFeel</property> <glossary tag="property">property</glossary>.)</p><p/><p>The button remains highlighted while the mouse is within it and the mouse button is down. If the user moves the mouse outside the button while keeping the mouse button depressed, the button becomes unhighlighted.  If the user then moves the mouse back over the button, the button becomes highlighted again.</p><p/><p>While the button is highlighted, its <b>hilite</b> <glossary tag="property">property</glossary> is also set to true.</p><p/><p>If the button's <b>style</b> <glossary tag="property">property</glossary> is "checkbox" or "radioButton", clicking it turns the control on or off. If the <glossary tag="button">button's</glossary> <property tag="style">style</property> is menu, the <b>autoHilite</b> has no effect.</p><p/><p>If a field's <b>autoHilite</b> <glossary tag="property">property</glossary> is true, the user can move the text <keyword tag="selection">selection</keyword> by clicking in the <keyword tag="field">field</keyword>, and text <property tag="selected">selected</property> with the <command tag="select">select</command> <glossary tag="command">command</glossary> is highlighted. If the <glossary tag="field">field's</glossary> <b>autoHilite</b> is false, user actions cannot change the <keyword tag="selection">selection</keyword> or place the <glossary tag="insertion point">insertion point</glossary> in the <keyword tag="field">field</keyword> by clicking, although a <glossary tag="handler">handler</glossary> can do so with the <command tag="select">select</command> <glossary tag="command">command</glossary> and the user can do so with the arrow keys.</p><p/><p>If a field whose <b>listBehavior</b> <glossary tag="property">property</glossary> is true also has its <b>autoHilite</b> <glossary tag="property">property</glossary> set to false, list behavior does not work for the field, and a clicked line does not <property tag="hilite">highlight</property>.</p>
  </description>
</doc>