wincon.h


SetConsoleCursorInfo

La función SetConsoleCursorInfo asigna el tamaño y visibilidad del cursor para el buffer de pantalla de la consola especificada.

Sintaxis

BOOL SetConsoleCursorInfo(
    HANDLE hConsoleOutput,                          // manipulador de buffer de pantalla de consola
    CONST CONSOLE_CURSOR_INFO *lpConsoleCursorInfo  // dirección de información del cursor
   );

Parámetros

hConsoleOutput
Indentifica un buffer de pantalla de consola. El manipulador debe tener acceso GENERIC_WRITE.
lpConsoleCursorInfo
Puntero a una estructura CONSOLE_CURSOR_INFO que contiene las nuevas especificaciones para el cursor del buffer de consola.

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

Cuando un cursor de buffer de pantalla es visible, su apariencia puede variar, entre llenar completamente la celda del carácter a mostrarse como una línea horizontal en la parte inferior de la celda. El miembro dwSize de la estructura CONSOLE_CURSOR_INFO especifica el porcentaje de una celda de carácter que se rellena por el cursor. Si este miembro es emnor que 1 o mayor que 100, SetConsoleCursorInfo falla.