Programmer Guide/Macro Library/GETDESKTOP - Revision history

Jw at 09:17, 4 June 2014

2014-06-04T09:17:12Z

← Older revision		Revision as of 11:17, 4 June 2014
Line 2:		Line 2:
	Use this function to return the coordinates and size of a particular monitor relative to the whole desktop. The desktop is the area of all attached monitors.		Use this function to return the coordinates and size of a particular monitor relative to the whole desktop. The desktop is the area of all attached monitors.

	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. You can use the [[Programmer_Guide/Command_Reference/MESSAGE#~~DESKTOP~~\|MESSAGE DESKTOP]] command to retrieve the width of all monitors (i.e. the desktop width) and the number of monitors on the system.		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. You can use the [[Programmer_Guide/Command_Reference/MESSAGE#MESSAGE_DESKTOP\|MESSAGE DESKTOP]] command to retrieve the width of all monitors (i.e. the desktop width) and the number of monitors on the system.

	==== <code>GETDESKTOP [ <var>monitor</var> ] ; [ <var>left</var> <var>top</var> <var>right</var> <var>bottom</var> ]</code> ====		==== <code>GETDESKTOP [ <var>monitor</var> ] ; [ <var>left</var> <var>top</var> <var>right</var> <var>bottom</var> ]</code> ====

193.171.195.15 at 14:09, 15 May 2012

2012-05-15T14:09:37Z

← Older revision		Revision as of 16:09, 15 May 2012
Line 2:		Line 2:
	Use this function to return the coordinates and size of a particular monitor relative to the whole desktop. The desktop is the area of all attached monitors.		Use this function to return the coordinates and size of a particular monitor relative to the whole desktop. The desktop is the area of all attached monitors.

	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.		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. You can use the [[Programmer_Guide/Command_Reference/MESSAGE#DESKTOP\|MESSAGE DESKTOP]] command to retrieve the width of all monitors (i.e. the desktop width) and the number of monitors on the system.

	You can use the ~~<code>~~MESSAGE DESKTOP~~</code>~~ command to retrieve the width of all monitors (i.e. the desktop width) and the number of monitors on the system.

	==== <code>GETDESKTOP [ <var>monitor</var> ] ; [ <var>left</var> <var>top</var> <var>right</var> <var>bottom</var> ]</code> ====		==== <code>GETDESKTOP [ <var>monitor</var> ] ; [ <var>left</var> <var>top</var> <var>right</var> <var>bottom</var> ]</code> ====

193.171.195.15 at 14:08, 15 May 2012

2012-05-15T14:08:22Z

← Older revision		Revision as of 16:08, 15 May 2012
Line 1:		Line 1:
	{{DISPLAYTITLE:{{SUBPAGENAME}}}}__NOTOC__		{{DISPLAYTITLE:{{SUBPAGENAME}}}}__NOTOC__

	Use this function to return the coordinates and size of a particular monitor relative to the whole desktop. The desktop is the area of all attached monitors.		Use this function to return the coordinates and size of a particular monitor relative to the whole desktop. The desktop is the area of all attached monitors.

193.171.195.15 at 14:02, 15 May 2012

2012-05-15T14:02:55Z

← Older revision		Revision as of 16:02, 15 May 2012
Line 14:		Line 14:
	::Default: all 0		::Default: all 0

	~~====~~Result~~:====~~		;Result: The window coordinates '<code>xOrigin yOrigin width height</code>'
	:The window coordinates '<code>xOrigin yOrigin width height</code>'
			;see also: [[Programmer Guide/Macro Library/GETMONITOR\|GETMONITOR]], GETWINDOWPOS, [[Programmer Guide/Macro Library/SETWINDOWPOS\|SETWINDOWPOS]]

	====Examples====		====Examples====
Line 29:		Line 30:
	#result := GETDESKTOP 1		#result := GETDESKTOP 1
	</pre>		</pre>
	~~;see also: [[Programmer Guide/Macro Library/GETMONITOR\|GETMONITOR]], GETWINDOWPOS, [[Programmer Guide/Macro Library/SETWINDOWPOS\|SETWINDOWPOS]]~~

193.171.195.15 at 14:02, 15 May 2012

2012-05-15T14:02:12Z

← Older revision		Revision as of 16:02, 15 May 2012
Line 29:		Line 29:
	#result := GETDESKTOP 1		#result := GETDESKTOP 1
	</pre>		</pre>
	;~~'''~~see also~~'''~~: [[Programmer Guide/Macro Library/GETMONITOR\|GETMONITOR]], GETWINDOWPOS, [[Programmer Guide/Macro Library/SETWINDOWPOS\|SETWINDOWPOS]]		;see also: [[Programmer Guide/Macro Library/GETMONITOR\|GETMONITOR]], GETWINDOWPOS, [[Programmer Guide/Macro Library/SETWINDOWPOS\|SETWINDOWPOS]]

193.171.195.15 at 14:01, 15 May 2012

2012-05-15T14:01:53Z

← Older revision		Revision as of 16:01, 15 May 2012
Line 29:		Line 29:
	#result := GETDESKTOP 1		#result := GETDESKTOP 1
	</pre>		</pre>
	~~=====~~see also:~~=====~~		;'''see also''': [[Programmer Guide/Macro Library/GETMONITOR\|GETMONITOR]], GETWINDOWPOS, [[Programmer Guide/Macro Library/SETWINDOWPOS\|SETWINDOWPOS]]

	[[Programmer Guide/Macro Library/GETMONITOR\|GETMONITOR]], GETWINDOWPOS, [[Programmer Guide/Macro Library/SETWINDOWPOS\|SETWINDOWPOS]]

193.171.195.15 at 13:57, 15 May 2012

2012-05-15T13:57:41Z

← Older revision		Revision as of 15:57, 15 May 2012
Line 11:		Line 11:
	:;<var>monitor</var> :The monitor to get the desktop coordinates for.		:;<var>monitor</var> :The monitor to get the desktop coordinates for.
	::Default: the primary monitor.		::Default: the primary monitor.
	:;<var>left, top, right, bottom</var> :The percentage of the screen by which to shrink the left, right, top and bottom coordinates. These values must be 0 <= margin <= 40.		:;<var>left, top, right, bottom</var> :The percentage of the screen by which to shrink the left, right, top and bottom coordinates. These values must be 0 <= margin <= 40. If an invalid value is passed, it is set to zero.
	::Default: all 0		::Default: all 0

	=====Result:=====		====Result:====
			:The window coordinates '<code>xOrigin yOrigin width height</code>'

	~~The window coordinates "<code>xOrigin yOrigin width height</code>".~~		====Examples====

	=====Examples:=====

	<pre>		<pre>
	#result := $(GETDESKTOP)		#result := GETDESKTOP
	</pre>		</pre>
	For a system with a primary monitor with a resolution of 1024x768, #result will contain the values <code>0 0 1024 768</code>		For a system with a primary monitor with a resolution of 1024x768, #result will contain the values <code>0 0 1024 768</code>
Line 28:		Line 27:

	<pre>		<pre>
	#result := $(GETDESKTOP 1)		#result := GETDESKTOP 1
	</pre>		</pre>
	=====see also:=====		=====see also:=====

	[[Programmer Guide/Macro Library/GETMONITOR\|GETMONITOR]], GETWINDOWPOS, [[Programmer Guide/Macro Library/SETWINDOWPOS\|SETWINDOWPOS]]		[[Programmer Guide/Macro Library/GETMONITOR\|GETMONITOR]], GETWINDOWPOS, [[Programmer Guide/Macro Library/SETWINDOWPOS\|SETWINDOWPOS]]

193.171.195.15 at 13:54, 15 May 2012

2012-05-15T13:54:14Z

← Older revision		Revision as of 15:54, 15 May 2012
Line 3:		Line 3:
	Use this function to return the coordinates and size of a particular monitor relative to the whole desktop. The desktop is the area of all attached monitors.		Use this function to return the coordinates and size of a particular monitor relative to the whole desktop. The desktop is the area of all attached monitors.

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

	You can use the <code>MESSAGE DESKTOP</code> command to retrieve the width of all monitors (i.e. the desktop width) and the number of monitors on the system.		You can use the <code>MESSAGE DESKTOP</code> command to retrieve the width of all monitors (i.e. the desktop width) and the number of monitors on the system.

	==== <code>GETDESKTOP [ <var>monitor</var> ] ; [ <var>left</var> <var>top</var> <var>right</var> <var>bottom</var> ]</code>		==== <code>GETDESKTOP [ <var>monitor</var> ] ; [ <var>left</var> <var>top</var> <var>right</var> <var>bottom</var> ]</code> ====

	~~=====Parameters~~:~~=====~~		:;<var>monitor</var> :The monitor to get the desktop coordinates for.
			::Default: the primary monitor.
	;<var>monitor</var>		:;<var>left, top, right, bottom</var> :The percentage of the screen by which to shrink the left, right, top and bottom coordinates. These values must be 0 <= margin <= 40.
			::Default: all 0
	:The monitor to get the desktop coordinates for. Default is the ~~Primary Monitor~~.

	;<var>left, top, right, bottom</var>

	:The percentage of the screen by which to shrink the left, right, top and bottom coordinates. These values must be 0 <= margin <= 40.

	=====Result:=====		=====Result:=====

193.171.195.15 at 13:50, 15 May 2012

2012-05-15T13:50:46Z

← Older revision		Revision as of 15:50, 15 May 2012
Line 1:		Line 1:
	{{DISPLAYTITLE:{{SUBPAGENAME}}}}__NOTOC__		{{DISPLAYTITLE:{{SUBPAGENAME}}}}__NOTOC__
	~~==GETDESKTOP==~~

	Use this function to return the coordinates and size of a particular monitor relative to the whole desktop. The desktop is the area of all attached monitors.		Use this function to return the coordinates and size of a particular monitor relative to the whole desktop. The desktop is the area of all attached monitors.
Line 8:		Line 7:
	You can use the <code>MESSAGE DESKTOP</code> command to retrieve the width of all monitors (i.e. the desktop width) and the number of monitors on the system.		You can use the <code>MESSAGE DESKTOP</code> command to retrieve the width of all monitors (i.e. the desktop width) and the number of monitors on the system.

	====~~=Usage:=====~~		==== <code>GETDESKTOP [ <var>monitor</var> ] ; [ <var>left</var> <var>top</var> <var>right</var> <var>bottom</var> ]</code>

	<code>GETDESKTOP [ <var>monitor</var> ] ; [ <var>left</var> <var>top</var> <var>right</var> <var>bottom</var> ]</code>

	=====Parameters:=====		=====Parameters:=====

193.171.195.15 at 13:49, 15 May 2012

2012-05-15T13:49:55Z

← Older revision		Revision as of 15:49, 15 May 2012
Line 1:		Line 1:
	{{DISPLAYTITLE:{{SUBPAGENAME}}}}		{{DISPLAYTITLE:{{SUBPAGENAME}}}}__NOTOC__
	==GETDESKTOP==		==GETDESKTOP==