Форматирование и атрибуты текста

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

Функции и скрипты, представленные в этом разделе, позволяют получить параметры форматирования текста, тип шрифта (наименование, размер и атрибуты). Кроме того, существует ряд функций, которые выполняют поиск символа с заданным атрибутом на экране. Такие функции могут быть полезны в процессе подготовки текста к печати или во время работы с такими приложениями, которые позволяют готовить текст к печати. В некоторых случаях какой-либо атрибут текста может быть использован для определения состояния приложения (например, в почтовых клиентах заголовки непрочитанных писем могут быть выделены "полужирным" шрифтом или подчёркиванием).

Функция AttributeEnumerate

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

Int Function MyEnumFunc (Int topLeftX, Int topLeftY, Int bottomRightX, Int bottomRightY)
...
EndFunction

Возвращаемое значение: Int. Число найденных в окне полей.

Параметр 1:

Handle, Дескриптор окна, в котором осуществляется перечисление. Этот параметр является обязательным.

Параметр 2:

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

Параметр 3:

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

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

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

Функция AttributesChanged

Описание: Сообщает об изменении атрибутов( Bold - полужирный, Highlight - подсвеченный, Italic - курсив и т.д.)

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

Параметр 1:

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

Параметр 2:

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

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

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

Скрипт AttributesChanges

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

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

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

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

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

Функция FindFirstAttribute

Описание: Ищет первое вхождение текста с определёнными атрибутами. Поиск начинается в левом верхнем углу указанного окна и перемещается вниз. Если поиск оказывается успешным, активный курсор устанавливается на первый символ, имеющий запрашиваемые атрибуты. Как правило, PC курсор может быть успешно установлен на атрибуты внутри текстового окна.

Возвращаемое значение: Int, при успешном поиске возвращается WAS_SUCCESSFUL = 1, при неудаче - WAS_NOT_SUCCESSFUL = 0.

Параметр 1:

Int, число, определяющее искомый атрибут, или имя константы, обозначающей это число: ATTRIB_BOLD, ATTRIB_UNDERliNE, ATTRIB_ITAliC, ATTRIB_HIGHliGHT, и ATTRIB_STRIKEOUT. Поиск можно проводить по комбинации атрибутов, объединяя константы знаком +. Например, ATTRIB_BOLD+ATTRIB_UNDERliNE. Этот параметр является обязательным.

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

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

Функция FindLastAttribute

Описание: Ищет последнее вхождение текста с определёнными атрибутами. Поиск начинается в правом нижнем углу окна и ведётся вверх по окну. Если поиск оказывается успешным, курсор помещается на первый (по ходу поиска) символ, имеющий запрошенные атрибуты. Как правило, PC курсор может быть успешно установлен на атрибуты внутри текстового окна.

Возвращаемое значение: Int, при успехе - WAS_SUCCESSFUL = 1, при неудаче - WAS_NOT_SUCCESSFUL = 0. FALSE = ошибка поиска.

Параметр 1:

Int, число, определяющее атрибут, или имя константы, обозначающее это число: ATTRIB_BOLD, ATTRIB_UNDERliNE, ATTRIB_ITAliC, ATTRIB_HIGHliGHT, и ATTRIB_STRIKEOUT. Можно комбинировать константы, объединяя их знаком +. Например, ATTRIB_BOLD+ATTRIB_UNDERliNE. Этот параметр является обязательным.

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

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

Функция FindNextAttribute

Описание: Ищет следующее вхождение текста с определёнными атрибутами. Поиск начинается там, где находится активный курсор и продолжается вниз, по оставшейся части окна. Если поиск оказывается успешным, активный курсор устанавливается на первый символ, имеющий запрошенные атрибуты. Как правило, PC курсор может быть успешно установлен на атрибуты внутри текстового окна.

Возвращаемое значение: Int, "WAS_SUCCESSFUL" = 1, "WAS_NOT_SUCCESSFUL" = 0.

Параметр 1:

Int, число, определяющее атрибут, или имя константы, обозначающее это число: ATTRIB_BOLD, ATTRIB_UNDERliNE, ATTRIB_ITAliC, ATTRIB_HIGHliGHT, и ATTRIB_STRIKEOUT. Можно комбинировать константы, объединяя их знаком +. Например, ATTRIB_BOLD+ATTRIB_UNDERliNE. Этот параметр является обязательным.

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

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

