Copying/moving book topics

The Topic List allows you to copy, move or rearrange the topics of a user module by using the usual Windows drag-n-drop gesture with your mouse. The drag-n-drop gesture consists of the following steps:

1.You select with your mouse one or more topics from the Topic List (to select more than one topics, either hold down the CTRL key and click on individual topics, or hold down the SHIFT key to select the first and last topics, or just drag the mouse in the Topic List in the white area in order to select all topics that will fall within the drag rectangle that appears).
2.You click then on one of the selected topics, without releasing the mouse key
3.While holding down the mouse key you move your mouse over the same Topic List or the Topic List of another book view.
4.You release your mouse.

While dragging, there are two different modes that set what the result of the operation will be: copy or move. You toggle between the two modes by holding releasing the CTRL key. The default operation depends on several factors like whether you drag-n-drop topics in the same topic to re-arrange, whether the source module is a user module or not, etc. The cursor changes according to the operation being performed (standard windows cursors are used for these operations): the copy operation usually displays a cursor with a plus (+) sign, whereas the move operation does not.

Identifying the 'sensitive' areas of the Topic List - how drag-n-drop works.

The copy/move operation occurs when you release your mouse over a Topic List. As you move your mouse over the Topic List, some indicators appear in order to show you the exact position that the dragged nodes will be added. There are three different visual indicators that provide feedback as you drag verses over a Topic List. The following image displays several snapshots of a drag-n-drop operations. The screenshots are enhanced in order to help you understand how the operation works.

Several snapshots of a (faked) drag-n-drop operation<br>

Several snapshots of a (faked) drag-n-drop operation

In the above image, there are four snapshots of a sample Topic List while performing a drag-n-drop operation. Please, notice:

In the first image, notice the cursor: it is an arrow and there is a + sign on the lower-right corner: this indicates a copy operation. The cursors in all other images contain a white rectangle there instead: this cursor indicates a move operation.
In the first and second image, there is a red rectangle around topic 2-C: this  indicates the 'hot' area for this topic. When you drag-n-drop, if you move the mouse over the 'hot area' of a topic, then when you release the mouse the dragged topic will be added as children/subtopics of the 'hot' topic. While moving your mouse you will notice that as you pass your mouse over the 'hot' area of each topic, it gets highlighted.
The third and fourth images show what happens when you move the cursor in the 'white-space' area of the Topic List. 'White-area' can be found either on the right of a topic or on the left vertical lane, indicated with the blue rectangle on the fourth image (this is the vertical lane that is just a few pixels wide and runs through the whole height of the Topic List). When you move the mouse over this 'White-area' you will see the two horizontal blue indicators (these are the horizontal blue lines in the third and fourth image: in the third image notice that at the edges of the horizontal indicator there are two small triangles facing upwards, whereas in the fourth image these two small triangles face downwards).
In order to understand how the horizontal blue indicators appear/work, try it for yourself: drag one topic and move your mouse slowly on a vertical direction on the white space of the Topic List. You will notice that as you move your mouse, there appear these indicator for each single topic. You will notice also that this indicators do not appear in the middle between two topics, but they appear near the top and bottom rectangle that the topic node resides: this is exactly how you can decide what happens when you perform a drag-n-drop operation. More specifically:
Even if not highlighted, there is also in this case also a 'hot' topic that is associated with the blue indicators (the topic that the triangles point to, the closest one to the indicator).
When the indicator with the downward-facing triangles appear (as in 4), then the topics you drag will be added on the same level of the hot topic, exactly before it.
When the indicator with the upward-facing triangles appear (as in 3), then the topics you drag will be added on the same level of the hot topic, just after it


Operations supported with drag-n-drop

Remember that you can either drag-n-drop a single topic or multiple topics (examples below refer to a single topic, yet they all apply to multiple topics also). If dragging a node that contains sub-topics, then the operation is performed for the whole sub-tree. To perform the following operation you will need at least two book views (for the operations that required two different Topic Lists).

You can use drag-n-drop to perform the following operations:

Rearrange topics of existing user module (book or dictionary): use drag-n-drop in a single Topic List. The default action in that case is move. This operation cannot be performed on commentaries (since there can only be a single comment for a given verse or verse-range).
Create copies of a topic within the same user module (book or dictionary): just drag-n-drop in a single Topic List but hold down the CTRL key: when you release your mouse, a copy of the topic will be created. This operation cannot be performed on commentaries (since there can only be a single comment for a given verse or verse-range).
Copy topics from one module to another: use drag-n-drop from the Topic List of one book view to the other Topic List of the second book view. The default operation in that case is copy. To perform a move operation (e.g. remove the topics from the source module), hold down the CTRL key. Notice that it is allowed to copy content between different types of modules. In that case, theWord tries to determine the best way to map topics from one system to the other:
If copying from a multi-level topic (e.g. copy a topic that has sub-topics from a General Book) to a dictionary (that allows by definition only single level hierarchies), then the sub-topics are 'flattened' (e.g. demoted to the level of the parent topic)
If copying from a commentary to a non-commentary, then the topics are converted to text, using the standard verse references
if copying from a non-commentary to a commentary, then the topics are parsed in order to understand the verse references and apply them properly to the commentary.


Notice that:

You cannot reorder topics in a commentary: commentaries are always sorted on the book of the Bibles
If you try to copy a topic from a non-commentary to a commentary, and the topic is not a verse reference, then the copy will fail and a message will appear notifying you of the situation.
You cannot move topics from a non-user modules (because the move operation deletes the source topics and, by definition, non-user modules cannot be changed).
You are not allowed to copy topics from encrypted modules.


TIP: You can create quickly a copy of a module (or part of a module) by creating a new user module of the same type of the source module, opening two book views (one with the source module, one with the new one), selecting all the topics from the source module (click on the first one, then scroll to the end, hold down the SHIFT key and click on the last one) and dragging the topics to the new/empty module.

  ©2003-2012 Costas Stergiou
manual version: 4.0.1327