КРАТКАЯ ИНСТРУКЦИЯ

изменение назначения кнопок в  CoolReader

Пара файлов keydefs.ini и keymaps.ini задают назначение функций для кнопок. В keydefs.ini - прописаны символические имена для клавиш и команд - для использования в keymaps.ini Этот файл изменять нет смысла, лучше просто брать самый свежий стандартный.

В keymaps.ini - задается назначение клавиш для разных окон. В строках, начинающихся с символа # можно писать комментарии. Файл разбит на секции - начало новой секции - имя секции в квадратных скобках. Например, секция main - основное окно программы. Code:

[main] 
'1' = DCMD_LINK_BACK 
'1', LONG = DCMD_LINK_FORWARD

Названия секций:

• main - окно чтения книги

• menu - меню

• vkeyboard - виртуальная клавиатура

• txkeyboard - клавиатура Т9/Т5

• browse - окно просмотра прочей информации - словарной статьи, информации о книге

• dialog - прочие диалоги

Назначение клавиш задается строками вида:

КЛАВИША [, LONG] = КОМАНДА [, параметр]

Клавиша - десятичный или шестнадцатиричный (с префиксом 0x) код клавиши, или символ в одинарных кавычках ('1'), или символическое имя, определенное в keydefs.ini

Доступные клавиши V3:

• XK_Return - Ok

• XK_Escape - Esc

• XK_Up / XK_Down - стрелки слева от экрана

• '0'..'9' - цифровые клавиши

• '+'/'-' - клавиши регулировки громкости

Модификатор , LONG (или 1) после кода клавиши обозначает длинное нажатие (по умолчанию - короткое, 0).

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

Пример:

'0' = DCMD_PAGEDOWN 
'0', LONG = DCMD_PAGEDOWN, 10 

Доступные команды:

При просмотре книги:

DCMD_BEGIN - в начало книги

DCMD_PAGEUP - страница назад (параметр - количество страниц)

DCMD_PAGEDOWN - страница вперед (параметр - количество страниц)

DCMD_LINK_FORWARD - если был возврат после перехода по ссылкам - перейти вперед

DCMD_LINK_BACK - вернуться назад после перехода по ссылке или номеру страницы

DCMD_LINK_NEXT - выбрать следующую ссылку на странице

DCMD_LINK_PREV - выбрать предыдущую ссылку на странице

DCMD_LINK_GO - перейти по выбранной ссылке

DCMD_END - перейти в конец книги

DCMD_GO_PAGE - перейти на страницу с номером из параметра

DCMD_ZOOM_IN - увеличить размер шрифта (параметр - количество шагов)

DCMD_ZOOM_OUT - уменьшить размер шрифта (параметр - количество шагов)

DCMD_TOGGLE_TEXT_FORMAT - переключить автоформатирование текстового файла

DCMD_BOOKMARK_SAVE_N - сохранить закладку с номером, заданным параметром

DCMD_BOOKMARK_GO_N - перейти на закладку с номером, заданным параметром

DCMD_MOVE_BY_CHAPTER - листание по главам (параметр 1 для следующей главы, -1 для предыдущей)

MCMD_QUIT - выход из программы. Не переопределяйте с клавиши Esc!!!

MCMD_MAIN_MENU - вызов основного меню

MCMD_GO_PAGE - открыть диалог содержания и перехода на страницу

MCMD_SETTINGS - открыть диалог настроек

MCMD_SETTINGS_FONTSIZE - открыть диалог размера шрифта

MCMD_SETTINGS_ORIENTATION - открыть диалог поворота страницы

MCMD_GO_LINK - режим перехода по ссылке

MCMD_LONG_FORWARD - перейти вперед по истории переходов

MCMD_LONG_BACK - перейти назад по истории закладок

MCMD_DICT - диалог поиска по словарю (T5/T9)

MCMD_BOOKMARK_LIST - диалог со списком закладок

MCMD_RECENT_BOOK_LIST - список последних книг

MCMD_OPEN_RECENT_BOOK - выбрать книгу из списко последних (параметр = номер)

MCMD_ABOUT - о программе, свойства книги

MCMD_CITE - выбор цитаты

MCMD_SEARCH - диалог поиска

MCMD_DICT_VKEYBOARD - поиск по словарю, виртуальная клавиатура

MCMD_KBD_NEXTLAYOUT - в окне виртуальной клавиатуры или T9 - следующая раскладка

MCMD_KBD_PREVLAYOUT - в окне виртуальной клавиатуры или T9 - предыдущая раскладка

MCMD_HELP - вызов инструкции по использованию программы (для следующей версии)

MCMD_HELP_KEYS - вызов списка назначенных клавиш

В меню:

MCMD_CANCEL - закрыть меню, отменив изменения

MCMD_OK - закрыть меню, применив изменения

MCMD_SCROLL_FORWARD - листать многостраничное меню вперед

MCMD_SCROLL_BACK - листать многостраничное меню назад

MCMD_SELECT_0 - выбор 0

MCMD_SELECT_1 - выбор 1

...

MCMD_SELECT_9 - выбор 9

MCMD_SELECT_0_LONG - длинный выбор 0

...

MCMD_SELECT_9_LONG - длинный выбор 9

MCMD_SCROLL_FORWARD_LONG - быстрое листание вперед

MCMD_SCROLL_BACK_LONG - быстрое листание назад

Свежие версии файлов брать здесь:  keydefs.ini,  keymaps.ini

Для замены стандартных настроек измененные версии надо положить в директорию crengine SD карты или внутренней памяти.

В файле keymaps.ini необязательно указывать все клавиши, достаточно задать изменения по сравнению со стандартными.