| 1 | #Please insert up references in the next lines (line starts with keyword UP) |
|---|
| 2 | UP arb.hlp |
|---|
| 3 | UP glossary.hlp |
|---|
| 4 | |
|---|
| 5 | #Please insert subtopic references (line starts with keyword SUB) |
|---|
| 6 | #SUB subtopic.hlp |
|---|
| 7 | |
|---|
| 8 | # Hypertext links in helptext can be added like this: LINK{ref.hlp|http://add|bla@domain} |
|---|
| 9 | |
|---|
| 10 | #************* Title of helpfile !! and start of real helpfile ******** |
|---|
| 11 | TITLE Synchronize tree scrolling |
|---|
| 12 | |
|---|
| 13 | OCCURRENCE ARB_NT/Tree/Sync tree scrolling.. |
|---|
| 14 | |
|---|
| 15 | DESCRIPTION Allows to synchronize scrolling of two or more tree-views based on the |
|---|
| 16 | set of species currently displayed on screen. |
|---|
| 17 | |
|---|
| 18 | To use this feature you need to open a second tree display |
|---|
| 19 | as explained in LINK{newwindow.hlp}. |
|---|
| 20 | |
|---|
| 21 | After opening a second tree view, the selection list |
|---|
| 22 | in the "Synchronize tree scrolling" window will show that view. |
|---|
| 23 | |
|---|
| 24 | To help you to indentify the views, the name of the currently |
|---|
| 25 | displayed tree is shown behind the view name. The view names |
|---|
| 26 | themselves are just 'ARB' followed by a number like in 'ARB (1)' |
|---|
| 27 | for all but the 1st view. These numbers match those in the window |
|---|
| 28 | title of the tree views. |
|---|
| 29 | |
|---|
| 30 | By selecting that view, the tree view of the first arb |
|---|
| 31 | window ("slave-view") will synchronize with the |
|---|
| 32 | second view ("master-view") once. |
|---|
| 33 | |
|---|
| 34 | * at any time you may press the 'Sync scroll' button to |
|---|
| 35 | perform a instant synchronization of the slave-view or |
|---|
| 36 | |
|---|
| 37 | * you may select the 'Auto-sync'-toggle. If checked, the |
|---|
| 38 | slave-view will automatically synchronize whenever the |
|---|
| 39 | master-view does change. |
|---|
| 40 | |
|---|
| 41 | The synchronization is based on visible species only (ie. folded |
|---|
| 42 | groups are ignored completely; in master- and slave-view). |
|---|
| 43 | |
|---|
| 44 | During synchronization the slave-view gets scrolled to the position |
|---|
| 45 | containing most of the species currently visible in the master-view. |
|---|
| 46 | If there are multiple such positions, the "topmost" such position |
|---|
| 47 | is chosen. |
|---|
| 48 | |
|---|
| 49 | NOTES Each tree view has its own separate 'Synchronize tree scrolling' configuration. |
|---|
| 50 | |
|---|
| 51 | EXAMPLES You may also use more than two views for scroll synchronization. |
|---|
| 52 | |
|---|
| 53 | For example open 3 windows and |
|---|
| 54 | - synchronize the 2nd and 3rd view to the 1st view or |
|---|
| 55 | - synchronize the 2nd to 1st and the 3rd to the 2nd view |
|---|
| 56 | |
|---|
| 57 | If you configure a looped dependency, ARB will switch off |
|---|
| 58 | one dependency to avoid a deadlock. |
|---|
| 59 | |
|---|
| 60 | WARNINGS When used with BIG trees synchronizing two views may be quite slow. |
|---|
| 61 | In such cases it's not recommended to link the views with 'Auto-sync'. |
|---|
| 62 | Instead you may want to request each sync manually using the sync button. |
|---|
| 63 | |
|---|
| 64 | BUGS No bugs known |
|---|
