Getting Started
EO.Pdf
EO.Web
EO.WebBrowser
EO.Wpf
- Overview
- Installation & Deployement
- Skin & Theme
- Common Taskes and Services
- EO.Wpf Buttons
- EO.Wpf Calendar & DatePicker
- EO.Wpf ComboBox
- EO.Wpf DockView
  - EO.Wpf DockView
  - Getting Started
  - Regular Dock View and Document View
  - Saving/Loading Layout
  - Activating a Dock Item
- EO.Wpf Gauge
- EO.Wpf ListBox
- EO.Wpf Menu
- EO.Wpf MaskedEdit
- EO.Wpf ProgressBar
- EO.Wpf Slider
- EO.Wpf SpinEdit
- EO.Wpf SplitView
- EO.Wpf TabControl
- EO.Wpf TreeView
- EO.Wpf Utility Controls
- EO.Wpf WindowChrome
- Sample Data Objects
Common Topics
Reference

Table of Contents

Activating a DockItem

call DockContainer.ActivateItem to activate a dock item:

Copy

//Activate "Property View"
DockContainer.ActivateItem("PropertyView");

'Activate "Property" Window
DockContainer.ActivateItem("PropertyWindow")

The above code searches for a DockItem whose ItemId matches "PropertyView" in all loaded DockItem objects. If it can find it, then it calls the DockItem's Activate method to activate the dock item.

If no matching DockItem is found, the DockContainer first raises DockViewNeeded event, then DockItemNeeded event to allow you to create the DockView object for the item, and the DockItem object respectively. You must handle these two events in order to for ActivateItem to be able to dynamically load new items.

The following code demonstrates how to handle DockViewNeeded event:

XAML

Visual Basic.NET

Copy

<eo:DockContainer x:Name="DockContainer1" DockViewNeeded="DockContainer_DockViewNeeded" ...>
....
</eo:DockContainer>

private DockView DockContainer_DockViewNeeded(object sender, DockViewNeededEventArgs e)
{
    //If the ItemId starts with "file://", then we load it
    //into the document view
    if (e.ItemId.StartsWith("file://"))
        e.DockView = DockContainer1.GetDocumentView();
    else
    {
        //Otherwsie creates a new view and dock it to the right 
        DockView view = new DockView();
        view.Width = 150;
        view.Dock = Dock.Right;
        e.DockView = view;
    }
}

Private Function DockContainer_DockViewNeeded(sender As Object, e As DockViewNeededEventArgs) As DockView
    'If the ItemId starts with "file://", then we load it
    'into the document view
    If e.ItemId.StartsWith("file://") Then
        e.DockView = DockContainer1.GetDocumentView()
    Else
        'Otherwsie creates a new view and dock it to the right
        Dim view As New DockView()
        view.Width = 150
        view.Dock = Dock.Right
        e.DockView = view
    End If
End Function

The above code also demonstrated a technique that you can either create a new view, or simply return an existing view based on the item id passed in to ActivateItem method.

Once the DockView is created, DockContainer raises DockItemNeeded event. You must also handle this event to create the new item:

XAML

Visual Basic.NET

Copy

<eo:DockContainer x:Name="DockContainer1" DockItemNeeded="DockContainer_DockItemNeeded" ...>
....
</eo:DockContainer>

private DockView DockContainer_DockItemNeeded(object sender, DockItemNeededEventArgs e)
{
    //Create different type of DockItem object based on item Id
    switch (e.ItemId)
    {
        case "PropertyWindow":
            e.Item = new PropertyWindow();        
            
        ....
    }
}

Private Function DockContainer_DockItemNeeded(sender As Object, e As DockItemNeededEventArgs) As DockView
    'Create different type of DockItem object based on item Id
    Select Case e.ItemId
        Case "PropertyWindow"
            e.Item = New PropertyWindow()
            
        ....
    End Select
End Function

Here PropertyWindow is a class that derives from DockItem and contains the corresponding UI elements for editing properties.

You can also load a DockView from an XAML file by calling DockItem.LoadFrom method:

Visual Basic.NET

Copy

//Load a DockItem from an XAML file
e.Item = DockItem.LoadFrom(new Uri("EO.Wpf.Demo;component/DemoDockItem.xaml", UriKind.Relative));

'Load a DockItem from an XAML file
e.Item = DockItem.LoadFrom(New Uri("EO.Wpf.Demo;component/DemoDockItem.xaml", UriKind.Relative))

The ActivateItem method returns the DockItem that has been activated. So you can use the returned value to perform additional initializations if needed:

Visual Basic.NET

Copy

//Activate "Property View"
PropertyWindow propertyWindow = (PropertyWindow)DockContainer.Activate("PropertyView");

//Perform additional initializations
propertyWindow.Content = ....

Dim propertyWindow As PropertyWindow = DirectCast(DockContainer.Activate("PropertyView"), PropertyWindow)

'Perform additional initializations
propertyWindow.Content = ....

Table of Contents

Message