Table of Contents

Dockable Property Settings

Dockable items such as documents, tools and docks implement the IDockable interface. This interface exposes a number of properties that control how each item behaves at runtime. Most of these flags can be set in XAML or on your view models.

Available properties

Property Description
Id Unique identifier used by the serializer and factory helpers.
Title Text shown on tabs and windows.
Context Optional data context associated with the dockable.
Owner The dock or window currently hosting the item.
OriginalOwner Where the dockable was first created. Used when restoring pinned tools.
Factory Factory instance used to create and manage the layout.
IsEmpty Indicates a placeholder dockable with no content.
IsCollapsable When false, the dock will remain even if it contains no children.
Proportion Size ratio used by ProportionalDock.
Dock The default docking mode for this dockable (DockMode).
Column Grid column index when hosted in a grid dock.
Row Grid row index when hosted in a grid dock.
ColumnSpan Grid column span when hosted in a grid dock.
RowSpan Grid row span when hosted in a grid dock.
IsSharedSizeScope Participates in shared size scope when hosted in a grid dock.
CollapsedProportion Last known proportion before a dock is collapsed.
MinWidth Optional minimum width. Overrides the current proportion if larger.
MaxWidth Optional maximum width. Overrides the proportion if smaller.
MinHeight Optional minimum height. Overrides the current proportion if larger.
MaxHeight Optional maximum height. Overrides the proportion if smaller.
CanClose Whether the user can close the dockable via UI commands.
CanPin Allows pinning and unpinning of tools.
KeepPinnedDockableVisible Keeps pinned previews visible instead of auto-hiding.
CanFloat Controls if the item may be detached into a floating window.
CanDrag Enables dragging the dockable to another position.
CanDrop Determines if other dockables can be dropped onto this one.
CanDockAsDocument Controls whether the dockable can be docked as a tabbed document.
IsModified Marks a dockable as having unsaved changes.
DockGroup Group identifier that restricts which dockables can dock together. See Docking Groups.
AllowedDockOperations Allowed docking operations when the dockable is dragged (DockOperationMask).
AllowedDropOperations Allowed docking operations when the dockable is the drop target (DockOperationMask).

Sample usage

The properties can be configured directly on your view models when creating the layout:

var errorsTool = new ToolViewModel
{
    Id = "Errors",
    Title = "Errors",
    CanDrag = false,
    CanFloat = false,
    CanClose = false
};

In XAML you set them as attributes:

<Tool x:Name="SolutionExplorer"
      Id="SolutionExplorer"
      Title="Solution Explorer"
      CanPin="False"
      CanFloat="True" />

Global drag and drop behavior can be toggled using the attached properties from Dock.Settings:

<Window xmlns:dockSettings="clr-namespace:Dock.Settings;assembly=Dock.Settings"
        dockSettings:DockProperties.IsDragEnabled="False"
        dockSettings:DockProperties.IsDropEnabled="False">
    <DockControl />
</Window>

For reference, the FAQ shows how these properties interact with the default templates.

Edit this page