<doc>
  <legacy_id>1352</legacy_id>
  <name>listBehavior</name>
  <type>property</type>
  <syntax>
    <example>set the listBehavior of <i>field</i> to {true | false}</example>
  </syntax>
  <library></library>
  <objects>
    <field/>
  </objects>
  <synonyms>
    <synonym>autoSelect</synonym>
  </synonyms>
  <classification>
    <category>User Interaction</category>
  </classification>
  <references>
    <property tag="threeDHilite">threeDHilite Property</property>
    <property tag="dontWrap">dontWrap Property</property>
    <property tag="lockText">lockText Property</property>
    <property tag="autoHilite">autoHilite Property</property>
    <property tag="hilitedLine">hilitedLine Property</property>
    <property tag="multipleLines">multipleLines Property</property>
    <property tag="toggleHilites">toggleHilites Property</property>
    <property tag="noncontiguousHilites">noncontiguousHilites 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 <property tag="lockLocation">locked</property> <keyword tag="field">field</keyword> behaves as a <glossary tag="list field">clickable list</glossary>.</summary>
  <examples>
    <example>set the listBehavior of field "Items List" to true</example>
    <example>if the listBehavior of me then mouseUp</example>
  </examples>
  <description>
    <p>Use the <b>listBehavior</b> <glossary tag="property">property</glossary> to create a list box.</p><p/><p><b>Value:</b></p><p>The <b>listBehavior</b> of a <keyword tag="field">field</keyword> is true or false.</p><p/><p>By default, the <b>listBehavior</b> <glossary tag="property">property</glossary> of newly created <glossary tag="field">fields</glossary> is set to false.</p><p/><p><b>Comments:</b></p><p>If a field's <b>listBehavior</b> <glossary tag="property">property</glossary> is set to true, and the user clicks a line, the entire line is <property tag="hilite">highlighted</property>. The Up and Down arrow keys move the <keyword tag="selection">selection</keyword> up or down.</p><p/><p>Normally, the <b>mouseUp</b> and <message tag="mouseDown">mouseDown</message> <glossary tag="message">messages</glossary> are sent to the <keyword tag="field">field</keyword> as usual. However, if the user clicks below the last line of text in the <keyword tag="field">field</keyword>, a <message tag="mouseRelease">mouseRelease</message> <keyword tag="message box">message</keyword> is sent instead of <message tag="mouseUp">mouseUp</message>.</p><p/><p>You use the <b>hilitedLine</b> <glossary tag="property">property</glossary> to determine which <keyword tag="line">line</keyword> the user clicked. The <glossary tag="field">field's</glossary> <property tag="hilitedLine">hilitedLine</property> is set to the new <keyword tag="line">line</keyword> before the <message tag="mouseDown">mouseDown</message> message is sent, so there is no way to determine the previously-selected <keyword tag="line">line</keyword>.</p><p/><p>If the field's <b>autoHilite</b> <glossary tag="property">property</glossary> is set to false, a clicked line does not <property tag="hilite">highlight</property>, regardless of the <property tag="listBehavior">listBehavior</property> setting; the <keyword tag="field">field</keyword> does not behave like a <glossary tag="list field">clickable list</glossary> in this case. However, you can set the <property tag="hilitedLine">hilitedLine</property> of the field even if the <glossary tag="field">field's</glossary> <property tag="autoHilite">autoHilite</property> is false.</p><p/><p><b>Note:</b> Setting the <b>listBehavior</b> of a field to true will automatically set the field's <property tag="dontWrap">dontWrap property</property> to true, as a list field cannot have text wrapping. Setting the <b>dontWrap</b> of a list field to false has no effect.</p><p/>
  </description>
</doc>