_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>

-