Функция FindPriorAttribute

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

Возвращаемое значение: Int, "WAS_SUCCESSFUL" = 1, "WAS_NOT_SUCCESSFUL" = 0.

Параметр 1:

Int, число, определяющее атрибут, или имя константы, обозначающее это число: ATTRIB_BOLD, ATTRIB_UNDERliNE, ATTRIB_ITAliC, ATTRIB_HIGHliGHT, и ATTRIB_STRIKEOUT. Можно комбинировать константы, объединяя их знаком +. Например, ATTRIB_BOLD+ATTRIB_UNDERliNE. Этот параметр является обязательным.

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

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

Скрипт FontChanges

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

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

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

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

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

Функция FormatAndText

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

Возвращаемое значение: String, описание значения, которое должно быть отражено в качестве сообщения Text Format/Attribute.

Параметр 1:

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

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

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

Функция GetCharacterAttributes

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

;Проверка атрибута подчеркивания
If (GetCharacterAttributes() & ATTRIB_UNDERliNE) Then
...
EndIf

Возвращаемое значение: Int, число, обозначающее атрибуты текущего символа.

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

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

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

Функция GetCharacterFont

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

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

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

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

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

Функция GetCharacterPoints

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

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

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

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

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

Функция GetCharacterWidth

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

Возвращаемое значение: Int, ширина символа или графического элемента; или же 0, если в позиции курсора ничего нет.

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

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

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

Функция GetFont

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

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

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

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

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

Функция GetLineBottom

Описание: Определяет вертикальную позицию в пикселях основания строки, содержащей текущий курсор.

Возвращаемое значение: Int, позиция пикселя основания строки под текущим курсором или ноль, если в текущей позиции нет текста

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

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

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

Функция GetLineTop

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

Возвращаемое значение: Int, позиция пикселя верхней линии самого высокого символа в строке или ноль, если в строке нет текста.

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

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

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

Функция GetParagraphFormatInfo

Описание: Отсутствует.

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

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

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

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

Функция GetWordWidth

Описание: Определяет ширину слова в пикселях.

Возвращаемое значение: int, ширина слова в пикселях.

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

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

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

Функция IntToAttribName

Описание: Преобразует числовое значение атрибута в наименование этого атрибута и возвращает это наименование.

Возвращаемое значение: String, Наименование атрибута.

Параметр 1:

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

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

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

Скрипт PointSizeChanges

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

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

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

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

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

Функция ProcessRepetitions

Описание: Сообщает количество повторений символа или characteristic; например: 2 indentations. (В версиях 5.00 и 5.10 не удалось вызвать эту функцию).

Возвращаемое значение: Int, если повторения найдены, то 1; если нет, то 0.

Параметр 1:

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

Параметр 2:

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

Параметр 3:

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

Параметр 4:

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

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

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

Функция SayAttributesChanges

Описание: Если меняется атрибут текста, то функция сообщает об этом. Функция сравнивает текущие атрибуты с предыдущими атрибутами текста.

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

Параметр 1:

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

Параметр 2:

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

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

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

Функция SayFont

Описание: Определяет параметры шрифта: наименование, размер, атрибуты (например: bold, underline, italic), которым отображается символ в позиции текущего курсора. Параметры шрифта, которые сообщает эта функция, для Рабочего стола и элементов окон, как правило, не соответствуют параметрам шрифта, которым будет данный текст напечатан на принтере.

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

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

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

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

Скрипт SayFont

Описание: Сообщает стиль, наименование шрифта, размер символа, а также атрибуты, например: bold, underline и italics (полужирный, подчёркнутый и курсив).

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

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

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

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

Функция SayFormatAndText

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

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

Параметр 1:

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

Параметр 2:

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

Параметр 3:

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

Параметр 4:

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

Параметр 5:

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

Параметр 6:

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

Параметр 7:

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

Параметр 8:

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

Параметр 9:

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

Параметр 10:

Int. тип выходного значения. Этот параметр является обязательным.

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

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

Скрипт SayTextAndAttributes

Описание: Читает видимый текст в активном окне, не перемещая курсора. Если происходит смена атрибутов текста, скрипт сообщает об этом.

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

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

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

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


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