Moves the physical and virtual cursor to the specified window location
| Call | |
| #include <vv_sys.h> | |
| int csr_mvwn(wn_row, wn_col, wnp) | |
|
int wn_row |
Window row to place cursors |
| int wn_col | Window column to place cursors |
| WINDOWPTR wnp | Pointer to window to move cursors in |
| Returns | |
| 1 | The virtual cursor was moved to the specified location in the window's buffer. The physical cursor has also been moved to the corresponding location in the window if it would be visible. |
| 0 | The specified location lies outside the window or memory screen buffer. The virtual cursor has been placed in the first column in the row below the window or memory screen buffer, and the physical cursor has not been moved. |
| Description
csr_mvwn() sets the virtual cursor coordinates to the specifiedlocation in the window's buffer by changing the values of wnp->r and wnp->c. The column of the virtual cursor is then checked to make sure it lies within the window's buffer. If it is beyond the edge, it is advanced to the first column in the next row. If at this point the virtual cursor is within the window's buffer and the window is set on the physical screen, the physical cursor is placed at the virtual cursor location by calling csr_mv(). |
|
| Cautions
If the window is not set on the screen, the physical cursor is not moved. The row and column coordinates passed to this function must be relative to the origin of the window's buffer, not the window itself. A 0 return value from this function is not considered a fatal error. VV_ERR is not set; therefore, the VCS error reporting system will not detect this condition. |
|
