ProgressReader (Считыватель индикатора выполнения)

(C) 2025, Имам Кахраман

Лицензия: GNU General Public License v3 (GPL-3.0) (см. файл LICENSE: https://www.gnu.org/licenses/gpl-3.0.txt)

Это дополнение для NVDA позволяет считывать индикаторы выполнения (прогресс-бары) в различных приложениях и озвучивать текущий прогресс через речевой синтезатор. Обнаружение осуществляется через несколько интерфейсов для обеспечения широкой совместимости с различными программными технологиями. Дополнительно, дополнение предоставляет собственное окно автоматического обновления с многострочным текстовым полем только для чтения, которое автоматически обновляет отображение прогресса.

Скачать актуальную версию можно здесь

Содержание

1. Установка дополнения
2. Использование отображения прогресса
3. Примечания по функциональности
4. История версий
5. Лицензия и отказ от ответственности

1) Установка дополнения

Установка через Магазин дополнений NVDA

1. Откройте NVDA и перейдите в меню Сервис > Магазин дополнений.
2. Найдите "Progress Reader" и выберите его.
3. Нажмите "Установить" и следуйте инструкциям.
4. Перезапустите NVDA для активации дополнения.

Ручная установка (файл .nvda-addon)

Если дополнение недоступно в Магазине:

1. Скачайте файл .nvda-addon. Актуальная версия доступна для скачивания здесь.
2. Откройте NVDA и перейдите в меню Сервис > Магазин дополнений.
3. Нажмите «Установить из внешнего источника…» и выберите файл .nvda-addon.
4. Подтвердите установку и перезапустите NVDA для активации дополнения.

2) Использование отображения прогресса

1. Перейдите в приложение с активным индикатором выполнения (например, передача файлов, индикатор загрузки, установка ПО).
2. Нажмите NVDA + Shift + R, чтобы открыть окно автоматического обновления.
   • При открытии автоматически запоминаются найденные индикаторы выполнения.
   • Окно непрерывно отображает прогресс в многострочном текстовом поле.
   • Фокус автоматически переходит на первую строку при каждом обновлении.
   • Повторное нажатие NVDA + Shift + R закроет окно.
3. Нажмите NVDA + Shift + U, чтобы изменить интервал обновления (в секундах).

3) Примечания по функциональности

• Если в активном окне присутствует несколько индикаторов выполнения, все найденные запоминаются и отображаются в окне автоматического обновления.
• Если индикатор выполнения не обнаружен, NVDA произнесет сообщение "Индикатор выполнения не найден".
• Если значение прогресса или максимум не могут быть определены, предполагается стандартный диапазон 0–100%.
• Некоторые приложения используют проприетарные элементы интерфейса, которые не могут быть распознаны стандартными средствами.
• Все сочетания клавиш настраиваются через диалог «Жесты ввода» в NVDA и могут быть изменены пользователем.

4) История версий

v0.3.0:

• Окно вывода переведено на многострочное текстовое поле только для чтения (TextCtrl).
• Автоматический фокус на текстовом поле при открытии, курсор переходит на первую строку при обновлении.
• Изменен диалог настроек: ввод интервала в секундах (внутренне по-прежнему в миллисекундах).
• Кнопка «Сброс» в диалоге настроек восстанавливает интервал по умолчанию.
• Новая кнопка «Пожертвовать» в диалоге настроек открывает страницу PayPal в браузере по умолчанию.
• Окна/объекты индикаторов выполнения автоматически запоминаются при открытии окна обновления.
• Все строки пользовательского интерфейса подготовлены для перевода.
• Жесты зарегистрированы с использованием декоратора @script, что позволяет настраивать их в диалоге «Жесты ввода» NVDA.

v0.2.5

• Обновлено для NVDA 2025.3.2.
• Добавлена поддержка украинского языка (uk_UA).

v0.2.4

• Обновлено для NVDA 2025.2.

v0.2.3

• Обновлено для NVDA 2025.1.2.
• Добавлена поддержка упрощенного китайского языка (zh_CN).

v0.2.2

• Обновлено для NVDA 2025.1.1.

v0.2.1

• Обновлено для NVDA 2024.4.2.

v0.2.0

• Добавлены комментарии для переводчика.
• Очистка кода: удален метод отладки, так как он более не требуется.
• Добавлены комментарии, описывающие файл дополнения, включая версию файла.

v0.1.7

• Исправление ошибки: корректное обнаружение индикаторов выполнения – предотвращает ошибочное отображение "0% прогресса".
• Обновление языковых файлов.

v0.1.6

• Найденные в одном окне индикаторы выполнения выводятся в текстовом окне.
• Возможность изменения сочетания клавиш через диалог настроек: дополнение отображается в собственной категории.

v0.1.5

• Изменены отступы в коде на табуляцию.
• Добавлен английский перевод.
• Исправлена ошибка в файле readme.

v0.1.4

• Исправлено: обнаружение элементов UI в диалогах копирования и перемещения Windows.

v0.1.3

• Сочетание клавиш изменено на NVDA + SHIFT + U.
• Обновлено сочетание клавиш в файле ReadMe.
• Очистка кода.
• Использование лицензии GPL v3.0.

v0.1.2

• Улучшен файл ReadMe, добавлены примечания по использованию.
• Расширенная поддержка различных UI-технологий:
  • Нативные элементы управления Windows (классические индикаторы выполнения).
  • WPF / WinForms (технологии Microsoft .NET).
  • wxPython/wxWidgets (например, wx.Gauge).
  • Java-приложения (с корректным использованием Accessibility API).
  • Веб-индикаторы выполнения (зависит от браузера и поддержки ARIA).

v0.1.0

• Первая версия с базовой функциональностью для обнаружения и считывания индикаторов выполнения.

5) Лицензия и отказ от ответственности

Это дополнение распространяется под лицензией GNU General Public License v3 (GPL-3.0). Подробнее см. в файле LICENSE. Файл доступен здесь: https://www.gnu.org/licenses/gpl-3.0.txt

Условия лицензии:

• Это дополнение является свободным ПО и может распространяться, изменяться и передаваться далее при условии сохранения его статуса Open Source.
• Любые модификации должны публиковаться под той же лицензией (GPLv3).
• Запрещено использование в проприетарном или коммерческом программном обеспечении.

Отказ от ответственности:

Это дополнение предоставляется без каких-либо гарантий или условий. Автор не несет ответственности за любой ущерб или потерю данных, которые могут возникнуть в результате использования этого дополнения.

(C) 2025, Имам Кахраман

Лицензия: GNU General Public License v3 (GPL-3.0) (см. файл LICENSE: https://www.gnu.org/licenses/gpl-3.0.txt)

Пожертвовать через PayPal

• ProgressReader-V.0.3.0.nvda-addon
• ProgressReader-V.0.2.5.nvda-addon
• ProgressReader-V.0.2.4.nvda-addon
• ProgressReader-V.0.2.3.nvda-addon
• ProgressReader-V.0.2.2.nvda-addon
• ProgressReader-V.0.2.1.nvda-addon
• ProgressReader-V.0.2.0.nvda-addon
• ProgressReader-V.0.1.7.nvda-addon
• ProgressReader-V.0.1.6.nvda-addon
• ProgressReader-V.0.1.5.nvda-addon
• ProgressReader-V.0.1.5(1).nvda-addon
• ProgressReader-V.0.1.4.nvda-addon
• ProgressReader-V.0.1.3.nvda-addon