gf_cursor_enable()

Включить аппаратный курсор

Прототип:

#include <gf/gf.h>
 
int gf_cursor_enable( gf_display_t display,
                      unsigned cursor_index );

Аргументы:

display: Дескриптор дисплея, для которого осуществляется отображение курсора. Дескриптор должен быть возвращен функцией gf_display_attach().
cursor_index: Индекс курсора для оборудования, которое поддерживает несколько аппаратных курсоров на дисплей. Обычно этот параметр игнорируется, используйте значение 0.

Функция включает отображение аппаратного курсора на данном дисплее. Перед этим следует установить форму курсора с помощью функции gf_cursor_set(). Выключить аппаратный курсор можно с помощью функции gf_cursor_disable().

Потоки не должны вызывать эту функцию между вызовами gf_draw_begin() и gf_draw_end(). В противном случае возможна взаимная блокировка потоков.

При взаимодействии с курсором через API Screen функции управления аппаратным курсором через API GF блокируются. После завершения работы последнего клиента Screen данные функции разблокируются, однако состояние аппаратного курсора будет неопределённым.

Возвращаемое значение:

GF_ERR_OK: Успешное завершение.
GF_ERR_IODISPLAY: Ошибка коммуникации с io-display. Следует проверить запущен ли в настоящий момент сервер io-display. Вывод sloginfo может содержать дополнительную информацию.
GF_ERR_PARM: Значение параметра display равно NULL

Классификация:

Графическая подсистема ЗОСРВ «Нейтрино», Graphics Framework

Безопасность использования
Обработчик прерываний: Нет
Обработчик сигналов: Нет
В потоке: Да

Тематические ссылки:

gf_cursor_disable(), gf_cursor_set(), gf_cursor_set_pos()

Предыдущий раздел: GF API