Dock » History » Revision 18
Revision 17 (Per Amundsen, 05/10/2022 04:40 PM) → Revision 18/19 (Per Amundsen, 05/10/2022 04:41 PM)
_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*
-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*
[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|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>
-