<doc>
  <legacy_id>2106</legacy_id>
  <name>link</name>
  <type>keyword</type>
  <syntax>
  </syntax>
  <library></library>
  <objects>
  </objects>
  <synonyms>
    <synonym>group</synonym>
  </synonyms>
  <classification>
    <category>User Interaction</category>
    <category>Appearance &amp; Positioning</category>
  </classification>
  <references>
    <command tag="show groups">show groups Command</command>
    <message tag="linkClicked">linkClicked Message</message>
    <property tag="linkColor">linkColor Property</property>
    <property tag="linkHiliteColor">linkHiliteColor Property</property>
    <property tag="linkVisitedColor">linkVisitedColor Property</property>
    <property tag="linkText">linkText Property</property>
  </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>Used with the <property tag="textStyle">textStyle</property> <glossary tag="property">property</glossary> to make a run of text in a <keyword tag="field">field</keyword> behave like a single <keyword tag="word">word</keyword> when clicked.</summary>
  <examples>
    <example>set the textStyle of the foundChunk to link</example>
  </examples>
  <description>
    <p>Use the <b>link</b> <glossary tag="keyword">keyword</glossary> to create clickable text.</p><p/><p><b>Comments:</b></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>Note:</b><code/>  Each continuous run of "link"-styled text is considered a single <glossary tag="grouped text">text group</glossary>, even if you <property tag="selected">selected</property> part of the text and set its <property tag="textStyle">textStyle</property> to "link", and set the <property tag="textStyle">textStyle</property> of the other part later. It is not possible for two separate <glossary tag="grouped text">text groups</glossary> to exist if there are no <keyword tag="characters">characters</keyword> between them.</p><p/><p>To show which text in a field is grouped, it is underlined and displayed in the color specified by the <b>linkColor</b> <glossary tag="property">property</glossary>. Use the <command tag="hide groups">hide groups</command> <glossary tag="command">command</glossary> to hide the underline.</p><p/><p><b>Changes:</b></p><p>The <b>link</b> <glossary tag="keyword">keyword</glossary> was introduced in version 1.1. In previous versions, the <b>group</b> synonym was used, and <glossary tag="grouped text">grouped text</glossary> could be optionally displayed with a heavy gray underline.</p>
  </description>
</doc>