SysFn17/ru: Difference between revisions

From KolibriOS wiki
Jump to navigation Jump to search
m ("идентификатор" вместо "код кнопки")
mNo edit summary
 
(One intermediate revision by one other user not shown)
Line 2: Line 2:


----
----
Забирает из буфера идентификатор нажатой кнопки.
Забирает код нажатой кнопки из буфера.
 
Параметры:
'''Параметры:'''
:* eax = 17 - номер функции
* eax = 17 - номер функции
Возвращаемое значение:
 
:* если буфер пуст, возвращается eax=1
'''Возвращаемое значение:'''
:* если буфер непуст:
* если буфер пуст, возвращается eax=1
::* старшие 24 бита eax содержат идентификатор кнопки
* если буфер не пуст, тогда возвращается:
:::(в частности, в ah оказывается младший байт идентификатора;
** старшие 24 бита eax содержат идентификатор кнопки  
:::если все кнопки имеют идентификатор, меньший 256,
*** в частности, в ah оказывается младший байт идентификатора;  
:::то для различения достаточно ah)
*** если все кнопки имеют идентификатор, меньший 256, то для различения достаточно ah
::* al = 0 - кнопка была нажата левой кнопкой мыши
** al = 0 - если использовалась левая кнопка мыши,
::* al = бит, соответствующий нажавшей кнопке мыши, если не левой
*** или бит той кнопки мыши, которая использовалась.
Замечания:
 
:* "Буфер" хранит только одну кнопку, при нажатии новой кнопки
'''Замечания:'''
::информация о старой теряется.
* Идентификатор кнопки задаётся при её создании [[SysFn08/ru|функцией 8]]. Разные кнопки могут иметь одинаковый идентификатор.
:* При вызове этой функции приложением с неактивным окном
* "Буфер" хранит только одну кнопку; при нажатии новой кнопки информация о старой теряется.
::возвращается ответ "буфер пуст".
* При вызове этой функции приложением с неактивным окном возвращается ответ "буфер пуст".
:* Возвращаемое значение al соответствует состоянию кнопок мыши
::в формате подфункции 2 [[SysFn37/ru|функции 37]] в момент начала нажатия
::на кнопку, за исключением младшего бита (соответствующего левой
::кнопке мыши), который сбрасывается.


'''Константы для регистров:'''
::eax - SF_GET_BUTTON (17)


{{System_functions}}
{{System_functions}}
[[Category: SysCalls]]
[[Category: SysCalls]]

Latest revision as of 18:00, 12 January 2016

Функция 17 - получить идентификатор нажатой кнопки.


Забирает код нажатой кнопки из буфера. Параметры:

  • eax = 17 - номер функции

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

  • если буфер пуст, возвращается eax=1
  • если буфер непуст:
  • старшие 24 бита eax содержат идентификатор кнопки
(в частности, в ah оказывается младший байт идентификатора;
если все кнопки имеют идентификатор, меньший 256,
то для различения достаточно ah)
  • al = 0 - кнопка была нажата левой кнопкой мыши
  • al = бит, соответствующий нажавшей кнопке мыши, если не левой

Замечания:

  • "Буфер" хранит только одну кнопку, при нажатии новой кнопки
информация о старой теряется.
  • При вызове этой функции приложением с неактивным окном
возвращается ответ "буфер пуст".
  • Возвращаемое значение al соответствует состоянию кнопок мыши
в формате подфункции 2 функции 37 в момент начала нажатия
на кнопку, за исключением младшего бита (соответствующего левой
кнопке мыши), который сбрасывается.

Константы для регистров:

eax - SF_GET_BUTTON (17)