<doc>
  <legacy_id>2288</legacy_id>
  <name>underlineLinks</name>
  <type>property</type>
  <syntax>
    <example>set the underlineLinks to {true | false}</example>
    <example>set the underlineLinks of <i>stack</i> to {true | false | empty}</example>
  </syntax>
  <library></library>
  <objects>
    <global/>
  </objects>
  <synonyms>
    <synonym>showGroups</synonym>
  </synonyms>
  <classification>
    <category>Navigation &amp; Hypertext</category>
    <category>Appearance &amp; Positioning</category>
  </classification>
  <references>
    <command tag="show groups">show groups Command</command>
  </references>
  <history>
    <introduced version="1.0">Added.</introduced>
    <changed version="1.1"></changed>
  </history>
  <platforms>
    <mac/>
    <windows/>
    <linux/>
    <ios/>
    <android/>
  </platforms>
  <classes>
    <desktop/>
    <server/>
    <web/>
    <mobile/>
  </classes>
  <security>
  </security>
  <summary>Specifies whether <glossary tag="grouped text">grouped text</glossary> is underlined.</summary>
  <examples>
    <example>set the underlineLinks to (not the underlineLinks)</example>
    <example>set the underlineLinks of this stack to false</example>
    <example>set the underlineLinks of stack myStack to empty</example>
  </examples>
  <description>
    <p>Use the <b>underlineLinks</b> <glossary tag="property">property</glossary> to see which text is grouped.</p><p/><p><b>Value:</b></p><p>The <b>underlineLinks</b> is true or false. The <b>underlineLinks</b> of a <object tag="stack">stack</object> is true, false, or empty.</p><p/><p>By default, the <b>underlineLinks</b> <glossary tag="property">property</glossary> is set to true. The <b>underlineLinks</b> <glossary tag="property">property</glossary> of a newly created <object tag="stack">stack</object> is set to empty by <keyword tag="default">default</keyword>.</p><p/><p><b>Comments:</b></p><p>When the <b>underlineLinks</b> <glossary tag="property">property</glossary> is false, <glossary tag="grouped text">grouped text</glossary> looks like any other text. When the <b>underlineLinks</b> is true, <glossary tag="grouped text">grouped text</glossary> is underlined.</p><p/><p>If the <b>underlineLinks</b> of a <object tag="stack">stack</object> is empty, <glossary tag="grouped text">grouped text</glossary> in that <object tag="stack">stack</object> is underlined or not, depending on the value of the <command tag="global">global</command> <b>underlineLinks</b> <glossary tag="property">property</glossary>. If the <b>underlineLinks</b> of a <object tag="stack">stack</object> is true, <glossary tag="grouped text">grouped text</glossary> in the <object tag="stack">stack</object> is underlined regardless of the <command tag="global">global</command> setting. If the <b>underlineLinks</b> of a <object tag="stack">stack</object> is false, <glossary tag="grouped text">grouped text</glossary> in the <object tag="stack">stack</object> is not underlined regardless of the <command tag="global">global</command> setting.</p><p/><p>Text with its <b>textStyle</b> set to "link" is treated specially by the <function tag="clickText">clickText</function>, <function tag="clickChunk">clickChunk</function>, <function tag="mouseText">mouseText</function>, and <function tag="mouseChunk">mouseChunk</function> <glossary tag="function">functions</glossary>: a style run of <glossary tag="grouped text">grouped text</glossary> is treated as a single <keyword tag="word">word</keyword>. This makes <glossary tag="grouped text">grouped text</glossary> handy to use for <glossary tag="hypertext">hypertext</glossary> or "clickable text" features.</p><p/><p><b>Changes:</b></p><p>The <b>underlineLinks</b> synonym and the ability to apply this property to individual <function tag="stacks">stacks</function> was introduced in version 1.1. In previous versions, the synonym <b>showGroups</b> was used, <glossary tag="grouped text">grouped text</glossary> was displayed with a heavy gray underline instead of an ordinary underline when the <b>showGroups</b> was true, and the <b>showGroups</b> was set to false by default.</p>
  </description>
</doc>