Docking Toolbars/System Modules
The Toolbars and the System Modules of Telerik RadEditor can be dragged and docked on the edges of the editable area, just like in Microsoft Office applications. This give users the freedom to organize the workspace according to their personal preferences.
To drag a dockable object (Toolbar/System Module), you need to click and hold its drag zone:
The dockable objects can be docked to one of five Docking Zones as shown in the image below:
When you drag a dockable object (Toolbar or System Module) over another dockable object within a certain Docking Zone, the dragged one will be placed before the other one. By "before" we mean "above" or "to the left", depending on the available space and the docking zone orientation (horizontal or vertical).
Please, note that you can set some Toolbars or System Modules to be dockable and others not to be. You can specify it in the ToolsFile. In addition, also in the ToolsFile you can set the default docking zone for each dockable object in the .
 |
If you don't specify a Docking Zone for a dockable object, it will be docked in the Top zone. |
Undocking Toolbars
If you drop a dockable object (Toolbar/System Module) outside the docking areas, i.e. over the content area or outside the editor, the object will be undocked. You can dock it back by clicking the 
button. To dock all Toolbars/System Modules back to their respective Docking Zones, click the 
button.
 |
Important note: when you undock one or more toolbars, Telerik RadEditor will preserve their docking state and position between postbacks, so that your workspace remains the way you have customized it.
Telerik RadEditor uses cookies to store the toolbar state and positions, as well as to identify which toolbars pertain to a given instance of the editor. The editors are identified by their ID.
Due to the above fact, if a given editor has an identical ID with an editor on another page in your applications (e.g. ID="editor1"), the following effect will appear: if you undock the toolbars of the first editor and navigate to the other page, the toolbars of the second editor will have the docking state and positions of the first editor.
This may be a desired behavior, so in order to achieve it you have to set those editors with identical IDs.
If you want to avoid this behavior, you need to provide different IDs for the respective editors on the different pages of your application. |
 |
You can display all Toolbars (not Modules) in one floating window. This however, is controlled by the ToolsOnPage property and has nothing to do with docking. For more information see Floating Toolbars. |