Pin command

From m204wiki
Revision as of 23:21, 3 February 2023 by Ekern (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search
Action:

Pins the specified Client external window(s), that is, keeps the window(s) at the top of the Client PC's open window stack. Such a window can be moved by mouse around the screen, and it can be joined by other pinned windows. It remains at the top as long as it is open, even if other external windows or applications are subsequently opened. It can only be removed from the top by closing it, by unpinning it (the unpin command), or by clicking its upper right corner "Minimize" button.

Syntax:

pin {windowname | pattern | *}

where you must specify one of these:

  • windowname, the (case not important) name, or title, at the top of a Client work window or external window
  • pattern, a character sequence that ends with an asterisk (*), which performs a "wildcard" search ab* finds the About window)
  • A lone asterisk (*), which pins all open external windows

If you pin a window that is already pinned, the command is ignored. If the command indicates a window that is missing or invalid, or if it does not match an open external window, an error message is issued.

Client menu: Context menu option (Pin) of external window title bar
Introduced: Build 56