Format of Status Information

Personal Communications returns the session status as text in CF_TEXT format. The following fields are returned with the following possible values:

Fields Returned Values Description
Status Closed, Invisible, Maximized, Minimized, Normal The window is in one of these states.
Usage DDE, User The session is connected in either a DDE session or a user session.
ScreenX NN Defines the horizontal size of the screen.
ScreenY NN Defines the vertical size of the screen.
CursorX NN Defines the horizontal position of the cursor. (0 … ScreenX – 1)
CursorY NN Defines the vertical position of the cursor. (0 … ScreenY – 1)
TrimRect Status Closed, Moved, Sized The current status of the trim rectangle.
Trim Rectangle X1 N The top-left corner X position of the trim rectangle in character coordinates.
Trim Rectangle Y1 N The top-left corner Y position of the trim rectangle in character coordinates.
Trim Rectangle X2 N The lower-right corner X position of the trim rectangle in character coordinates.
Trim Rectangle Y2 N The lower-right corner Y position of the trim rectangle in character coordinates.
Session Presentation Space Status N The current status of the presentation space. The following values are possible:
0:
The presentation space is unlocked.
4:
The presentation space is busy.
5:
The presentation space is locked.
Session Window Handle XXXX Window handle of the session.
Note:
  • The status of each field is updated each time the status is requested.
  • A new field might be added in a future version of Personal Communications.