Project

General

Profile

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> 

 -