|
Query Window Coordinates (103)
|
Top
Previous
Next
|
|
The Query Window Coordinates function requests the coordinates for the window of a presentation space. The window coordinates are returned in pels.
Note: (0,0) indicates the top-left of the window.
Prerequisite Calls
Connect Window Services (101)
Call Parameters
|
Standard Interface
|
Enhanced Interface
|
Function Number
|
Must be 103
|
|
Data String
|
1-character short session ID of the host presentation space
|
|
Length
|
17 is implied
|
20 is implied
|
PS Position
|
NA
|
|
The calling data string can contain:
Byte
|
|
Definition
|
Standard
|
Enhanced
|
|
1
|
1
|
One of the following values:
| • | A 1-character presentation space short name (PSID) |
| • | A blank or null indicating a function call for the current connection presentation space |
|
|
2-4
|
Reserved
|
2-17
|
5-20
|
Reserved
|
Return Parameters
This function returns a data string and a return code.
Byte
|
|
Definition
|
Standard
|
Enhanced
|
|
1
|
1
|
One of the following values:
| • | A 1-character presentation space short session ID |
| • | A blank or null indicating a function call for the current connection presentation space |
|
|
2-4
|
Reserved
|
2-17
|
5-20
|
Four 32-bit unsigned integers that return:
|
2-5
|
5-8
|
XLeft Long integer in pels of the left X coordinate of the rectangular window relative to the desktop window
|
6-9
|
9-12
|
YBottom Long integer in pels of the bottom Y coordinate of the rectangular window relative to the desktop window
|
10-13
|
13-15
|
XRight Long integer in pels of the right X coordinate of the rectangular window relative to the desktop window
|
14-17
|
16-20
|
YTop Long integer in pels of the top Y coordinate of the rectangular window relative to the desktop window
|
Return Code
The following codes are defined:
Return Code
|
Explanation
|
0
|
The Query Window Coordinates function was successful.
|
1
|
Your program was not currently connected to the host session.
|
9
|
A system error occurred.
|
12
|
The session stopped.
|
|