SetConsoleCursorPosition

La función SetConsoleCursorPosition asignan la posición del cursor en el buffer de pantalla de la consola especificada.

Sintaxis

BOOL SetConsoleCursorPosition(
    HANDLE hConsoleOutput,  // manipulador del buffer de pantalla de consola
    COORD dwCursorPosition  // nuevas coordenadas de posición del cursor
   );

Parámetros

hConsoleOutput

Indentifica un buffer de pantalla de consola. El manipulador debe tener acceso GENERIC_WRITE.

dwCursorPosition

Especifica una estructura COORD que contiene la nueva posición del cursor. Las coordenadas son la columna y fila de una nueva celda de carácter en el buffer de pantalla. Las coordenadas deben estar dentro de los límites del buffer de pantalla.

Valor de retorno

Si la función tiene éxito, el valor de retorno es distinto de cero.

Si la función falla, el valor de retorno es cero. Para optener información adicional sobre el error, llamar a GetLastError.

Observaciones

La posición del cursor determina dónde se escribirán caracteres por las funciones WriteFile o WriteConsole, o dónde se mostrará el echo de las funciones ReadFile o ReadConsole. Para determinar la posición actual del cursor, usar la función GetConsoleScreenBufferInfo.

Si la nueva posición del cursor no está dentro de los límites de la buffer de pantalla de la ventana, el origen de la ventana se modifica para hacer visible el cursore.