Работа с виртуальным буфером пользователя

(По материалам Freedom Scientific Developer Network)
Дата публикации:2004
Twitter Facebook Vkontakte

Язык сценариев Jaws предоставляет пользователю возможность создавать виртуальный буфер, который бывает очень полезен в тех случаях, когда нужно заменить графический интерфейс какого-либо приложения на список выбора, состоящий из текстовых строк и связанных с каждой такой строкой функций. Пользователь может перемещаться по строкам текста и на нужной строке нажать Enter или щёлкнуть левой кнопкой мыши, после чего связанная с этой строкой функция будет выполнена.

Описание: Добавляет текст стандартной HotKeyHelp и WindowKeysHelp в виртуальный буфер пользователя.

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

Параметры: отсутствуют

Эта функция доступна в следующих приложениях:

  1. PAC Mate 1.10 и более поздних
  2. JAWS 4.51 и более поздних

Функция RedirectToUserBuffer

Описание: Форматирует и передает текст в Буфер пользователя и инициализирует режим непрерывного чтения. Функция обрабатывает модификатор в виде знака %.

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

Параметр 1:

String, строка для форматирования и передачи в буфер пользователя.Этот параметр является обязательным.

Эта функция доступна в следующих приложениях:

  1. JAWS 4.51 и более поздних

Функция RedisplayPrevField

Описание: Эта функция по умолчанию является пустой и в скриптах приложения её можно перекрыть пользовательской функцией для повторного отображения виртуального буфера, который был активен до отображения буфера помощи. Эта функция будет вызвана, если активен пользовательский буффер и связанное с ним имя окна (возвращается функцией UserBufferWindowName) является пустым. Она вызывается из CloseButton (судя по default.jss в версии 7.00, она вызывается из UpALevel)после того как пользовательский буфер будет деактивирован и непосредственно перед завершением скрипта. Если не надо заново отображать виртуальный буфер, то перед завершением работы функции необходимо вызвать функцию RedisplayPrevField из файла скриптов по умолчанию.

Возвращаемое значение: Void (в default.jss эта функция объявлена как возвращающая int).

Параметр 1:

String, значение, возвращённое UserBufferPrevWindowName() до вызова функции UserBufferDeactivate. Этот параметр является обязательным.

Эта функция доступна в следующих приложениях:

  1. PAC Mate 3.00 и более поздних
  2. JAWS 6.10 и более поздних

Функция UserBufferActivate

Описание: Делает активным виртуальный буфер пользователя. Виртуальный буфер пользователя может быть применён в качестве замены фокуса для графических и иных окон, где реальный фокус не является важным для пользователя. Виртуальный буфер пользователя может быть заполнен текстом. Каждая строка текста может быть связана с функцией, которая будет вызвана, если пользователь нажмёт Enter или левую кнопку мыши, находясь в этой строке текста.

Возвращаемое значение: Int, true если буфер был активирован, false - если буфер уже был активен в момент обращения этой функции.

Параметр 1:

Int, true для захвата(по умолчанию), false для того, чтобы пропускать (не захватывать) клавиатурный ввод.Этот параметр является необязательным.

Эта функция доступна в следующих приложениях:

  1. PAC Mate 1.10 и более поздних
  2. 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 элемента управления для виртуального буфера. Этот параметр является обязательным.

Эта функция доступна в следующих приложениях:

  1. 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 по умолчанию. Этот параметр является необязательным.

Эта функция доступна в следующих приложениях:

  1. PAC Mate 1.10 и более поздних
  2. JAWS 4.51 и более поздних

Функция UserBufferClear

Описание: Очищает виртуальный буфер пользователя и подготавливает его для записи нового текста и связанных с ним функций.

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

Параметры: отсутствуют

Эта функция доступна в следующих приложениях:

  1. PAC Mate 1.10 и более поздних
  2. JAWS 4.51 и более поздних

Функция UserBufferDeactivate

Описание: Деактивирует виртуальный буфер пользователя и восстанавливает нормальное слежение Jaws за фокусом ввода.

Возвращаемое значение: Int, true - если буфер успешно деактивирован, false - если не было буфера для деактивации.

Параметры: отсутствуют

Эта функция доступна в следующих приложениях:

  1. PAC Mate 1.10 и более поздних
  2. JAWS 4.51 и более поздних

Функция UserBufferGetFontInfo

Описание: Возвращает информацию о шрифте, которым отображается текст, добавляемый пользователем в буфер, если для этого текста не указывается тип шрифта.

