Import Macro File: используется для импорта файла макроса из ранних версий

JFW.

Synchronize Documentation: используется, чтобы убедиться в том, что файлы

скриптов и документация соответствуют друг другу. Также при вставке

скриптов из других .JSS файлов, он скопирует документацию в

соответствующий .JSD файл.

Print: стандартная функция.

Print Preview: стандартная функция.

Print Setup: стандартная функция.

Exit: стандартная функция.

Меню Edit

Все функции меню Edit совершенно стандартные, за исключением той, которая

приведена ниже.

Select Script: выделяет скрипт целиком, в котором находится курсор.

Меню Script

New Script: открывается диалог New Script для создания нового скрипта.

Delete Script: удаляет скрипт, на котором находится курсор.

Insert Function Call: выводит диалог Insert Function для добавления в скрипт

новой функции.

Insert Perform Script: выводит диалог Insert Perform Script для вызова другого

скрипта. Это аналогично вызову функции, но вызывается другой связанный с

клавишей скрипт, а не функция.

Next Script: перемещает курсор к началу следующего скрипта в файле.

Prior Script: перемещает курсор к началу предыдущего скрипта в файле.

Go To Line: перемещает курсор к указанной строке. Номера страницы

показаны на нижнем крае страницы.

Script List: выводит диалог Script List, в котором показаны скрипты в текущем

файле в алфавитном пррядке. Нажатие Enter на имени скрипта перемещает

вас к этому скрипту.

Меню View

Documentation: выводит диалог Script Information, который содержит всю

документацию для текущего скрипта.

Toolbar: стандартная функция.

Status Bar: стандартная функция.

Zoom: стандартная функция.

Меню Window

Все элементы в меню Window выполняют стандартные функции.

Меню Help

Help Topics: Стандартная функция.

keyword Help: выводит диалог KeyWord, который содержит помощь по

скрипту или функции, на которой находится курсор.

About Script Manager: стандартная функция.

Приложение C

Самые важные встроенные функции

Обратите внимание, что большинство элементов в этом списке расположены в

алфавитном порядке. Однако, некоторые были выведены из порядка, чтобы

расположить их рядом с функциями с аналогичной или соотносительной

функциональностью. Этот список был обновлен, чтобы отразить новые

функции, появившиеся в JFW 3.5. Те, кто пользуется более ранними версиями

Jaws, не будут иметь всех функций, перечисленных здесь.

ActivateMenuBar - активизирует/деактивизирует линейку меню для активной

программы. То же самое, что нажать и отпустить клавишу Alt.

? ActivateStartMenu - выводит меню "Пуск" в Windows 95, 98 и NT. То же

самое, что нажать Ctrl+Escape&

AddHook - устанавливает Hook функцию. Когда Hook на месте, он вызывается

перед тем, как отрабатывает скрипт и ему передается имя текущего скрипта и

фрейма в качестве параметров. Если Hook возвращает True, скрипту

разрешается выполняться. Если Hook возвращает False, скрипту не будет

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

KeyboardHelpHook в DEFAULT.JSS для примера Hщщл функции в действии.

Более подробно этот инструмент обсуждается в разделе о Hook функциях.

AltLeftMouseClick - отменяет выбор ранее выбранных элементов. Посылает в

систему Alt+щелчок левой кнопкой мыши.

ControlLeftMouseClick - симулирует Ctrl+щелчок левой кнопкой мыши. Эта

функция предоставляет способ выбирать элементы, расположенные вразброс. В

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

ShiftLeftMouseClick - симулирует Shift+щелчок левой кнопкой мыши. Эта

функция предоставляет способ выбора элементов, расположенных друг за

другом. Примером может служить выделение элементов в списке,

расположенных подряд.

BackspaceKey - если виртуальный курсор не является активным, эта функция

просто передает в приложение клавишу Enter. Если виртуальный курсор

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

режимом.

BrailleAddFocusItem - используется из функции BrailleBuildLine, чтобы

