From:	SMTP%"RELAY-INFO-VAX@CRVAX.SRI.COM"  1-SEP-1993 18:01:33.04
To:	EVERHART
CC:	
Subj:	RE: How do you make SMG see DECterm mouse clicks

Date: Wed, 1 Sep 1993 11:38:32 -0500 (CDT)
From: Ed Dambik <"WARNER::DAMBIK"@FNALV.FNAL.GOV>
To:   INFO-VAX@SRI.COM
X-Vmsmail-To: FNALV::COM%"INFO-VAX@SRI.COM"
X-Vmsmail-Cc: DAMBIK
Message-Id: <930901113832.20224a8e@FNALV.FNAL.GOV>
Subject: RE: How do you make SMG see DECterm mouse clicks


thompson@HAX.PPPL.GOV Writes:

:
>I have a program which uses SMG to display a bunch of action buttons.
>I would like to turn the DECterm mouse into a 1-button point-and-click
>mouse, so the user can simply click on a button instead of having to
>use the arrow keys and then type something.
:
>Can anyone tell me:
>
>1) What are the control sequence that a program can send to a DECterm
>window to turn the mouse into a 1-button point-and-click mouse, and to
>restore it to a "normal" 3-button mouse?

The enable locator sequence is:

CSI Ps ; Pu ' z

where 
	CSI = <ESC>[  for 7 bit mode
	Ps = 0  to disable locator
	   = 1  to enable locator reports
	   = 2  to enable a one-shot report
	Pu = 0  defaults to location reported in character cells
	   = 1  location in pixels
	   = 2  location in character cells

The locator report returns the following sequence:

CSI Pe ; Pb ; Pr ; Pc ;Pp & w

where 
	Pe = event code 
		0 = locator unavailable
		1 = explicit request for location received
		2 = left button down
		3 = left button up
		4 = middle button down
		5 = middle up
		6 = right down
		7 = right up
		8 = 4th button down
		9 = 4th up
		10 = locator outside filter rectangle

	Pb = button code
		0 = no button press
		1 = right
		2 = middle
		3 = left
		4 = 4th

	Pr = row as ASCII decimal value
	Pc = column as ASCII decimal value
	Pp = page coordinate


To select or filter out specific events types:

CSI P ' {

where 
	P = 0  explicit requests only
	  = 1  report button down 
	  = 2  button down events not reported
	  = 3  report button up
	  = 4  button up events not reported

These sequences were found in the VMS Workstation Software User's Guide
in the Additional Features of the VT220 Terminal Emulator section.


>2) Is there a document anywhere with ALL the control sequences that
>DECterm responds to?

No. The old VWS manuals documented quite a few of these features though.
I haven't seen anything current but there may be a FAQ floating around.

By the way, SMG menus will respond to these locator sequences. 

If you need more information on using the the locator with SMG, drop me
a line.


    Ed Dambik
    Fermilab, Research Division, EE Dept., Controls Software Group
    HEPnet/SPAN: FNAL::DAMBIK (43009::DAMBIK)
    Internet: DAMBIK@FNAL.FNAL.GOV            
    BitNet: DAMBIK@FNAL
    USnail: Fermilab POB 500 MS/220 Batavia, IL 60510