Возвращаемое значение: Int, true - если функция завершилась успешно.

Параметр 1:

String, в этом параметре возвращается название шрифта. Этот параметр является обязательным.

Параметр 2:

Int, в этом параметре возвращается размер шрифта. Этот параметр является обязательным.

Параметр 3:

Int, в этом параметре возвращается комбинация атрибутов текста: выделенный, курсив и т.п. Этот параметр является обязательным.

Параметр 4:

Int, в этом параметре возвращается цвет текста. Этот параметр является обязательным.

Параметр 5:

Int, в этом параметре возвращается цвет фона. Этот параметр является обязательным.

Эта функция доступна в следующих приложениях:

  1. PAC Mate 1.10 и более поздних
  2. JAWS 4.51 и более поздних

Функция UserBufferGetLength

Описание: Возвращает размер виртуального буфера пользователя, а точнее,количество символов в нём.

Возвращаемое значение: Int, количество символов (включая символы перевода строки).

Параметры: отсутствуют

Эта функция доступна в следующих приложениях:

  1. PAC Mate 1.10 и более поздних
  2. JAWS 4.51 и более поздних

Функция UserBufferGetText

Описание: Возвращает текст, который содержится в виртуальном буфере пользователя. Она очень полезна, если необходимо сохранить и позже восстановить содержание виртуального буфера.

Возвращаемое значение: String, текст.

Параметры: отсутствуют

Эта функция доступна в следующих приложениях:

  1. PAC Mate 1.10 и более поздних
  2. JAWS 4.51 и более поздних

Функция UserBufferIsActive

Описание: Определяет: активен или нет виртуальный буфер пользователя.

Возвращаемое значение: Int, true или false.

Параметры: отсутствуют

Эта функция доступна в следующих приложениях:

  1. PAC Mate 1.10 и более поздних
  2. JAWS 4.51 и более поздних

Функция UserBufferIsTrappingKeys

Описание: Проверяет: захватывает ли виртуальный буфер пользователя клавиатурный ввод.

Возвращаемое значение: Int, true или false.

Параметры: отсутствуют

Эта функция доступна в следующих приложениях:

  1. JAWS 4.51 и более поздних

Функция UserBufferPrevWindowName

Описание: Возвращает имя окна, которое было назначено виртуальному буферу пользователя во время последней активации. - это значение, возвращаемое функцией UserBufferWindowName, предшествующее последнему вызову UserBufferDeactivate.

Возвращаемое значение: String, имя окна, которое было назначено виртуальному буферу пользователя в предыдущий вызов.

Параметры: отсутствуют

Эта функция доступна в следующих приложениях:

  1. PAC Mate 1.10 и более поздних

Функция userBufferPrevWindowType

Описание: Возвращает тип окна, назначенный виртуальному буферу пользователя во время предыдущей его активации.

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

Параметры: отсутствуют

Эта функция доступна в следующих приложениях:

  1. PAC Mate 1.10 и более поздних

Функция UserBufferSetFontInfo

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

Возвращаемое значение: Int, true - если назначение прошло успешно.

Параметр 1:

String, название шрифта. Этот параметр является обязательным.

Параметр 2:

Int, размер шрифта. Этот параметр является обязательным.

Параметр 3:

Int, комбинация атрибутов текста. Этот параметр является обязательным.

Параметр 4:

Int, цвет текста. Этот параметр является обязательным.

Параметр 5:

Int, цвет фона. Этот параметр является обязательным.

Эта функция доступна в следующих приложениях:

  1. PAC Mate 1.10 и более поздних
  2. JAWS 4.51 и более поздних

Функция UserBufferWindowName

Описание: Возвращает имя окна виртуального буфера, которое было ему назначено функцией UserBufferActivateEx.

Возвращаемое значение: String, имя окна виртуального буфера пользователя.

Параметры: отсутствуют

Эта функция доступна в следующих приложениях:

  1. PAC Mate 1.10 и более поздних

Функция userBufferWindowType

Описание: Возвращает тип окна виртуального буфера, который был назначен функцией UserBufferActivateEx.

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

Параметры: отсутствуют

Эта функция доступна в следующих приложениях:

  1. PAC Mate 1.10 и более поздних


Распространение материалов сайта означает, что распространитель принял условия лицензионного соглашения.
Идея и реализация: © Владимир Довыденков и Анатолий Камынин,  2004-2019