TabbedReparentContainer

The TabbedReparentContainer lets you embed Windows and Web application windows in a single container placed on a Windows form. Note that only Windows and Web applications can be reparented with this control. For example, Citrix Contexts and Text applications cannot be used with this component. Pop-up windows are not reparented unless the pop-up is the first window that opens when the application starts. See the TabbedReparentContainer with Popups topic for more information.

The TabbedReparentControl creates a tab for each adapter (Design Component) you want reparented. The Design Component tab names display the names of the adapters. The control also creates tabs for the adapter application windows that open while the project runs.

There are three Design properties (Grouped under 'Advanced") for the OpenSpan TabbedReparentControl:

These properties specify which project Windows and/or Web applications are parented in the control and how the applications display within the control. See the MSDN topic TabControl Class for information on the general properties, methods, and events.

Note: The OpenSpan ToolTips methods (ShowToolTip, DestroyTooltip, HideTooltip) are not supported for reparented application controls.

Descriptions the Advanced properties follow. See the Using the TabbedReparentContainer topic for an example project using this control.

DesignComponentConfiguration

Use this property to select the adapters (Design Components) to add to the container. Browsing the property displays the Tabbed Container Design Component Configuration dialog.

This dialog contains two main options:

Reparent design components by type - enables you to select which type of adapters are reparented. If you choose this option, then you can select the adapter types to be reparented by using the Select design component type to reparent drop-down. The options are:

Reparent design components by ID - enables you to choose the project adapters individually for reparenting. For example, if you have WindowsApp1, WindowsApp2, and WebApp1, you can choose which of these three applications should display in the TabbedReparentContainer.

 

ResizeConfiguration

Browsing this property displays the Tabbed Container Resize Configuration dialog. Use this dialog to define how to size and position application windows that are reparented.

If the application window is not resizable, the TabbedReparentControl displays the window in the center of the tab by default. If the application window is resizable, OpenSpan resizes the application window to fill the tab by default. Use the options on this dialog to change the display options for resizable and non-resizable reparented application windows.

Resize all resizable windows to fit parent: Select this checkbox (default) to have the application window resized to the size of the TabbedReparentControl.  Clear the checkbox to have the reparented application window display with its default size. If the application window is too large to fit the TabbedReparentControl, scroll bars display in the tab to view the application window.

Window position if smaller than parent: This setting applies to reparented applications that are not resizable. In this case, you have two options for defining how to display the application window when the window is smaller than the TabbedReparentControl:

 

TabConfiguration

Browsing this property displays the Tabbed Container Tab Configuration dialog. Use this dialog to define how the tabs for the adapters and the windows related to the adapter applications appear in the container. For example, if you are reparenting the Windows Calc.exe application and Web Google application you can choose to have one tab for Calc and another for Google. In this case, if you open the Stat window in Calc, the window can appear either in a tab along with the Calc and Google tabs, or as a tab in a different orientation from Calc tab.

 

The two main options are:

One set of tabs showing all windows from all design components - Select this option (the default) to have the adapter tab and adapter application windows display in tabs along the same side of the control. If you select this option, you must specify the placement of the tabs along the sides of the control:

One set of tabs for design components, another for windows - Select this option to have the adapter and application  windows display in tabs along a different side of the control. The options are:

The image below shows a Windows application (CRM - OpenSpan) and Web application (Google) reparented. In this example, the application windows are located along the left side of the control.