|
|
|
|
The Convert Position or RowCol function performs one of the following functions depending on the request parameters passed to the function by your application program:
Converts the presentation space position passed in the request parameters into row and column coordinates.
Converts the row and column coordinates passed in the request parameters into a presentation space position.
This function takes the screen model and the size of the corresponding presentation space into account during the conversion.
Your application does not need to call any functions prior to this function.
Your application program must pass the following parameters to this function:
A 2-character string containing the following characters:
The session ID for the appropriate presentation space; this is required because the conversion varies for sessions with different screen models. For more information, see Affected by Set Session Parameters?
Possible values are:
Converts a presentation space position to row and column coordinates.
Converts row and column coordinates to a presentation space position.
If you are converting a presentation space position into row and column coordinates (P specified in data_string ), this parameter should contain a null value. If you are converting row and column coordinates into a presentation space position ( R specified in data_string), this parameter contains the row number being converted.
If you are converting a presentation space to row and column coordinates (P specified in data_string), this is the presentation space position being converted. If you are converting row and column coordinates into a presentation space position ( R specified in data_string), this is the column number being converted.
This function returns the following parameters to your application program:
99
This parameter is not used.
If you are converting presentation space to row and column coordinates, this parameter contains the row number for presentation space position. Presentation Space Sizes, shows the PS positions for each of the display models. If the function returns a zero in this parameter, the row number is not valid for the presentation space.
This function returns a status code rather than a standard return code in the fourth request parameter. The status code indicates whether the function was successful and, if so, the presentation space or column number, depending on the type of conversion being performed. The valid status codes are:
The PS position or column specified is not valid.
Your application program specified a session ID that is not valid for the session, or a system error occurred.
The 2nd character in the data string requesting parameter was not P or R.
Presentation space position or column number, depending on the type of conversion being performed. Presentation Space Sizes, shows the PS positions for each of the display models.
This function is affected by the following option of the Set Session Parameters function:
Indicates that any session ID in the range 0x01- 0xFF can be used. Alphabetic session IDs are case sensitive. The ASCII space character is a valid session ID. To indicate the currently connected PS, use a null character (0x00).
Indicates that only alphabetic session IDs (A-Z) can be used. Session IDs are not case sensitive. To indicate the currently connected PS, use a null character (0x00) or the ASCII space character.
For more information, see Set Session Parameters.
Usage and restrictions are:
This function does not move the cursor to the specified PS position. (Use the Set Cursor function to do this.)
Since this function does not return a standard return code, your application program could obtain misleading information if you use a common error-handling routine for all of the HLLAPI functions. You will need to develop a special error-handling routine for this function.
The upper-left corner (row 1, column 1) of the presentation space is position 1; the bottom right corner is the maximum presentation space value.
|
|
|
 |
|