33 result of the <xref href="GUID-9FFD28C7-8747-3438-84BF-44AF26ACEC7D.dita#GUID-9FFD28C7-8747-3438-84BF-44AF26ACEC7D/GUID-12634A4D-36F1-35AD-8D61-EEA63872CF8B"><apiname>RWindowTreeNode::Parent()</apiname></xref>, <xref href="GUID-9FFD28C7-8747-3438-84BF-44AF26ACEC7D.dita#GUID-9FFD28C7-8747-3438-84BF-44AF26ACEC7D/GUID-1FFFFED4-5062-3C9D-B9A6-A89B107080FF"><apiname>RWindowTreeNode::Child()</apiname></xref>, <xref href="GUID-9FFD28C7-8747-3438-84BF-44AF26ACEC7D.dita#GUID-9FFD28C7-8747-3438-84BF-44AF26ACEC7D/GUID-F11A3640-844E-30D3-AAB2-D154E4EACBB4"><apiname>RWindowTreeNode::NextSibling()</apiname></xref> and <xref href="GUID-9FFD28C7-8747-3438-84BF-44AF26ACEC7D.dita#GUID-9FFD28C7-8747-3438-84BF-44AF26ACEC7D/GUID-1B6C1D5F-8F27-3472-87EE-CBB90D1A9280"><apiname>RWindowTreeNode::PrevSibling()</apiname></xref> functions. </p> |
33 result of the <xref href="GUID-9FFD28C7-8747-3438-84BF-44AF26ACEC7D.dita#GUID-9FFD28C7-8747-3438-84BF-44AF26ACEC7D/GUID-12634A4D-36F1-35AD-8D61-EEA63872CF8B"><apiname>RWindowTreeNode::Parent()</apiname></xref>, <xref href="GUID-9FFD28C7-8747-3438-84BF-44AF26ACEC7D.dita#GUID-9FFD28C7-8747-3438-84BF-44AF26ACEC7D/GUID-1FFFFED4-5062-3C9D-B9A6-A89B107080FF"><apiname>RWindowTreeNode::Child()</apiname></xref>, <xref href="GUID-9FFD28C7-8747-3438-84BF-44AF26ACEC7D.dita#GUID-9FFD28C7-8747-3438-84BF-44AF26ACEC7D/GUID-F11A3640-844E-30D3-AAB2-D154E4EACBB4"><apiname>RWindowTreeNode::NextSibling()</apiname></xref> and <xref href="GUID-9FFD28C7-8747-3438-84BF-44AF26ACEC7D.dita#GUID-9FFD28C7-8747-3438-84BF-44AF26ACEC7D/GUID-1B6C1D5F-8F27-3472-87EE-CBB90D1A9280"><apiname>RWindowTreeNode::PrevSibling()</apiname></xref> functions. </p> |
34 <p>To give an illustration of how ordinal positions work, the diagram below |
34 <p>To give an illustration of how ordinal positions work, the diagram below |
35 shows three windows, A, B and C, all belonging to the same window group. Their |
35 shows three windows, A, B and C, all belonging to the same window group. Their |
36 ordinal positions are as follows: A=0; B=1; C=2. </p> |
36 ordinal positions are as follows: A=0; B=1; C=2. </p> |
37 <fig id="GUID-FB15A25F-FB7A-5031-9D17-51CD7C8ACA1D"> |
37 <fig id="GUID-FB15A25F-FB7A-5031-9D17-51CD7C8ACA1D"> |
38 <image href="GUID-694C7416-927E-58F7-B010-CA55D2FFA88F_d0e194205_href.png" placement="inline"/> |
38 <image href="GUID-694C7416-927E-58F7-B010-CA55D2FFA88F_d0e189143_href.png" placement="inline"/> |
39 </fig> |
39 </fig> |
40 <p>This would be the default ordering of the windows if they were created |
40 <p>This would be the default ordering of the windows if they were created |
41 in the order CBA. Many sibling windows within an application may not overlap |
41 in the order CBA. Many sibling windows within an application may not overlap |
42 in practice: nevertheless, each window has a unique ordinal position, even |
42 in practice: nevertheless, each window has a unique ordinal position, even |
43 though this will not be evident in the way they are displayed. </p> |
43 though this will not be evident in the way they are displayed. </p> |
47 <section id="GUID-4B42408E-06DC-4A98-9AC8-7EEAF533D614"><title>Moving a window to the front</title> <p>A window is moved |
47 <section id="GUID-4B42408E-06DC-4A98-9AC8-7EEAF533D614"><title>Moving a window to the front</title> <p>A window is moved |
48 to the front (i.e., to the <keyword>foreground</keyword>) by giving it an |
48 to the front (i.e., to the <keyword>foreground</keyword>) by giving it an |
49 ordinal position of 0. The diagram below shows windows A, B and C, but window |
49 ordinal position of 0. The diagram below shows windows A, B and C, but window |
50 B has now been given an ordinal position of 0. A’s position has been incremented |
50 B has now been given an ordinal position of 0. A’s position has been incremented |
51 to 1, and C’s remains as 2. </p> <fig id="GUID-0B1ED6C1-4F47-5527-A9F9-5B4AD03528D5"> |
51 to 1, and C’s remains as 2. </p> <fig id="GUID-0B1ED6C1-4F47-5527-A9F9-5B4AD03528D5"> |
52 <image href="GUID-74B329CD-4640-5636-9D8D-20F0D7E09EB4_d0e194226_href.png" placement="inline"/> |
52 <image href="GUID-74B329CD-4640-5636-9D8D-20F0D7E09EB4_d0e189164_href.png" placement="inline"/> |
53 </fig> <p>The diagram below shows the same three windows as above, except |
53 </fig> <p>The diagram below shows the same three windows as above, except |
54 that window B now contains a child window, D. Window D’s ordinal position |
54 that window B now contains a child window, D. Window D’s ordinal position |
55 is 0, relative to its parent window, B. </p> <fig id="GUID-313C9AEE-6ADB-5842-9EB6-0D563D7FC582"> |
55 is 0, relative to its parent window, B. </p> <fig id="GUID-313C9AEE-6ADB-5842-9EB6-0D563D7FC582"> |
56 <image href="GUID-7AE4D17F-728A-5B7E-A3F9-A903E64731B1_d0e194234_href.png" placement="inline"/> |
56 <image href="GUID-7AE4D17F-728A-5B7E-A3F9-A903E64731B1_d0e189172_href.png" placement="inline"/> |
57 </fig> <p>If window A is now moved to the front, window B moves behind it, |
57 </fig> <p>If window A is now moved to the front, window B moves behind it, |
58 as shown in the diagram below. Window D’s ordinal position is still 0, but |
58 as shown in the diagram below. Window D’s ordinal position is still 0, but |
59 because its position is relative to its parent window, it moves with window |
59 because its position is relative to its parent window, it moves with window |
60 B to behind window A. </p> <fig id="GUID-B6882EE3-C071-522B-9D7E-86D84F8D64DC"> |
60 B to behind window A. </p> <fig id="GUID-B6882EE3-C071-522B-9D7E-86D84F8D64DC"> |
61 <image href="GUID-40A3938E-366E-5318-A7FA-146F9E5E23B1_d0e194242_href.png" placement="inline"/> |
61 <image href="GUID-40A3938E-366E-5318-A7FA-146F9E5E23B1_d0e189180_href.png" placement="inline"/> |
62 </fig> </section> |
62 </fig> </section> |
63 <section id="GUID-EDA73282-0AB9-49EE-BAAB-C6D0DB267F56"><title>Moving a window to the back</title> <p>If a window is given |
63 <section id="GUID-EDA73282-0AB9-49EE-BAAB-C6D0DB267F56"><title>Moving a window to the back</title> <p>If a window is given |
64 an ordinal position greater than all its siblings, it is moved to the back |
64 an ordinal position greater than all its siblings, it is moved to the back |
65 of them. For convenience, the functions for setting ordinal position allow |
65 of them. For convenience, the functions for setting ordinal position allow |
66 a negative ordinal position to be specified, which sends the window to the |
66 a negative ordinal position to be specified, which sends the window to the |