Difference between revisions of "SysFn17/ru"

From KolibriOS wiki
Jump to navigation Jump to search
m ("идентификатор" вместо "код кнопки")
m
 
(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)