-wp <placement spec>
-wpx <placement spec>
The -wp command line switch is used to override the default window position. The -wpx switch does the same thing with some additional capabilities. See "WPX Enhancements" below.
The placement spec is made up of an optional monitor identifier prefix and a window position spec within that monitor. Monitor identifiers consist of the prefix letter "m", followed by a character from the set of (l,r,t,b,c) indicating left,right,top,bottom or center, followed by a colon:
Spec |
Placement |
ml |
left-most monitor |
mr |
right-most monitor |
mt |
top-most monitor |
mb |
bottom-most monitor |
mc |
center monitor |
If not specified, or if the system has only one display monitor, the primary monitor is used.
The window position spec consists of one or two characters from the same (l,r,t,b,c) set, followed optionally by one or two digits indicating the division of the vertical or horizontal space on the monitor. By convention, vertical position specifiers should precede horizontal (i.e. use "tl" for top left instead of "lt" for left top). The divisor digit(s) default to 2 if not specified. Some examples:
Spec |
Placement |
t |
use top half of monitor; same as t2 |
br |
use bottom right quadrant; same as br22 |
bc23 |
bottom half, center third of monitor |
cc |
centered vertically and horizontally, half width and height |
WPX Enhancements
Action is the same as for -wp except that the -wpx version also does the following:
• | restricts dialogs to the boundaries of the main window |
• | disables saving updated dialog positions (for MBF2_DLGSTATE and OPTIONS=AUTODLGSTATE). |
• | disables application-level saving of current window settings via the AG_WINSETTINGS command. |
Examples
-wp ml:l2 ! window occupies the left half of the left-most monitor
-wpx ml:l2 ! window gets the left 60% of primary monitor
-wp ml:l2 ! window gets the bottom right 40% of right monitor
History
2023 November, A-Shell 7.0.1751: Function added to A-Shell.