DockControllerBase.AddDocumentPanel(DocumentGroup, Uri) Method

Adds a new DocumentPanel to the specified DocumentGroup and loads the contents of a Window, Page or UserControl defined in the specified XAML into the DocumentPanel.

Namespace: DevExpress.Xpf.Docking

Assembly: DevExpress.Xpf.Docking.v14.2.dll

Declaration

C#

public DocumentPanel AddDocumentPanel(
    DocumentGroup group,
    Uri uri
)

VB.NET

Public Function AddDocumentPanel(
    group As DocumentGroup,
    uri As Uri
) As DocumentPanel

Parameters

Name	Type	Description
group	DocumentGroup	A DocumentGroup object to which a new DocumentPanel is added.
uri	Uri	The uniform resource identifier (URI) of the XAML that defines a Window, Page or UserControl to be loaded into the created DocumentPanel.

Returns

Type	Description
DocumentPanel	The created DocumentPanel object.

Remarks

When the URI refers to a Window or Page, the AddDocumentPanel method loads the contents of the specified Window/Page. The Window/Page objects themselves, and their resources and event handlers are not loaded, and they will not be available via the inherited LayoutPanel.Control property.

When the URI refers to a UserControl, the UserControl itself is loaded. You can access the loaded UserControl via the inherited LayoutPanel.Control property.

NOTE

Loading the XAML file is delegated to the Application.LoadComponent method.

Example

The following code adds a new DocumentPanel object to a DocumentGroup, and loads the content of the "ChildPage.xaml" into this panel:

C#

DocumentPanel panel = dockLayoutManager1.DockController.AddDocumentPanel(
    documentGroup1, new Uri(@"Layouts\ChildPage.xaml", UriKind.Relative));
panel.Caption = "Page 1";

Implements

DevExpress.Xpf.Docking.IDockController.AddDocumentPanel(DocumentGroup, Uri)