Skip to main content

BaseDocument.ControlName Property

Gets or sets the name of a control that will be passed to the current Document as content.

Namespace: DevExpress.XtraBars.Docking2010.Views

Assembly: DevExpress.XtraBars.v24.1.dll

NuGet Package: DevExpress.Win.Navigation


public string ControlName { get; set; }

Property Value

Type Default Description
String null

A String value that specifies the name of a control to be passed to the current Document as content.


Your may want to set your own User Controls as the Document content. The image below illustrates an application example with 3 UserControls included in the solution:

DocumentManager - ControlName Hierarchy

Now we can run the Document Manager Designer, switch to its ‘Documents’ tab and click the ‘Populate’ button. A Document for each of the UserControls is generated automatically:

DocumentManager - ControlName Populate Button

Notice that each Document has its ControlName and BaseDocument.ControlTypeName properties specified. These properties refer to a corresponding UserControl by its name and type respectively. In spite of this relation, Documents have no content yet. Call the BaseView.AddDocument overload method and pass a new instance of a UserControl as the control parameter before the form is shown:

public partial class Form1 : Form {
    public Form1() {
        documentManager1.View.AddDocument(new UserControls.UserControl1());
        documentManager1.View.AddDocument(new UserControls.UserControl2());
        documentManager1.View.AddDocument(new UserControls.UserControl3());

This won’t create any new Documents. Instead, required UserControls will be passed to corresponding Documents as their content.

You can also create a Document that refers to a UserControl by name via the BaseView.AddDocument overload method that takes 2 string parameters.

The BaseView.AddDocument(Control, String) method assigns a Control.Name property value the ControlName property when you use this method to create documents.

See Also