Set Hyperlinks

<< Click to Display Table of Contents >>

<%SKIN-STRTRANS-BREADCRUMBS-TITLE%>  Developer Information > Escape Sequences > Identifying ZTERM 2000 >

Set Hyperlinks

This escape sequence sets up (or disables) hyperlinks in the emulation window. A hyperlink is normal text from the host, but is displayed in italics with underlining. When the user moves the mouse pointer above the hyperlink, the pointer will change and when the user double-clicks on the hyperlink, the file/URL specified will be opened.

When using this escape sequence, you should first "paint" the screen and then issue this sequence. Overwriting text that's been marked as a hyperlink will cause the hyperlink to be overwritten.

Parameter

Value or Description

Sequence

ESC ESC CHR$(6) row,col,len,text... CHR$(0)

row

The row number to start the hyperlink plus a space

col

The column number to start the hyperlink from plus a space

len

The length of text plus a space

text

The file/URL to open when the hyperlink is double-clicked followed by a CHR$(0)

 

This escape sequence accepts embedded environment variables for the text parameter.

There can be multiple hyperlinks active - just send the row as a NULL to terminate the sequence. To disable hyperlinks, send the first row as NULL - i.e. ESC ESC CHR$(6) CHR$(0).

Example

This program sets up a hyperlink to track a package via UPS.

MAP1 TRACK$,S,20,"1z9t77t60340846389"                               

 

PRINT TAB(-1,0);                                                    

PRINT "Invoice Number 1234";                                        

PRINT TAB(1,50);"Double click here to track";                       

PRINT CHR$(27);CHR$(27);CHR$(6);   

PRINT CHR$(32 + 1);

PRINT CHR$(32 + 62);                  

PRINT CHR$(32 + 4);                  

PRINT "http://wwwapps.ups.com/etracking/tracking.cgi?";             

PRINT "tracknums_displayed=1&TypeOfInquiryNumber=T&HTMLVersion=4.0";

PRINT "&InquiryNumber1=";TRACK$;"&track=Track";chr$(0);             

PRINT CHR$(0);                                                      

 

Note: On terminals like the AM62C and Wyse 50, you can get the contents of the top and bottom status lines by using CHR$(32 + 0) for the top and CHR$(32 + 25) for the bottom.

Note: For starting columns greater than 96 in 132 column mode, use the standard 132 column sequence - CHR$(25) followed by the column number minus 96 plus 32 to make it printable ASCII.