Цвет текста и фона

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

Ниже приведено описание функций и скриптов языка сценариев JAWS, позволяющих выполнять проверку и обработку сочетаний цветов текста и фона.

Функция AddBrailleColors

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

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

Параметр 1:

String, переменная, содержащая RGB-строку цвета символов. Этот параметр является обязательным.

Параметр 2:

String, RGB-строка, определяющая цвет фона. Этот параметр является обязательным.

Параметр 3:

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

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

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

Скрипт BackgroundColorChanges

Описание: Сообщает об изменении цвета фона, если обнаруживает такое изменение. Полезен во время подготовки документа к печати.

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

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

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

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

Скрипт BrailleColorMarkingAssign

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

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

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

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

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

Функция BrailleSetColorsToMark

Описание: Эта функция даёт возможность пользователю специфицировать цвет символов и цвет фона набором до девяти цветовых пар, которые отмечаются в шрифте Брайля точками 7 и 8. Эта функция также включает и отключает цветовую маркировку брайлевских символов. Передайте пустую строку, чтобы отключить цветовую маркировку, или установите опции JCF для отключения цветовой маркировки.

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

Параметр 1:

String, до девяти цветовых пар цвета текста и фона в формате: rgb/rgb,rgb/rgb,... Можно передать пустую строку, чтобы отключить цветовую маркировку брайлевских символов. Этот параметр является обязательным.

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

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

Функция ColorToRGBString

Описание: Преобразует значение цвета в строку формата "255255255" В этой строке первое число соответствует уровню красного, второе - уровню зелёного, а третье - уровню голубого цветов.

Возвращаемое значение: String, RGB-строка, в которую было преобразовано значение цвета.

Параметр 1:

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

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

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

Функция FindColors

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

Возвращаемое значение: Int, значение 1 соответствует успешному поиску, 0 - отсутствию указанного сочетания цветов на экране.

Параметр 1:

Int, переменная или функция, возвращающая значение цвета, указывающие цвет текста. Часто используют функцию RGBStringToColor(), чтобы получить значение цвета из RGB-строки. Используйте константу IgnoreColor, определённую в файле HJConst.jsh, чтобы игнорировать цвет текста и вести поиск только по цвету фона. Этот параметр является обязательным.

Параметр 2:

Int, значение цвета фона, которое может храниться в переменной или возвращаться функцией. Часто в качестве параметра используется функция RGBStringToColor. Используйте константу IgnoreColor, определённую в файле HJConst.jsh, чтобы игнорировать цвет фона и вести поиск только по цвету текста. Этот параметр является обязательным.

Параметр 3:

Int, одна из следующих констант, определённых в файле HJConst.jsh для указания направления поиска:

  • s_top - для поиска от начала активного окна;
  • s_bottom - для поиска от нижней части активного окна вверх;
  • s_next- для поиска вперёд от позиции активного курсора;
  • s_prior - для поиска назад от позиции активного курсора.

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

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

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

Функция GetColorApproximation

Описание: Эта функция получает значение COLORREF и находит самый близкий цвет в нашей таблице, имя которой нам известно. Функция также предоставляет информацию о том, насколько приближенный (аппроксимированный) цвет светлее или темнее исходного.

Возвращаемое значение: Int, цвет, наиболее близкий к заданному.

Параметр 1:

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

Параметр 2:

Int, положительное число означает, что полученный цвет светлее исходного, 0 означает, что цвета совпадают, а отрицательное число показывает, что полученный цвет темнее исходного. Этот параметр является обязательным. В этом параметре значение возвращается по ссылке.

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

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

Функция GetColorAtPoint

Описание: Возвращает цвет в указанной позиции. Это RGB значение цвета типа 000000000 или 255255255.

Возвращаемое значение: Int, значение цвета в указанной точке.

Параметр 1:

Int, координата столбца нужной точки. Можно использовать функцию GetCursorCol, чтобы получить необходимое значение. Этот параметр является обязательным.

Параметр 2:

Int, координата строки нужной точки. Можно использовать функцию GetCursorRow, чтобы получить необходимое значение. Этот параметр является обязательным.

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

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

Функция GetColorBackground

Описание: Возвращает цвет фона символа в позиции активного курсора.

Возвращаемое значение: Int, цвет фона.

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

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

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

Функция GetColorField

Описание: Возвращает содержимое цветового поля в позиции активного курсора. Цветовое поле - это блок информации, обычно текстовой, который имеет единое сочетание цветов (текста и фона). Например, сочетание может быть таким: белый текст на синем фоне. Это цветовое сочетание должно быть неизменным внутри цветового поля. Функция GetColorField похожа на функцию GetField. Отличие заключается в том, что функция GetColorField основывает свою работу на изменении цвета, а функция GetField() - на изменении атрибутов текста.

Возвращаемое значение: String, цветовое поле в позиции активного курсора.

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

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

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

Функция GetColorName

Описание: Возвращает соответствующее наименование цвета, найденное в файле colors.ini.

Возвращаемое значение: String, наименование цвета или RGB-строка, если для указанного цвета нет названия в файле colors.ini.

Параметр 1:

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

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

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

Функция GetColorText

Описание: Возвращает цвет текста в позиции активного курсора.

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

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

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

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

Функция ReloadSystemColors

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

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

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

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

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

Функция RGBDecToHex

Описание: Эта функция преобразует десятичную RGB-строку в шестнадцатиричную RGB-строку. Например, "12825500" в "80FF00".

Возвращаемое значение: String, шестнадцатиричная RGB-строка.

Параметр 1:

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

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

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

Функция RGBHexToColor

Описание: Эта функция преобразует шестнадцатиричную RGB-строку в целое значение, определяющее цвет.

Возвращаемое значение: Int, цвет.

Параметр 1:

String, шестнадцатиричная строка "#rrggbb" или "rrggbb" Этот параметр является обязательным.

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

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

Функция RGBHexToDec

Описание: Эта функция преобразует шестнадцатиричную RGB-строку в десятичную RGB-строку.

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

Параметр 1:

String, шестнадцатиричная RGB-строка, подлежащая преобразованию. Этот параметр является обязательным.

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

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

Функция RGBStringToColor

Описание: Преобразует девятизначное десятичное число вида "255255255" в целое значение, соответствующее цвету.

Возвращаемое значение: Int, значение цвета, которое можно сравнивать со значениями, возвращаемыми функциями GetColorText или GetColorBackground.

Параметр 1:

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

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

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

Функция SayColor

Описание: Сообщает цвет текста и цвет фона для текста, расположенного в позиции активного курсора.

Возвращаемое значение: Int, "TRUE" = 1, если в позиции курсора обнаружен текст. "FALSE" = 0, если в позиции курсора текста нет.

Параметр 1:

Int, если true, то озвучивается RGB значение;иначе озвучивается наименование цвета. Если точное соответствие не найдено, то будет использовано приближённое значение. Этот дополнительный параметр используется в JAWS 5.10 и выше. Этот параметр является необязательным.

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

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

Скрипт SayColor

Описание: Сообщает цвет текста в позиции активного курсора. В сообщении используются соответствия значений цвета и его названия, определённые в файле colors.ini. Если вместо названия цвета произносится его числовое значение, то, следовательно, этот цвет не определён в colors.ini. Для того чтобы определить его, надо добавить в этот файл соответствующую строку.

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

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

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

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

Скрипт TextColorChanges

Описание: Сообщает об изменении цвета текста, если встречает такое изменение. Полезен во время подготовки документа к печати.

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

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

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

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


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