User Interface for .NET > User's Guide > Docking Panels > Docking Panels |
A generic docking panel.
Nevron Docking Panels are predefined controls meant to provide true WYSIWYG docking functionality. The rich yet easy to use interface-based object model makes it very simple to provide your custom functionality and extend appearance.
Nevron docking panels are fully programmable - all functionality can be achieved either visually or from code.
The following table describes available public methods regarding docking functionality:
Method | Description |
---|---|
![]() |
Activates the panel and gives it keyboard focus. |
![]() |
Closes the panel and removes it from the docking framework. |
![]() |
Shows a previously hidden panel. Use this method instead of changing panel's visibility directly. |
![]() |
Makes the panel floating. |
![]() |
Maximizes the panel within its parent zone. |
![]() |
Docks the panel to the specified INDockZone using the specified DockStyle at the desired index. |
![]() |
Toggles the current state of the panel - if the DockState is Floating the method restores a previously saved docked state, else the panel is made floating. |
![]() |
Invalidates and updates the caption area of the panel. |
![]() |
Displays a context sensitive menu for the panel at the specified screen location. |
![]() |
Performs re-measure and repaint of the caption area. |
Each docking panel fires lots of notifications which, if not handled, are bubbled up to the manager that the panel is attached to.
The following table describes available notifications fired by a NDockingPanel control:
Notification | Description |
---|---|
![]() |
Notifies that the panel has been activated and received keyboard focus. |
![]() |
Notifies that a panel is about to be activated. |
![]() |
Notifies that a panel has been floated. |
![]() |
Notifies that a panel has been docked. |
![]() |
Notifies that a panel is about to be docked. Cancelable. |
![]() |
Notifies that a panel is about to be floated. Cancelable. |
![]() |
Notifies of a drag operation start upon a panel. |
![]() |
Notifies that a caption button has been clicked. The event arguments contain information about the button id. |
![]() |
Notifies that a panel has been deactivated. |
![]() |
Notifies that a panel is about to be deactivated. |
![]() |
Notifies that a panel is being dragged. Cancelable. |
![]() |
Notifies for an end of a drag operation upon a panel. |
![]() |
All notifications are also available at the manager's level. Signature is the same except that all event names begin with "Panel" - for example Activated will be PanelActivated. |
A NDockingPanel can be applied a set of permissions controlling its behaviour. Those permissions are exposed via panel's Permissions property.
The following table describes these permissions:
Permission | Description |
---|---|
![]() |
Specifies whether the panel can be dragged. |
![]() |
Specifies whether the panel can be floated. |
![]() |
Specifies whether the panel can be hidden (closed). |
![]() |
Specifies whether the panel can be maximized using the Maximize method. |
![]() |
By default the context menu for a panel shows these permissions as commands. You can, however, specify whether Permissions are Editable to prevent any change. |