добавить содержание текущего органа управления к данным, которые должны

быть показаны на брайлевском дисплее.

BrailleAddFocusLine - используется из функции BrailleBuildLine, чтобы

добавить содержание текущей строки к данным, которые должны быть

показаны на брайлевском дисплее.

BrailleAddFrame - используется из функции BrailleBuildLine, чтобы добавить

содержание конкретного фрейма к данным, которые должны быть показаны

на брайлевском дисплее.

BrailleAddString - используется из функции BrailleBuildLine, чтобы добавить

текст к брайлевскому дисплею.

BrailleCursor - включает брайлевский курсор. Этот курсор используется только

внутренне брайлевскими скриптами и его никогда не следует оставлять

активизированным, после того как скрипт завершает свою работу.

BrailleG2StringLength - определяет длину перевода в брайль второй степени

данной строки.

BrailleG2StringLength - если структурированный режим является активным,

выводится следующая строка в брайлевской очереди. Если активным является

режим навигации, Jaws активизирует невидимый курсор и перемещает его к

следующей строке. В противном случае выполняется обычная функция

NextLine.

BraillePriorLine - если активным является структурированный режим,

выводится предыдущая строка в брайлевской очереди. Если активным является

режим навигации, Jaws активизирует невидимый курсор и и перемещает его к

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

PriorLine.

BrailleRefresh - используется для обновления брайлевского дисплея и для

повторного вывода соответствующего текста.

BrailleSetStatusCells - выводит символы в клетках статуса на брайлевском

дисплее. Эту функцию следует вызывать только из функции BrailleBuildStatus.

BrailleString - посылает указанную строку на брайлевский дисплей,

независимо от того, видима эта строка или нет.

CaretVisible - показывает, является ли курсор вставки, или каретка, видимой в

активном окне. Функция возвращает значение константы "True", чтобы

показать, что курсор виден, и значение "False", чтобы показать, что он не

виден.

ColorToRGBString - преобразует значение цвета в строку вида "255255255",

где первые три цифры представляют долю красного цвета, вторые три - долю

зеленого, а последние три - долю синего цвета.

ControlCanBeChecked - определяет, можно ли включать и выключать текущий

орган управления.

ControlIsChecked - определяет, является ли включенным текущий орган

управления.

CopyToClipboard - помещает строку текста в буфер обмена Windows, удаляя

любое предшествовавшее содержание буфера обмена. Чтобы скопировать

несколько строк текста, они должны быть сначала объединены в одну строку,

прежде чем вызывать CopyToClipboard. В соединенной строке строки должны

быть разделены символами \r\n.

CreateObject - для некоторых приложений, например Internet Explorer и

Microsoft Office, Jaws может получать информацию прямо из этого

приложения, а не ссылаться на то, что показано на экране. Для того, чтобы

сделать это, Jaws нужно место, чтобы получать эту информацию, и что-то

вроде путеводителя, чтобы сообщать, где искать. Путеводитель называется

указатель объекта, а место, куда он отсылает Jaws, называется

автоматический объект для этого приложения. Есть несколько способов

получения такого указателя объекта для данной задачи, не все из которых

работают со всеми приложениями. Один из таких способов - CreateObject.

CreateObject запускает приложение под управлением Jaws, при чем это

приложение является автоматическим объектом. Затем Jaws может запросить

этот автоматический объект, чтобы тот предоставил информацию, нужную

Jaws. Функция CreateObject аналогична функции GetObject, за исключением

того, что GetObject создает указатель на автоматический объект, который уже

существует, тогда как CreateObject также создает автоматический объект для

приложения.

Delay - заставляет скрипт остановиться на указанный промежуток времени.

Она заставляет скрипт остановиться, подождать некоторый период времени, а

затем снова продолжить работу. Она отличается от функции Pause, которая

приспосабливается к нуждам обработки приложения. После Delay скрипт

продолжит работу, независимо от того, закончило приложение необходимую

обработку, или нет.

