gf_cursor_set()

Устанавливает аппаратный курсор

Прототип:

#include <gf/gf.h>
 
int gf_cursor_set( gf_display_t display,
                   unsigned cursor_index,
                   const gf_cursor_t *cursor );

Аргументы:

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

Описание:

Функция устанавливает аппаратный курсор для дисплея.

По умолчанию аппаратный курсор отключен. Если курсор все еще не отображается на дисплее, следует явно включить его, вызвав функцию gf_cursor_enable().

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

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

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

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

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

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

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

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

gf_cursor_t, gf_point_t, gf_cursor_disable(), gf_cursor_enable(), gf_cursor_set_pos()

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