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. For more information, see TabbedReparentContainer with Popups.

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

There are several design properties (grouped under Advanced) for the TabbedReparentControl:

DesignComponentConfiguration
ResizeConfiguration
TabConfiguration

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 TabControl Class topic for information on the general properties, methods, and events.

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

Descriptions of the Advanced properties follow. For more information, see Using the TabbedReparentContainer.

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 window. This dialog contains the following options:

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

Windows adapter – All Windows applications in your project will be displayed in the TabbedReparentContainer. Web applications display as separate windows.
Web adapter – All web applications in your project will be displayed in the TabbedReparentContainer. Windows applications display as separate windows.
Windows and web adapter – All Windows and web applications in your project will be displayed in the TabbedReparentContainer.
Reparent design components by ID – Lets you 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 appear in the TabbedReparentContainer.

ResizeConfiguration

Browsing this property displays the Tabbed Container Resize Configuration window. Use this window 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, Studio 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 check box to have the application window resized to the size of the TabbedReparentControl. Clear the check box to have the reparented application window display with its default size. If the application window is too large to fit the TabbedReparentControl, scroll bars appear 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 these options for defining how to display the application window when the window is smaller than the TabbedReparentControl:

Center window in parent – Places the application window in center of TabbedReparentControl.
Position window at top left corner – Places the application window at top left of TabbedReparentControl.

TabConfiguration

Browsing this property displays the Tabbed Container Tab Configuration window. Use this window 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 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 appear on 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:
Window Tab Orientation – Use this option to specify how you want adapter and application tabs to display along the sides of the TabbedReparentContainer control. Your options are: Top, Bottom, Left, and Right.
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. Your options are:
DC Tab Orientation – Defines the position of tabs for Windows and web adapter applications. Your options are: Top, Bottom, Left, and Right.
Window Tab Orientation – Defines the position of tabs for application windows. Your options are: Top, Bottom, Left, and Right.