DialogActive - используется для определения того, является ли в настоящий

момент активным окно диалога. Функция возвращает значение константы,

чтобы показать статус: "ACTIVE" = окно диалога активно, и "INACTIVE" =

окно диалога неактивно. Эти константы могут использоваться в If-Then-Else

конструкциях.

DLGSelectItemInList - выводит диалог, содержащий набор элементов меню.

Содержание меню строится пользователем, который должен предоставить

строку, содержащую каждый из элементов меню, которые должны быть

отделены друг от друга вертикальной чертой (|). Эта функция обычно

используется внутри другого скрипта или функции, который указывает, какие

действия нужно предпринимать, когда когда выбирается пункт меню и диалог

закрывается кнопкой OK. Когда диалог закрывается кнопкой OK, эта функция

возвращает индекс, который позволяет вызывающему скрипту решить, какие

действия предпринимать дальше. См. функцию под названием ToolBar4 в

файле SHDOCVW.JSS, где вы найдете пример того, как используется эта

функция.

DLGSelectScriptToRun - выводит диалог, содержащий набор скриптов. Список

скриптов строится пользователем. См. скрипт, озаглавленный

AdjustJawsVerbosity для примера того, как это сделано. Скрипты могут

выполняться из этого диалога.

DLGSysTray - выводит список, содержащий ярлыки в системном поддоне.

DownCell - находясь внутри таблицы, перемещает активный курсор к ячейке в

той же колонке, но в следующем ряду.

UpCell - находясь в таблице, перемещает активный курсор к

ячейке,находящейся в той же колонке, но на предыдущем ряду.

PriorCell - находясь в таблице, перемещает активный курсор к ячейке,

находящейся в том же ряду, но в предыдущей колонке.

NextCell - находясь в таблице, перемещает активный курсор к ячейке в том

же ряду, но в следующей колонке.

SayCell - находясь в таблице, озвучивает содержание текущей ячейки.

SayColumnHeader - находясь в таблице, озвучивает содержание заголовка

колонки.

SayRowHeader - находясь в таблице, озвучивает содержание заголовка ряда.

DragItemWithMouse - функция DragAndDrop (перетащить и бросить)

используется для перетаскивания содержания одной области экрана в другую

область экрана.

ElIf - вместо использования оператора Else в конструкции типа If-Then-Else,

можно использовать оператор ElIf. Утверждение можно будет

реконструировать в утверждение If-Then-ElIf-Then-Else. Каждое утверждение

должно заканчиваться оператором "EndIf". Функции скрипта, которые

помещаются между ElIf и Then используются для того, чтобы оценить,

наличествуют ли определенные условия.

Else - оператор Else является опциональной частью утверждения If-Then-Else.

Утверждения If-Then-Else всегда задают вопрос, является ли что-либо

истинным или ложным, то есть, наличествует определенное условие или

отсутствует. Когда условие отсутствует (False), выполняются действия,

стоящие после "Else". Утверждения If-Then-Else всегда должны включать: If,

Then, EndIf. Else является опциональным.

EndIf - оператор EndIf отмечает конец утверждения If-Then-Else. Полностью

сформулированное If-Then-Else утверждение включает jgthfnjhs "If", "Then", "Else" и

"Endif". "EndIf' всегда требуется для завершения утверждения If-Then-Else.

EndWhile - оператор EndWhile отмечает конец цикла While. Функции

скриптов, которые должны повторяться, необходимо помещать между "While"

и "EndWhile". (См. ниже описание функции While).

EnterKey - если виртуальный курсор не является активным, эта функция

просто передает в приложение клавишу Enter. Если виртуальный курсор

активен, и он позиционирован на линке или кнопке, активизируется этот

элемент управления. Если виртуальный курсор находится на другом элементе

формы, активизируется режим форм.

FileExists - проверяет, существует ли указанный путь.

FindColors - ищет наличие указанной комбинации цвета символа и заднего

