Автор:	© Анатолий Камынин
Дата публикации:	2005

JFWAPI.DLL включает в себя набор функций, позволяющих 32-разрядным приложениям Windows использовать некоторые возможности программы экранного доступа JAWS for Windows версии 3.20.19 и выше.

Для того, чтобы воспользоваться функциями этой dll в приложении, написанном на языках C и C++, вы должны включить в свой проект заголовочный файл JFWAPI.H и библиотеку импорта JFWAPI.lib. Также вы можете загружать dll динамически (то есть посредством функции LoadLibrary ()), тогда библиотека импорта вам не нужна.

Доступные функции описаны ниже.

Функция JFWSayString

Назначение: Передает JFW строку текста для озвучивания.

Использование:

BOOL WINAPI JFWSayString(LPCTSTR lpszStrinToSpeak,BOOL bInterrupt);

Параметры:

• lpszStrinToSpeak - Текст, который необходимо озвучить.
• bInterrupt - Если TRUE, то текст, который синтезатор произносит в текущий момент будет прерван, чтобы озвучить текст, передаваемый этой функцией.

Возвращаемое значение: TRUE, если JFW запущен и если текст был принят для озвучивания. В противном случае возвращается FALSE.

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

Функция JFWStopSpeech

Назначение: Передает JFW команду немедленно прекратить озвучивание (замолчать).

Использование:

BOOL WINAPI JFWStopSpeech();

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

Возвращаемое значение: TRUE, если JFW запущен и озвучивание было прекращено. В противном случае возвращается FALSE.

Функция JFWRunScript

Назначение: Передает JFW команду выполнить скрипт (сценарий).

Использование:

BOOL WINAPI JFWRunScript(LPCTSTR lpszScriptName);

Параметры:

• lpszScriptName - Имя JFW скрипта (сценария), который необходимо выполнить.

Возвращаемое значение: TRUE, если JFW запущен и имя скрипта было принято для обработки. В противном случае возвращается FALSE.

Замечания: Возвращаемое значение TRUE означает лишь то, что имя скрипта было принято для обработки, но это не значит, что скрипт был выполнен. Когда JFW пытается выполнить скрипт с указанным именем, он сначала ищет скрипт в файле скриптов приложения, а затем - файле скриптов по умолчанию. Если нигде не будет найден скрипт с таким именем, то будет произнесено сообщение об ошибке.

Содержимое архива

Вы можете загрузить архив (38 Кб), содержащий следующие файлы:

• jfwapi.dll -модуль dll
• jfwapi.lib - библиотека импорта
• jfwapi.h - заголовочный файл
• jfwapi.omf - вариант библиотеки импорта для Borland C++ Builder (добавлен 02/25/2004 Donald Raikes). Чтобы использовать эту библиотеку в проектах Builder необходимо изменить расширение на .lib.
• jstest.cpp - простой пример консольного приложения, использующего jfwapi.dll.
• JFWAPICtrl.dll - элемент управления ActiveX, реализующий те же функции, что и jfwapi.dll.