InitialLocationProperty Field

Identifies the InitialLocation attached dependency property

Syntax

Visual Basic

'Declaration
 
Public Shared ReadOnly InitialLocationProperty As DependencyProperty

C#

public static readonly DependencyProperty InitialLocationProperty

Example

This sample demonstrates how to use the InitialLocation attached property to determine the location for a root SplitPane within the XamDockManager.

Visual Basic

Imports Infragistics.Windows.DockManager

Private Sub InitializeDockManager(ByVal dockManager As XamDockManager)
    ' The InitialLocation attached property is used to set the starting 
    ' location for the split pane. Once initialied, this property cannot 
    ' be changed. 
    Dim splitTop As New SplitPane()

    ' Panes can be docked to any edge within the xamdockmanager 
    ' using the "Docked" enum values 
    XamDockManager.SetInitialLocation(splitTop, InitialPaneLocation.DockedTop)
    Dim cpTopPinned As New ContentPane()
    cpTopPinned.Header = "Docked Top"
    cpTopPinned.Content = New TextBox()
    splitTop.Panes.Add(cpTopPinned)

    ' Only docked panes can be unpinned. A tab item representing 
    ' the item will be positioned pane will be displayed in the 
    ' unpinned tab area based on the "edge" to which the pane 
    ' is displayed when pinned 
    Dim cpTopUnpinned As New ContentPane()
    cpTopUnpinned.IsPinned = False
    cpTopUnpinned.Header = "Unpinned"
    cpTopUnpinned.Content = New TextBox()
    splitTop.Panes.Add(cpTopUnpinned)

    ' Panes can be displayed in a floating window outside the bounds 
    ' of the dockmanager using the DockableFloating or FloatingOnly 
    ' values 
    Dim splitFloat As New SplitPane()
    XamDockManager.SetInitialLocation(splitFloat, InitialPaneLocation.FloatingOnly)
    Dim cpFloat As New ContentPane()
    cpFloat.Header = "Started Floating Only"
    Dim tbFloat As New TextBox()
    tbFloat.Text = "Control in floating pane"
    cpFloat.Content = tbFloat
    splitFloat.Panes.Add(cpFloat)

    dockManager.Panes.Add(splitTop)
    dockManager.Panes.Add(splitFloat)
End Sub

C#

using Infragistics.Windows.DockManager;

private void InitializeDockManager(XamDockManager dockManager)
{
	// The InitialLocation attached property is used to set the starting 
	// location for the split pane. Once initialied, this property cannot 
	// be changed.
	SplitPane splitTop = new SplitPane();

	// Panes can be docked to any edge within the xamdockmanager
	// using the "Docked" enum values
	XamDockManager.SetInitialLocation(splitTop, InitialPaneLocation.DockedTop);
	ContentPane cpTopPinned = new ContentPane();
	cpTopPinned.Header = "Docked Top";
	cpTopPinned.Content = new TextBox();
	splitTop.Panes.Add(cpTopPinned);

	// Only docked panes can be unpinned. A tab item representing 
	// the item will be positioned pane will be displayed in the 
	// unpinned tab area based on the "edge" to which the pane 
	// is displayed when pinned
	ContentPane cpTopUnpinned = new ContentPane();
	cpTopUnpinned.IsPinned = false;
	cpTopUnpinned.Header = "Unpinned";
	cpTopUnpinned.Content = new TextBox();
	splitTop.Panes.Add(cpTopUnpinned);

	// Panes can be displayed in a floating window outside the bounds 
	// of the dockmanager using the DockableFloating or FloatingOnly 
	// values
	SplitPane splitFloat = new SplitPane();
	XamDockManager.SetInitialLocation(splitFloat, InitialPaneLocation.FloatingOnly);
	ContentPane cpFloat = new ContentPane();
	cpFloat.Header = "Started Floating Only";
	TextBox tbFloat = new TextBox();
	tbFloat.Text = "Control in floating pane";
	cpFloat.Content = tbFloat;
	splitFloat.Panes.Add(cpFloat);

	dockManager.Panes.Add(splitTop);
	dockManager.Panes.Add(splitFloat);
}

XAML

<igDock:XamDockManager>
    <!-- The InitialLocation attached property is used to set the starting 
         location for the split pane. Once initialied, this property cannot 
         be changed. -->
    <igDock:XamDockManager.Panes>
        <!-- Panes can be docked to any edge within the xamdockmanager
             using the "Docked" enum values -->
        <igDock:SplitPane igDock:XamDockManager.InitialLocation="DockedTop">
            <igDock:ContentPane Header="Docked Top">
                <TextBox />
            </igDock:ContentPane>
            <!-- Only docked panes can be unpinned. A tab item representing 
                 the item will be positioned pane will be displayed in the 
                 unpinned tab area based on the "edge" to which the pane 
                 is displayed when pinned. -->
            <igDock:ContentPane Header="Unpinned" IsPinned="False">
                <TextBox />
            </igDock:ContentPane>
        </igDock:SplitPane>
        
        <!-- Panes can be displayed in a floating window outside the bounds 
             of the dockmanager using the DockableFloating or FloatingOnly 
             values -->
        <igDock:SplitPane igDock:XamDockManager.InitialLocation="FloatingOnly">
            <igDock:ContentPane Header="Started Floating Only">
                <TextBox Text="Control in floating pane" />
            </igDock:ContentPane>
        </igDock:SplitPane>
    </igDock:XamDockManager.Panes>
</igDock:XamDockManager>

Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2