From Xojo Documentation

You are currently browsing the old Xojo documentation site. Please visit the new Xojo documentation site!

DesktopContainer.EmbedWithinPanel(ContainingPanel as DesktopPagePanel, Page as Integer, [left as Integer, top as Integer, width as Integer, height as Integer])

New in 2021r3

Supported for all project types and targets.

Embeds the DesktopContainer on a page in the passed DesktopPagePanel or DesktopTabPanel.


An instance of a DesktopContainer can only be embedded into one page.

The DesktopContainer is embedded on the passed page and the containing control is the parent of the DesktopContainer. The optional Left and Top parameters determine the location of the top-left corner, relative to the containing control, not the parent window. If the DesktopContainer itself has Left and Top values (not typical as they default to 0) then they are added to what is specified here. The optional parameters Width and Height determine the size of the DesktopContainer.

Sample Code

This example adds a new tab to a DesktopTabPanel and then add a DesktopContainer to it:

MainTab.AddPanel("New Tab")
Var tabNum As Integer
tabNum = MainTab.PanelCount - 1

Var cc As New MyContainer
cc.EmbedWithinPanel(MainTab, tabNum)