Programmer Guide/Macro Library/GETMONITOR: Difference between revisions
From STX Wiki
Jump to navigationJump to search
No edit summary |
No edit summary |
||
| Line 6: | Line 6: | ||
====<code>GETMONITOR [ <var>wnd</var> ]</code>==== | ====<code>GETMONITOR [ <var>wnd</var> ]</code>==== | ||
:;<var>wnd</var>: The name of a display or dialog item to be located. | :;<var>wnd</var>: The name of a display or dialog item to be located. | ||
;Result:If <var>wnd</var> was given, the monitor on which <var>wnd</var> is, otherwise, the '''primary monitor'''. Note that if there is more than one monitor on the system, the monitor range is <code>1</code> to <code>numberOfMonitors</code> ( | ;Result:If <var>wnd</var> was given, the monitor on which <var>wnd</var> is, otherwise, the '''primary monitor'''. Note that if there is more than one monitor on the system, the monitor range is <code>1</code> to <code>numberOfMonitors</code> (see [[Programmer_Guide/Command_Reference/MESSAGE#DESKTOP|MESSAGE DESKTOP]]). | ||
;see also: [[Programmer Guide/Macro Library/GETWINDOWPOS|GETWINDOWPOS]], [[Programmer Guide/Macro Library/SETWINDOWPOS|SETWINDOWPOS]], [[Programmer Guide/Macro Library/GETDESKTOP|GETDESKTOP]] and MSG DESKTOP | ;see also: [[Programmer Guide/Macro Library/GETWINDOWPOS|GETWINDOWPOS]], [[Programmer Guide/Macro Library/SETWINDOWPOS|SETWINDOWPOS]], [[Programmer Guide/Macro Library/GETDESKTOP|GETDESKTOP]] and MSG DESKTOP | ||
Revision as of 15:07, 15 May 2012
This function returns the primary monitor if the parameter wnd is not given, otherwise it returns the monitor on which most of the window wnd is.
The Primary Monitor is a Windows concept. This is the monitor on which dialogs are centred by default and the application task bar appears. The Windows API (Application Programming Interface) returns the origin coordinates 0,0 for the upper left hand corner of the Primary monitor. This means that monitors left of the primary monitor have negative coordinates.
GETMONITOR [ wnd ]
- wnd
- The name of a display or dialog item to be located.
- Result
- If wnd was given, the monitor on which wnd is, otherwise, the primary monitor. Note that if there is more than one monitor on the system, the monitor range is
1tonumberOfMonitors(see MESSAGE DESKTOP). - see also
- GETWINDOWPOS, SETWINDOWPOS, GETDESKTOP and MSG DESKTOP
