<doc>
	<legacy_id></legacy_id>
	<name>print link</name>
	<type>command</type>

	<syntax>
		<example>print link to [ url | anchor ] <i>link</i> with rect <i>rectangle</i></example>
	</syntax>

	<synonyms>
	</synonyms>

	<summary>Defines a hyperlink within a pdf print loop.</summary>

	<examples>
<example>print link to url &quot;http://www.runrev.com&quot; with rect 50,50,60,60</example>
<example>print link to anchor &quot;section 1.1&quot; with rect 100,100,200,200</example>
	</examples>

	<history>
		<introduced version="4.5">Added.</introduced>
		<deprecated version=""></deprecated>
		<removed version=""></removed>
		<changed version="4.6">Changed</changed>
	</history>

	<objects>
	</objects>

	<platforms>
		<mac/>
		<windows/>
		<linux/>
		<ios/>
	</platforms>

	<classes>
		<desktop/>
		<web/>
		<mobile/>
	</classes>

	<security>
	</security>


	<classification>
		<category>Printing</category>
	</classification>

	<references>
		<command tag="cancel printing">cancel printing Command</command>
		<command tag="open printing to pdf">open printing to pdf Command</command>
		<command tag="print anchor">print anchor Command</command>
		<command tag="print bookmark">print bookmark Command</command>
	</references>

	<description>
	<overview>Use the print link command to define a hyperlink within a pdf printing loop.</overview>

		<parameters>
  <parameter>
    <name>link</name>
    <description>A URL or internal anchor name.</description>
  </parameter>
  <parameter>
    <name>rectangle</name>
    <description>A valid rectangle describing the link area in the pdf.</description>
  </parameter>		</parameters>

	<value></value>
	<comments>If the url adjective is specified, then <i>link</i> is interpreted as a URL and an external URL launching link is created in the PDF document. The given rectangle jumps to that URL when it is clicked.<p></p><p>If the anchor adjective is specified, then <i>link</i> is interpreted as an internal anchor name, as specified by the print anchor command, and an internal anchor link is created in the PDF document. Clicking the given rectangle jumps to that anchor.</p><p></p><p>If no adjective is specified then <i>link</i> is interpreted as a URL if it begins with (ASCII) letters followed by a colon. e.g. &quot;mailto:foobar&quot; is interpreted as a URL, whereas &quot;mail-to-anchor:foo&quot; is interpreted as an anchor name.</p><p></p><p>When printing fields, any text that has its <property tag="linkText">linkText</property> property set together with the link <property tag="textStyle">textStyle</property> is treated as if a<b> print link</b> command had been executed with the contents of the property as <i>link</i>, and the <property tag="formattedRect">formattedRect</property> of the text as <i>rectangle</i>.</p></comments>
	</description>
</doc>