Macro Language Reference > Macros > Document > ttrack
  
ttrack
Description
Turns cursor tracking on or off. When tracking is on, the window will automatically scroll and pan around to follow the text cursor as it moves around the page or in the edit bar.
 
Example 61. Activate extended cursor tracking
Extended cursor tracking, with a change to the correct page, is useful in many circumstances, such as after a search. The example below shows how to specify extended tracking:
ttrack 3
Syntax
ttrack toggle:i? ( switch:n? )
ttrack
[no parameter]
Used without parameters, ttrack performs a one-off track of the current cursor position and changes what is shown in the work area to reflect the current cursor position. If the text cursor is on a page other than the one shown in the document window, PTC ALD will move to that page. The current tracking mode is not affected.
toggle
^
Optional toggle which should be followed by a switch setting.
0
Tracking off
1
Tracking on – follow the text cursor as it moves around the document window.
2
Tracking on – move to correct page, effectively following the text cursor position in the edit bar.
3
Tracking on – levels 1 and 2 combined.
4
One-off track of the current cursor position by following the text cursor as it moves around the document window.
8
One-off track of the current cursor position by moving to the correct page only without panning around the document window. This effectively follows the text cursor's position in the edit bar.
12
One-off tracking – levels 4 and 8 combined.
switch
0
Tracking off.
1
Tracking on – follow the text cursor as it moves around the document window.
2
Tracking on – move to correct page, effectively following the text cursor position in the edit bar.
3
Tracking on – levels 1 and 2 combined.
4
One-off track of the current cursor position by following the text cursor as it moves around the document window.
8
One-off track of the current cursor position by moving to the correct page only without panning around the document window. This effectively follows the text cursor's position in the edit bar.
12
One-off tracking – levels 4 and 8 combined.
Additional Information
 
You should be aware that ttrack (or any of the modes which enable page tracking) will not have any effect, or may even be unreliable, if the text within which the cursor is positioned is not displayed on any page; or if the page has not recently been formatted. In these cases ttrack may take you to the nearest page for which it has information.