Работа с виртуальным буфером пользователя |
| (По материалам Freedom Scientific Developer Network) |
| Автор: | © Анатолий Камынин |
| Дата публикации: | 2004 |
     | |
Язык сценариев Jaws предоставляет пользователю возможность создавать виртуальный буфер, который бывает очень полезен в тех случаях, когда нужно заменить графический интерфейс какого-либо приложения на список выбора, состоящий из текстовых строк и связанных с каждой такой строкой функций. Пользователь может перемещаться по строкам текста и на нужной строке нажать Enter или щёлкнуть левой кнопкой мыши, после чего связанная с этой строкой функция будет выполнена.
- Функция RedirectToUserBuffer
- Функция RedisplayPrevField
- Функция UserBufferActivate
- Функция UserBufferActivateEx
- Функция UserBufferAddText
- Функция UserBufferClear
- Функция UserBufferDeactivate
- Функция UserBufferGetFontInfo
- Функция UserBufferGetLength
- Функция UserBufferGetText
- Функция UserBufferIsActive
- Функция UserBufferIsTrappingKeys
- Функция UserBufferPrevWindowName
- Функция userBufferPrevWindowType
- Функция UserBufferSetFontInfo
- Функция UserBufferWindowName
- Функция userBufferWindowType
Функция AddHotKeyLinks
Описание: Добавляет текст стандартной HotKeyHelp и WindowKeysHelp в виртуальный буфер пользователя.
Возвращаемое значение: Void
Параметры: отсутствуют
Эта функция доступна в следующих приложениях:
- PAC Mate 1.10 и более поздних
- JAWS 4.51 и более поздних
Функция RedirectToUserBuffer
Описание: Форматирует и передает текст в Буфер пользователя и инициализирует режим непрерывного чтения. Функция обрабатывает модификатор в виде знака %.
Возвращаемое значение: Void
Параметр 1:
String, строка для форматирования и передачи в буфер пользователя.Этот параметр является обязательным.
Эта функция доступна в следующих приложениях:
- JAWS 4.51 и более поздних
Функция RedisplayPrevField
Описание: Эта функция по умолчанию является пустой и в скриптах приложения её можно перекрыть пользовательской функцией для повторного отображения виртуального буфера, который был активен до отображения буфера помощи. Эта функция будет вызвана, если активен пользовательский буффер и связанное с ним имя окна (возвращается функцией UserBufferWindowName) является пустым. Она вызывается из CloseButton (судя по default.jss в версии 7.00, она вызывается из UpALevel)после того как пользовательский буфер будет деактивирован и непосредственно перед завершением скрипта. Если не надо заново отображать виртуальный буфер, то перед завершением работы функции необходимо вызвать функцию RedisplayPrevField из файла скриптов по умолчанию.
Возвращаемое значение: Void (в default.jss эта функция объявлена как возвращающая int).
Параметр 1:
String, значение, возвращённое UserBufferPrevWindowName() до вызова функции UserBufferDeactivate. Этот параметр является обязательным.
Эта функция доступна в следующих приложениях:
- PAC Mate 3.00 и более поздних
- JAWS 6.10 и более поздних
Функция UserBufferActivate
Описание: Делает активным виртуальный буфер пользователя. Виртуальный буфер пользователя может быть применён в качестве замены фокуса для графических и иных окон, где реальный фокус не является важным для пользователя. Виртуальный буфер пользователя может быть заполнен текстом. Каждая строка текста может быть связана с функцией, которая будет вызвана, если пользователь нажмёт Enter или левую кнопку мыши, находясь в этой строке текста.
Возвращаемое значение: Int, true если буфер был активирован, false - если буфер уже был активен в момент обращения этой функции.
Параметр 1:
Int, true для захвата(по умолчанию), false для того, чтобы пропускать (не захватывать) клавиатурный ввод.Этот параметр является необязательным.
Эта функция доступна в следующих приложениях:
- PAC Mate 1.10 и более поздних
- JAWS 4.51 и более поздних
Функция UserBufferActivateEx
Описание: Виртуальный буфер пользователя может быть применён в качестве замены фокуса для графических и иных окон, где реальный фокус не является важным для пользователя. Виртуальный буфер пользователя может быть заполнен текстом. Каждая строка текста может быть связана с функцией, которая будет вызвана, если пользователь нажмёт Enter или левую кнопку мыши, находясь в этой строке текста. Эта функция похожа на UserBufferActivate, за исключением того, что она принимает параметры, чтобы позволить сценарию идентифицировать буфер пользователя. Допустимые значения сохраняются и возвращаются функциями UserBufferWindowName, UserBufferWindowТип, UserBufferWindowТипCode и UserBufferWindowControlID. Когда вызывается функция UserBufferDeactivate, эти значения копируются и могут быть получены путём вызова функции UserBufferPrevWindowName и так далее.
Возвращаемое значение: Int, true если буфер успешно активирован, false если буфер уже был активирован к моменту вызова этой функции.
Параметр 1:
String, имя, которое будет связано с этим буфером, Этот параметр является обязательным.
Параметр 2:
String, тип окна, который будет назначен этому буферу. Этот параметр является обязательным.
Параметр 3:
Int, тип целочисленного кода для виртуального буфера. Этот параметр является обязательным.
Параметр 4:
Int, Id элемента управления для виртуального буфера. Этот параметр является обязательным.
Эта функция доступна в следующих приложениях:
- PAC Mate 1.10 и более поздних
Функция UserBufferAddText
Описание: Добавляет текст в виртуальный буфер пользователя, вместе с текстом добавляется и функция. Имя функции для вывода на дисплей, используется как её псевдоним для удобства чтения её человеком, вместо кодового имени функции.
Возвращаемое значение: Int, true - если текст был добавлен, false - если нет.
Параметр 1:
String, текст, который должен быть добавлен в буфер. Этот параметр является обязательным.
Параметр 2:
String, Имя функции, включая круглые скобки и необходимые параметры), которая будет вызвана, если пользователь нажмёт Enter или щёлкнет левой кнопкой мыши по связанному тексту. Этот параметр является необязательным.
Параметр 3:
String, Имя, которое будет показано в диалоге, когда виртуальный буфер будет активирован, а пользователь остановится на связанном тексте. Этот параметр является необязательным.
Параметр 4:
String, название шрифта, используемого для JAWSKey+f, когда пользователь находится в этом тексте. Этот параметр является необязательным.
Параметр 5:
Int, размер шрифта, используемого для сообщения по JAWSKey+f, когда пользователь находится в этом тексте. Этот параметр является необязательным.
Параметр 6:
Int, флаг атрибутов, используемый для сообщения по JAWSKey+f, когда пользователь находится в этом тексте. Этот параметр является необязательным.
Параметр 7:
Int.Описание: цвет текста. Этот параметр является необязательным.
Параметр 8:
Int, цвет фона. Этот параметр является необязательным.
Параметр 9:
Int, автоматически добавлять перевод строки, true по умолчанию. Этот параметр является необязательным.
Эта функция доступна в следующих приложениях:
- PAC Mate 1.10 и более поздних
- JAWS 4.51 и более поздних
Функция UserBufferClear
Описание: Очищает виртуальный буфер пользователя и подготавливает его для записи нового текста и связанных с ним функций.
Возвращаемое значение: Void
Параметры: отсутствуют
Эта функция доступна в следующих приложениях:
- PAC Mate 1.10 и более поздних
- JAWS 4.51 и более поздних
Функция UserBufferDeactivate
Описание: Деактивирует виртуальный буфер пользователя и восстанавливает нормальное слежение Jaws за фокусом ввода.
Возвращаемое значение: Int, true - если буфер успешно деактивирован, false - если не было буфера для деактивации.
Параметры: отсутствуют
Эта функция доступна в следующих приложениях:
- PAC Mate 1.10 и более поздних
- JAWS 4.51 и более поздних
Функция UserBufferGetFontInfo
Описание: Возвращает информацию о шрифте, которым отображается текст, добавляемый пользователем в буфер, если для этого текста не указывается тип шрифта.
Возвращаемое значение: Int, true - если функция завершилась успешно.
Параметр 1:
String, в этом параметре возвращается название шрифта. Этот параметр является обязательным.
Параметр 2:
Int, в этом параметре возвращается размер шрифта. Этот параметр является обязательным.
Параметр 3:
Int, в этом параметре возвращается комбинация атрибутов текста: выделенный, курсив и т.п. Этот параметр является обязательным.
Параметр 4:
Int, в этом параметре возвращается цвет текста. Этот параметр является обязательным.
Параметр 5:
Int, в этом параметре возвращается цвет фона. Этот параметр является обязательным.
Эта функция доступна в следующих приложениях:
- PAC Mate 1.10 и более поздних
- JAWS 4.51 и более поздних
Функция UserBufferGetLength
Описание: Возвращает размер виртуального буфера пользователя, а точнее,количество символов в нём.
Возвращаемое значение: Int, количество символов (включая символы перевода строки).
Параметры: отсутствуют
Эта функция доступна в следующих приложениях:
- PAC Mate 1.10 и более поздних
- JAWS 4.51 и более поздних
Функция UserBufferGetText
Описание: Возвращает текст, который содержится в виртуальном буфере пользователя. Она очень полезна, если необходимо сохранить и позже восстановить содержание виртуального буфера.
Возвращаемое значение: String, текст.
Параметры: отсутствуют
Эта функция доступна в следующих приложениях:
- PAC Mate 1.10 и более поздних
- JAWS 4.51 и более поздних
Функция UserBufferIsActive
Описание: Определяет: активен или нет виртуальный буфер пользователя.
Возвращаемое значение: Int, true или false.
Параметры: отсутствуют
Эта функция доступна в следующих приложениях:
- PAC Mate 1.10 и более поздних
- JAWS 4.51 и более поздних
Функция UserBufferIsTrappingKeys
Описание: Проверяет: захватывает ли виртуальный буфер пользователя клавиатурный ввод.
Возвращаемое значение: Int, true или false.
Параметры: отсутствуют
Эта функция доступна в следующих приложениях:
- JAWS 4.51 и более поздних
Функция UserBufferPrevWindowName
Описание: Возвращает имя окна, которое было назначено виртуальному буферу пользователя во время последней активации. - это значение, возвращаемое функцией UserBufferWindowName, предшествующее последнему вызову UserBufferDeactivate.
Возвращаемое значение: String, имя окна, которое было назначено виртуальному буферу пользователя в предыдущий вызов.
Параметры: отсутствуют
Эта функция доступна в следующих приложениях:
- PAC Mate 1.10 и более поздних
Функция userBufferPrevWindowType
Описание: Возвращает тип окна, назначенный виртуальному буферу пользователя во время предыдущей его активации.
Возвращаемое значение: Void
Параметры: отсутствуют
Эта функция доступна в следующих приложениях:
- PAC Mate 1.10 и более поздних
Функция UserBufferSetFontInfo
Описание: Позволяет пользователю определить шрифт, размер шрифта, цвет текста и фона, атрибуты текста, назначаемые по умолчанию для добавляемого в виртуальный буфер текста.
Возвращаемое значение: Int, true - если назначение прошло успешно.
Параметр 1:
String, название шрифта. Этот параметр является обязательным.
Параметр 2:
Int, размер шрифта. Этот параметр является обязательным.
Параметр 3:
Int, комбинация атрибутов текста. Этот параметр является обязательным.
Параметр 4:
Int, цвет текста. Этот параметр является обязательным.
Параметр 5:
Int, цвет фона. Этот параметр является обязательным.
Эта функция доступна в следующих приложениях:
- PAC Mate 1.10 и более поздних
- JAWS 4.51 и более поздних
Функция UserBufferWindowName
Описание: Возвращает имя окна виртуального буфера, которое было ему назначено функцией UserBufferActivateEx.
Возвращаемое значение: String, имя окна виртуального буфера пользователя.
Параметры: отсутствуют
Эта функция доступна в следующих приложениях:
- PAC Mate 1.10 и более поздних
Функция userBufferWindowType
Описание: Возвращает тип окна виртуального буфера, который был назначен функцией UserBufferActivateEx.
Возвращаемое значение: Void
Параметры: отсутствуют
Эта функция доступна в следующих приложениях:
- PAC Mate 1.10 и более поздних
 |
 |
 |
Распространение материалов сайта означает, что распространитель принял условия лицензионного соглашения.
Идея и реализация: © Владимир Довыденков и Анатолий Камынин, 2004-2024
Идея и реализация: © Владимир Довыденков и Анатолий Камынин, 2004-2024
Социальные сети