Project

General

Profile

Actions

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 Panel.

See also $dockpanels.

Switches

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

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|dialog id> The window or dialog id to dock.

Example

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
}

-

Updated by Per Amundsen over 1 year ago · 19 revisions

Also available in: PDF HTML TXT