<doc>
  <legacy_id>2340</legacy_id>
  <name>traversalOn</name>
  <type>property</type>
  <syntax>
    <example>set the traversalOn of <i>object</i> to {true | false}</example>
  </syntax>
  <library></library>
  <objects>
  </objects>
  <synonyms>
  </synonyms>
  <classification>
    <category>User Interaction</category>
  </classification>
  <references>
    <command tag="focus">focus Command</command>
    <command tag="disable">disable Command</command>
    <property tag="allowInlineInput">allowInlineInput Property</property>
    <property tag="tabGroupBehavior">tabGroupBehavior 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="control">control</keyword> can become the <glossary tag="active control">active (focused) control</glossary>.</summary>
  <examples>
    <example>set the traversalOn of group "Arrows" to true</example>
    <example>set the traversalOn of button "Help" to false</example>
  </examples>
  <description>
    <p>Use the <b>traversalOn</b> <glossary tag="property">property</glossary> to control whether the user can tab or click into a <keyword tag="control">control</keyword>.</p><p/><p><b>Value:</b></p><p>A control's <b>traversalOn</b> <glossary tag="property">property</glossary> is true or false.</p><p/><p><b>Comments:</b></p><p>Setting a field's <b>traversalOn</b> to true enables the user to tab into or click in the <keyword tag="field">field</keyword> for editing (if the <glossary tag="field">field's</glossary> <property tag="lockText">lockText</property> <glossary tag="property">property</glossary> is false). If a <glossary tag="field">field's</glossary> <b>traversalOn </b>and <property tag="lockText">lockText</property> <property tag="properties">properties</property> are both set to true, the user can <command tag="select">select</command> text, but not change it, and can scroll within the <keyword tag="field">field</keyword> using the keyboard. If the <b>traversalOn</b> is true and the <property tag="lockText">lockText</property> is false, the <keyword tag="field">field</keyword> can be edited. If the <property tag="lockText">lockText</property> is true and the <b>traversalOn</b> is false, the user can neither <command tag="select">select</command> nor edit the <glossary tag="field">field's</glossary> text.</p><p/><p>If the <i>object</i> is a <command tag="group">group</command>, setting its <b>traversalOn</b> to true causes tabbing into the <command tag="group">group</command> to set the <command tag="focus">focus</command> to the first <keyword tag="control">control</keyword> in the <command tag="group">group</command>.</p><p/><p>If the <i>object</i> is a <keyword tag="control">control</keyword> other than a <command tag="group">group</command> or <keyword tag="field">field</keyword>, if its <b>traversalOn</b> is true, and if the <property tag="lookAndFeel">lookAndFeel</property> is set to "Motif" or "Windows 95", the user can tab to the <keyword tag="control">control</keyword>, then press Return or Enter to send a <message tag="mouseUp">mouseUp</message> <keyword tag="message box">message</keyword> to the <i>object</i>.</p><p/><p>If the <b>lookAndFeel</b> is set to "Motif", "Macintosh", or "Appearance Manager", the <glossary tag="active control">active (focused) control</glossary> is outlined, and the <keyword tag="control">control</keyword> receives any keystrokes and the <glossary tag="message">messages</glossary> associated with them. (The outline can be turned off by setting the <glossary tag="field">field's</glossary> <property tag="showFocusBorder">showFocusBorder</property> <glossary tag="property">property</glossary> to false.) If the <property tag="lookAndFeel">lookAndFeel</property> is set to "Windows 95", the <glossary tag="appearance">appearance</glossary> of a <glossary tag="focus">focused</glossary> <keyword tag="field">field</keyword> does not change, but it receives keystroke <glossary tag="message">messages</glossary>.</p><p/><p><code/><img src="202653"/> <b>Important!</b><code/> If an <glossary tag="object">object's</glossary> <property tag="script">script</property> uses the text <keyword tag="selection">selection</keyword>, make sure to set the <glossary tag="object">object's</glossary> <b>traversalOn</b> <glossary tag="property">property</glossary> to false, since clicking an <glossary tag="object">object</glossary> whose <b>traversalOn</b> is true deselects any text <keyword tag="selection">selection</keyword>.</p>
  </description>
</doc>