Please enable JavaScript to view this site.

A-Shell Development History

Navigation: Version 6.1/6.2, builds 1300-1428 > 1345 – 28 March 2013

Retrieve XTREE Row/Column Coordinates

Scroll Prev Top Next More

XTREE enhancement: You may now retrieve row and/or column coordinates of click events on inactive trees by coding the XTR'KBDSTR field as follows:

_x{r}{d}F##{R..R}{C..C}

In other words, using the standard Virtual Key Symbolic Name syntax, except with the leading "VK" removed, and with some of the numeric digits at the end replaced with a string of zero or more "R" characters (representing row digits) and zero or more "C" characters (representing column digits). For example:

_xF1RRRC

The above format would return exitcodes in the range of -10000 thru -19999 where the last digit represented the column clicked on (1-9) and the next three digits to the left represent row clicked on (1-999). So -10493 would indicate that the user clicked on row 49, column 3. -10000 would indicate some kind of click event that wasn't specifically on a particular cell.

_xrF2RRRR

The above would be useful in cases where you just wanted the row number, and would return exitcodes from -20001 to -29999 for rows 1 thru 9999. As with standard extended virtual key codes, the "r" in between the "_x" and "F" indicates that right clicks will be distinguished by returning a positive exitcode value rather than negative.

_xF5CC

The above example returns exitcodes -501 thru -599, representing clicked columns 1 thru 99.

WARNING: Although exitcodes could theoretically range from +/- 2GB, a historic 16 bit bottleneck (the EXTCOD field of the INMEMO EXTCTL parameter) limited exitcodes to the range of +/- 32K. The bottleneck is removed in this release, but in the case of ATE, both the server and client must be at least 6.1.1345.0 in order one XTREE to handle an inactive click exitcode from another XTREE, outside the +/- 32K range.