Скрипты для Virgo [Baum Retec AG] (doc) читать постранично

Скрипты для Virgo.

1.1. Зачем нам нужны скрипты?

Программа Virgo устроена таким образом, что может работать с любым приложением, удовлетворяющим стандартам Windows, без написания специальных скриптов. Однако многие программисты не обращают внимания на эти стандарты и создают свои собственные правила написания программ. Они программируют, например, кнопку, используя элемент «окно». Для зрячих людей это окно выглядит на экране как кнопка, поэтому их не волнует, какой это элемент. Однако на брайлевский дисплей и синтезатор речи выводится элемент «окно», и слепой пользователь думает, что это окно, поэтому ему и в голову не придет нажать на него, как на кнопку. В этом случае скрипт изменяет имя элемента «окно» на имя «кнопка», и тогда слепой пользователь знает, что с этим делать.
Кроме того, иногда необходимо собрать вместе несколько фрагментов информации, расположенных в различных частях экрана, чтобы показать их в компактной форме на брайлевском дисплее или воспроизвести в виде речи. Это тоже можно сделать с помощью скрипта.
Скрипты позволяют также получить доступ к внутренним функциям многих стандартных приложений, таких, например, как Word или Excel.
Имеется различие между скриптами Windows и скриптами Virgo.
В то время как скрипты Windows используются для создания элементов Windows на экране, например, диалоговых окон, скрипты Virgo нужны для влияния на существующие элементы на экране (например, для изменения их имен или порядка отображения на брайлевском дисплее). Это необходимо для того, чтобы объяснить слепому пользователю программные ситуации или правильно показать элементы, находящиеся на экране. Примером этого может служить диалоговое окно в Word 2000, которое появляется, когда Вы открываете файл. Курсор стоит в строке редактирования имени файла. Имя строки «Имя файла», однако, оно написано выше строки редактирования, в результате чего слепой пользователь нашел бы только пустую строку с курсором без понимания значения этой строки. Поэтому скрипт изменяет представление, и оба поля отображаются на брайлевской строке в горизонтальном порядке: сначала «Имя файла», затем пустое пространство для ввода имени файла.
В этой документации мы дадим Вам краткое введение в создание скриптов, чтобы Вы смогли самостоятельно делать небольшие адаптации прикладных программ.

1.2. Какие скрипты используются в Virgo?

Где найти скрипты и под какими именами они хранятся?

Все скрипты хранятся в папке «Scripts», которая находится в текущей папке Virgo (например, c:\Program Files\Virgo40\scripts).
Каждый скрипт должен иметь имя, совпадающее с именем приложения, для которого создан
этот скрипт, и расширение VBS.
Таким образом, загружаемое приложение автоматически распознает скрипт и выполняет его.
Для того чтобы посмотреть или отредактировать скрипт для какого-либо приложения, нужно загрузить это приложение и набрать на цифровом блоке команду N0/2 (уровень «слэш», команда «2»). Нужный скрипт будет загружен в текстовый редактор, используемый в Virgo для скриптов.

1.3. Какой редактор использовать?

Как стандарт Virgo использует редактор Notepad.exe, встроенный в Windows. Однако может быть использован любой другой редактор, который запускается вместе с именем файла. Большинство редакторов обычно удовлетворяют этому условию. Мы рекомендуем редактор, в котором Вы можете переходить на строки или столбцы непосредственно или где Вы, по крайней мере, можете получить информацию о точной позиции курсора.

Как назначить какой-либо редактор редактором скриптов Virgo?

1. Открыть файл phoenix.ini, который Вы найдёте в текущей папке Virgo.
2. Добавить в разделе " [SYSTEM] " строку, указывающую путь к файлу редактора, например, "editor=c:\pfe\pfe32".
3. Сохранить файл, и перезагрузить Virgo.

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

1.4. Краткое введение в Visual Basic

Для создания скриптов используется объектно-ориентированный язык программирования Visual Basic. В данном руководстве мы не ставим задачу обучить вас программированию на Visual Basic, поскольку этому посвящена специальная литература. Здесь мы дадим лишь краткий обзор некоторых, наиболее часто используемых в скриптах операторов Visual Basic, что позволит облегчить вам чтение существующих скриптов и написание своих собственных.

1.4.1. Оператор комментария

Оператор комментария не выполняет в скрипте никаких действий и может содержать произвольный текст. Этот оператор имеет две формы записи: самостоятельный оператор, начинающийся ключевым словом REM, за которым может следовать любой текст, или знак апострофа ('), который можно ставить после любого оператора. Примеры:
REM Это комментарий
А=1 ' Это тоже комментарий
' Script Name : DEFAULT.VBS
' Application : DEFAULT-Script for Virgo

1.4.2. Оператор присваивания

Общая форма оператора присваивания имеет вид:
ПЕРЕМЕННАЯ=ВЫРАЖЕНИЕ
Примеры:
DebugCnt = 0
DebugCnt = DebugCnt + 1

1.4.3. Оператор Dim

Используется для объявления переменной или массива переменных, которые можно будет