We would like to point out that there are currently significant problems for using devices with multipanel surfaces on Apple Macintosh computers in XTC mode. At the moment we cannot make any precise statement if these problems will be solved. We would
recommend to use pages instead of multiple panels.
There are two different possibilities:
1) You would like to convert a multipanel surface
2) You would like to build a multipanel surface from an old-style drawer surface
To convert a multipanel surface so that it is XTC compatible load the device and open the surface.Select the mainpanel in the Project Explorer and use the conversion function from the context menu (RMB -> Tools -> Convert Surface (make XTC compatible)). This converts the main panel to a 'Surfaces@BasicSurface' and adds a 'SurfaceInterface' to which the main panel is connected. Also the ViewID of all control elements is set to 'Surface'. The subpanels are still 'ChildView' surfaces (the control elements' ViewIDs however are already set to 'Surface').
The main panel should replace the MinimizeView and the old Close button with the 'CloseGroup' and the 'ParentTopChanger'. Read more about placing the 'CloseGroup' and the 'ParentTopChanger'.
Afterwards you should convert each subpanel the same way. As you do not need the 'SurfaceInterfaces' you ought to delete them. Normally you should etablish a parent-child connection between the main panel and the subpanels - to do so it might be the handiest to have the subpanels on the same level as the main panel. Read more about establishing a parent-child connection between the main panel and the subpanels.
As a last step you could add 'CloseGroups' to the subpanels but it is not combelling.
If your former surface was constructed with multiple drawers and you do not like to use pages you might like to use a multipanel surface for your device. Before you actually start to convert the surface you might like to group (fold) the control elements on your drawers so that it will be easier to drag them from your drawer to a specific panel. (This way you could build control groups and enable the 'Draw ClipChildren' flag for the control groups.)
To be able to illustrate this tutorial we provide a simple example for you. You could find the data in the folder 'XTC Special/Tutorials/Drawer2Multipanel' in the files that come with the new Scope /DP software. This is a step by step tutorial and starts with the 'State One' module.
Drag the 'State One' module from the File Browser into the Project Window. You should see a
surface with three drawers. This is a dummy module that is only a surface with drawers.

Control groups and ViewIDs
When you look into the Project Explorer you should note that the controls are not grouped. There are all on one level and the algorithm will search on the whole surface for control elements that are related to each control. This takes some time. This way it could easily become time consuming and therefore inefficient. Instead you should group related elements together and set the 'Draw ClipChildren' flag for the group. Later on in this tutorial we will move the existing controllers from the drawers to new panels. Also for this task it will more convenient to move groups and not every single control element.
Furthermore you should remark that the ViewID (in the GO Attributes) of the controls is set to 'Circuit' - for the new surfaces it should be set to 'Surface'.

First we will now convert the ViewID of the control elements to 'Surface'. In the Project Explorer you should go
to the surface - in this case 'Drawer Surface', right click and select 'Tools -> Swap ViewID Circuit->Surface'.

 |
Now you could group your controls. To do so drag 'SurfaceGroup' modules from the File Browser onto the appropriate surface/drawer inside the Project Explorer. It is the best idea to drag it directly into the Project Explorer as an empty 'SurfaceGroup' could be hard to see when it becomes deselected. Move the controls into these groups. Adjust each 'SurfaceGroup' using the GO Attributes (turn off the 'Custom horizontal/vertical size' flag and turn on 'ViewTree Group' and the 'Draw/Select ClipChildren').
 This state has been saved as 'State Two'.
|
Repalcing the drawers with subpanels
We converted the controls to 'Surface' elements and we grouped them. Now we could continue with placing the controls on subpanels. For this example we assume that there will be a panel for every drawer. It is much easier to start with the subpanels and convert the main panel afterwards.
For a new subpanel drag in a 'DefaultPanel'(XTC Specials/Surface Kit/) onto the same level where the old surface is situated. Do illustrate that better we have marked the equivalent part of the ModuleTree with a yellow ellipse in the picture below. You might like to 'flip in' the old surface (RMB -> Flip In) . If you are in Circuit View you will now see a 'DefaultPanel' node in your circuit ( which is marked red in the screenshot). As the panel is ´hidden it is not visible immediately after dragging in the 'DefaultSurface'.
|