Edit this page

Pinned/Unpinned Panes

Each RadPane provides built-in pin/unpin functionality that allows you to control the behavior and the visualization of the docked RadPanes during run-time.

By default this functionality is enabled and when a RadPane is docked, pin/unpin toggle button is created and placed at its upper right corner. To toggle the pinned state of a certain RadPane just click the button, highlighted on the snapshot below.

You can also change the pin state of a RadPane programmatically using the RadPane's boolean property IsPinned.

XAML

<telerik:RadPane x:Name="radPane" IsPinned="True"/>

C#

radPane.IsPinned = true;

VB.NET

radPane.IsPinned = True

You can also pin/unpin all of the panes inside of a RadPaneGroup using the methods group.PinAllPanes()/group.UnpinAllPanes().

Pinned Panes

You can recognize that a docked RadPane is pinned if it is visible all the time, even if your mouse cursor is not over it. On the snapshot below you can see two pinned RadPanes docked to the left and to the right side of the docking container. Note that the pin icon of the toggle button is pointing downwards.

Unpinned Panes

The unpinned RadPane is shown only when the mouse cursor is over it and is hidden when the cursor leaves its area. When it is hidden you can only see its tab header placed in the auto hide area, while when shown, it is slided on the top of all the other controls without affecting the overall layout.

On the snapshot below you can see two unpinned RadPanes; the first is a "Toolbox" docked to the left, the second is a "Solution Explorer" docked respectively to the right. You can see that all their content is hidden, except their tab headers placed in the auto hide area.

If you hover your mouse over the tab of the "Toolbox" pane, it will slide automatically overlapping the other content. Note that the pin icon of the toggle button is pointing sideways.

If you want to control the auto hide width and the auto hide hight of your unpinned panes use the respective RadPane's properties AutoHideHeight and AutoHideWidth.

Disabling Pin

If you don't want your RadPanes to be pinnable just set the CanUserPin property to False. Once disabled the user will not be able to change the pin state of the RadPane run-time because the toggle button will be hidden.

XAML

<telerik:RadPane x:Name="radPane1" CanUserPin="False"/>

C#

radPane.CanUserPin = false;

VB.NET

radPane.CanUserPin = False

See Also