Handling behavior commands in DockableObject

Article information
Article relates to	all versions of RadControls
Created by	Telerik
Last modified	March 21, 2008
Last modified by	Fiko, Telerik

PROBLEM
The close button is displayed but clicking it does not generate any client-side event. How can I handle the event when closing the DockableObject?

DESCRIPTION
The examples listed are for the Close behavior. Shown below are the behaviors and command names that correspond to them.

Close -> Close
Pin -> Pin, Unpin
Collapse -> Expand, Collapse

SOLUTION
There are 2 ways to handle client commands in DockableObject:

1. Creating a new object and adding it to the parent(zone)

   RadDockableObject CreateDockableObject(string id)

   {

   // Create a new object with the specified id. RadDockableObject dko =

   new RadDockableObject(); dko.ID = id;

   dko.Behavior = RadDockableObjectBehaviorFlags.Close;

   // 1. add to parent

   RadDockingZone1.Controls.Add(dko);

   // 2. locate Close command

   RadDockableObjectCommand cmdClose = dko.Commands.GetByName("Close");

   if (cmdClose != null)

   {

   cmdClose.OnClientCommand = "onClientClose";

   cmdClose.AutoPostBack =

   true;

   }

   }

2. Clearing all commands and adding the one we need manually (in our case it is the Close command)

   dko.Behavior = RadDockableObjectBehaviorFlags.None;

   RadDockableObjectCommand cmdClose = new RadDockableObjectCommand("Close");

   cmdClose.OnClientCommand = "onClientClose";

   cmdClose.AutoPostBack =

   true;

   dko.Commands.Add(cmdClose);

   RadDockingZone1.Controls.Add(dko);

To call the onClientClose function, you need to add something like this in your head section of your aspx page:

 

PROBLEM
How can I handle the event when closing the RadDock?

DESCRIPTION
In RadDock "Prometheus" there is OnClientCommand client-side event which occurs when the user clicks on a command in the RadDock title bar.

SOLUTION 

Creating a dock and adding it to the parent(zone):

C#

RadDock CreateDock()

{

RadDock dock = new RadDock();

dock.UniqueName = Guid.NewGuid().ToString();

dock.ID = string.Format("RadDock{0}", dock.UniqueName);

dock.Title = "Dock";

dock.Text = string.Format("Added at {0}", DateTime.Now);

dock.Width = Unit.Pixel(300);

DockCloseCommand closeCommand = new DockCloseCommand();

closeCommand.OnClientCommand = "onClientClose";

dock.Commands.Add(closeCommand);

RadDockZone1.Controls.Add(dock);

return dock;

}

Javascript

<script type="text/javascript">

function onClientClose(dock, args)

{

alert(dock.get_id() + " : " + args.command.get_name());

}

</script>