User guide

RGS properties 150
8-4-13 Windows placement and size properties
As described previously, these properties are per-session (per-connection) properties. If, for example, the Receiver
connects to two Remote Computers, these properties can be used to specify the properties of each of the two
Remote Display Windows on the Local Computer. These properties contain the parameter <N>, which ranges
from 0 to N-1 for the creation of N sessions (connections). For example, for the first session, the X position of the
Remote Display Window is specified by the property Rgreceiver.Session.0.RemoteDisplayWindow.X.
Note that these properties do not take affect until a connection is actually established to a Remote Computer.
Rgreceiver.Session.<N>.RemoteDisplayWindow.X=int (0)
Rgreceiver.Session.<N>.RemoteDisplayWindow.X.IsMutable=bool (1)
This property specifies the X position of the session N Remote Display Window, as measured from the left side of
the Local Computer display.
Rgreceiver.Session.<N>.RemoteDisplayWindow.Y=int (0)
Rgreceiver.Session.<N>.RemoteDisplayWindow.Y.IsMutable=bool (1)
This property specifies the Y position of the session N Remote Display Window, as measured from the top of the
Local Computer display.
Rgreceiver.Session.<N>.VirtualDisplay.IsPreferredResolutionEnabled=bool (0)
Rgreceiver.Session.<N>.VirtualDisplay.IsPreferredResolutionEnabled.IsMutable=bool
(1)
This property, if set true (1), enables the following preferred resolution property values to be communicated to the
Remote Computer. The default value is 0—do not enable the preferred resolution property to be communicated to
the Remote Computer.
Rgreceiver.Session.<N>.VirtualDisplay.PreferredResolutionHeight=int (0)
Rgreceiver.Session.<N>.VirtualDisplay.PreferredResolutionHeight.IsMutable=bool
(1)
See the description of the following property.
Rgreceiver.Session.<N>.VirtualDisplay.PreferredResolutionWidth=int (0)
Rgreceiver.Session.<N>.VirtualDisplay.PreferredResolutionWidth.IsMutable=bool
(1)
This property and the above property specify the preferred resolution of the Remote Display Window (in pixels).
This resolution is communicated to the Remote Computer Sender, which will attempt to adapt its resolution to
match the resolution preference of the Local Computer. If the Remote Computer is unable to match the resolution
preference of the Local Computer, a warning dialog is displayed on the Local Computer.
NOTE: The per-session property
Rgreceiver.Session.<N>.VirtualDisplay.IsPreferredResolutionEnabled takes precedence
over the per-Receiver property Rgreceiver.IsMatchReceiverResolutionEnabled. This allows
individual sessions to override the global property.