плана. Если поиск оказывается успешным, Jaws курсор устанавливается в

начало текста с указанной комбинацией цветов.

FindDescendentWindow - нисходящее окно )Descendent window) - любое

дочернее окно некоторого указанного родительского окна. Оно может быть

дочерним на любом уровне ниже родительского и в любой ветви. Эта функция

ищет по всем ветвям родительского окна, чтобы найти любое дочернее окно

(нисходящее окно) с указанным контрольным идентификатором.

FindFirstAttribute - ищет первое вхождение текста с определенными

атрибутами. Она начинает поиск в левом верхнем углу указанного окна и

перемещается вниз. Если поиск оказывается успешным, активный курсор

устанавливается на первый символ, имеющий запрашиваемые атрибуты.

Обычно PC курсор может быть успешно установлен на атрибуты внутри

текстового окна.

FindNextAttribute - ищет следующее вхождение текста с определенными

атрибутами. Поиск начинается там, где находится активный курсор и

продолжается вниз, по оставшейся части окна. Если поиск оказывается

успешным, активный курсор устанавливается на первый символ, имеющий

запрошенные атрибуты.

FindPriorAttribute - ищет предыдущее вхождение текста с указанными

атрибутами. Поиск начинается в точке, где находится активный курсор и

продолжается вверх по оставшейся части активного окна. Если поиск

оказывается успешным, активный курсор устанавливается на первый символ с

запрашиваемыми атрибутами.

FindLastAttribute - ищет последнее вхождение текста с определенными

атрибутами. Поиск начинается в правом нижнем углу окна и ведется вверх

по окну. Если поиск оказывается успешным, курсор помещается на первый

символ, имеющий запрошенные атрибуты.

FindGraphic - FindGraphic ищет графику в указанном кне. Если графика

найдена, на нее устанавливается Jaws курсор. Графика должна иметь

ассоциированный с ней текстовый ярлык, поскольку функция FindGraphic

ищет текстовый ярлык. Текстовые ярлыки присваивает маркировщик графики.

FindString - FindString ищет строку текста в указанном окне. Если текст

найден, JaWS курсор устанавливается в начало текста.

FindTopLevelWindow - ищет самый верхний уровень окна с указанным

классом окна и/или именем окна. Если вам не нужен поиск, основанный на

одном из аргументов, используйте "" для этого аргумента.

GetActiveCursor - определяет, какой курсор является активным.

GetAppFileName - определяет имя файла активного приложения, или активный

компонент этого приложения, который был последовательно выполнен. Эти

имена файлов являются действительными файлами программ, которые

выполняются Windows. Имя файла приложения используется при присвоении

имени файлу скриптов.

GetAppFilePath - используется для получения полного пути и имени файла

текущего активного приложения. При совместном использовании с GetFileDate,

результаты можно использовать для определения версии приложения.

GetAppMainWindow - определяет ручку окна для главного окна активного

приложения.

GetAppTitle - получает заголовок текущего активного приложения. Чтобы

озвучить заголовок приложения, вы должны использовать эту функцию в

качестве параметра для функции Say.

GetBrailleCellColumn - вытаскивает столбец экрана, на котором находится

указанная брайлевская клетка.

GetBrailleCellRow - вытаскивает строку экрана, на которой находится

указанная брайлевская клетка.

GetCell - находясь в таблице, получает содержание текущей ячейки.

GetColumnHeader - находясь в таблице, получает заголовок текущей колонки.

GetRowHeader - находясь в таблице, получает заголовок текущего ряда.

GetCharacter - копирует символ или графический ярлык, где находится

активный курсор. Скопированный текст затем может быть использован

другими функциями скрипта.

GetCharacterAttributes - вытаскивает текстовые атрибуты символа в точке, где

находится активный курсор. Возвращенное значение является комбинацией тех

же битовых полей, которые используются в FindFirstAttribute,

FindNextAttribute и т.д. Чтобы протестировать на наличие конкретного

атрибута, используйте код в следующей форме: