AdiIRC

_Added in 4.3_

*/dock [-ug] <@window|dialog id>*

*/dock [-abgloNpNrt] [w h] <@window|dialog id>*

*/dock [-cbgloNpNrt] [w h] <container> <@window|dialog id>*

*/dock [-bgloNpNnrt] [w h] <container> <panel> <@window|dialog id>*

*/dock [-bgiloNpNrt] [w h] <container> <panel> <tab> <@window|dialog id>*

Docks/undocks a window or dialog as a [[Monitor_Panels|Monitor Panel]].

_See also [[$dockpanels]]._

*Switches*

table(ktable).

|*Switch*|*Description*|

| -a | Adds the window to any other dock panel on the specified dock side as a new tab or creates a new container and panel. |

| -b | Dock to the bottom. |

| -c | Create a new container and inserts the window at the specified side/container. |

| -g | Indicates "dialog id" specified instead of @window. |

| -i | Inserts the window into the specified side/container/panel/tab |

| -l | Dock to the left. |

| -n | Create a new panel and inserts the window at the specified side/container/panel. |

| -oN | Locks the panel. (0 = unlocked, 1 = locked, Ignored by F2 to toggle panels visibility) |

| -pN | Pins the panel. (0 = unpinned, 1 = pinned, Autohide) |

| -r | Dock to the right. |

| -t | Dock to the top. |

| -u | Undocks/restores the @window to a regular window. |

*Parameters*

table(ktable).

|*Parameter*|*Description*|

| [w h] | The preferred width and height of the panel. |

| <container> | Used with -c to insert the panel into a new container at the specified position. |

| <container> <panel> | Used with -n to insert the panel into a specific container at the specified panel position. |

| <container> <panel> <tab> | Used with -i to specify where to insert the new panel. |

| <@window<notextile>|</notextile>dialog id> | The window or dialog id to dock. |

*Example*

<pre>

alias testdock {

  ; Create a custom window.

  window @test

  ; Dock the custom window as a monitor panel to the left side, appending if there are any other panels.

  dock -al @test

  ; Restores the custom window as a normal window.

  dock -u @test

  ; Docks the custom window as a monitor panel to the top, ignoring any current panels.

  dock -t @test

}

</pre>

-