<doc>
  <legacy_id>2065</legacy_id>
  <name>showFocusBorder</name>
  <type>property</type>
  <syntax>
    <example>set the showFocusBorder of <i>control</i> to {true | false}</example>
  </syntax>
  <library></library>
  <objects>
    <stack/>
    <card/>
    <group/>
    <field/>
    <button/>
    <graphic/>
    <scrollbar/>
    <player/>
    <image/>
  </objects>
  <synonyms>
  </synonyms>
  <classification>
    <category>User Interaction</category>
    <category>Appearance &amp; Positioning</category>
  </classification>
  <references>
    <command tag="focus">focus Command</command>
  </references>
  <history>
    <introduced version="1.1">Added.</introduced>
  </history>
  <platforms>
    <mac/>
    <linux/>
    <ios/>
    <android/>
  </platforms>
  <classes>
    <desktop/>
    <server/>
    <web/>
    <mobile/>
  </classes>
  <security>
  </security>
  <summary>Displays a border around the <glossary tag="active control">active control</glossary>.</summary>
  <examples>
    <example>set the showFocusBorder of field "Answer" to false</example>
    <example>set the showFocusBorder of myControl to (the platform is not "MacOS")</example>
  </examples>
  <description>
    <p>Use the <b>showFocusBorder</b> <glossary tag="property">property</glossary> to turn off the standard (for <glossary tag="Unix">Unix systems</glossary>) focus border around the <glossary tag="active control">active control</glossary>, or to show which <keyword tag="field">field</keyword> has the <glossary tag="insertion point">insertion point</glossary> in a <glossary tag="dialog box">dialog box</glossary>.</p><p/><p><b>Value:</b></p><p>The <b>showFocusBorder</b> of an <glossary tag="object">object</glossary> is true or false.</p><p/><p>By default, the <b>showFocusBorder</b> <glossary tag="property">property</glossary> of newly created <glossary tag="object">objects</glossary> is set to true.</p><p/><p><b>Comments:</b></p><p>The appearance of the focus border is set by the <b>focusColor</b> and <property tag="focusPattern">focusPattern</property> <property tag="properties">properties</property>.</p><p/><p>If the <b>lookAndFeel</b> <glossary tag="property">property</glossary> is set to "Macintosh" or "Appearance Manager", the setting of the <b>showFocusBorder</b> <glossary tag="property">property</glossary> affects only <glossary tag="field">fields</glossary>, <glossary tag="image">images</glossary>, and <glossary tag="EPS">EPS objects</glossary>. (To comply with user interface guidelines, this <glossary tag="property">property</glossary> should be set to true for fields in <command tag="modal">modal</command> and <command tag="modeless">modeless</command> <glossary tag="dialog box">dialog boxes</glossary>.)</p><p/><p>If the <b>lookAndFeel</b> is set to "Motif", the <b>showFocusBorder</b> <glossary tag="property">property</glossary> affects all <glossary tag="control">controls</glossary>.</p><p/><p>If the <b>lookAndFeel</b> is set to "Windows 95", the <b>showFocusBorder</b> <glossary tag="property">property</glossary> has no effect.</p><p/><p>The <b>focusBorder</b> of <glossary tag="card">cards</glossary> and <function tag="stacks">stacks</function> has no effect.</p>
  </description>
</doc>