Читач індикатора виконання (Progress Reader)

(C) 2025, Imam Kahraman

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

Цей додаток NVDA дозволяє озвучувати індикатори виконання (progress bar) у різних застосунках та повідомляти поточний прогрес голосом.
Виявлення відбувається через кілька інтерфейсів, що забезпечує широку сумісність із різними програмними технологіями.

Посилання на актуальну версію для завантаження

Зміст

1. Встановлення додатка
2. Використання індикатора виконання
3. Примітки щодо функціональності
4. Історія версій
5. Ліцензія та відмова від відповідальності

1) Встановлення додатка

Встановлення через Магазин додатків NVDA

1. Відкрийте NVDA меню та перейдіть у підменю Інструменти > Магазин додатків.
2. Знайдіть «Читач індикатора виконання» та виберіть його.
3. Натисніть «Встановити» та дотримуйтесь інструкцій.
4. Перезапустіть NVDA, щоб активувати додаток.

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

Якщо додаток відсутній у Магазині:

1. Завантажте .nvda-addon файл. Посилання на актуальну версію для завантаження
2. Відкрийте NVDA меню та перейдіть у підменю Інструменти > Магазин додатків.
3. Натисніть «Встановити з зовнішнього джерела…» та виберіть .nvda-addon файл.
4. Підтвердьте встановлення та перезапустіть NVDA, щоб активувати додаток.

2) Використання індикатора виконання

1. Перейдіть у застосунок з активним індикатором виконання (наприклад, копіювання файлів, процес встановлення чи завантаження).
2. Натисніть NVDA + Shift + U, щоб озвучити поточний прогрес.
3. NVDA повідомить відсоток виконання, наприклад: «42% виконання (активний)».

3) Примітки щодо функціональності

• Якщо у вікні є кілька індикаторів виконання, використовується перший знайдений.
• Якщо індикатор виконання не знайдено, NVDA повідомить: «Індикатор виконання не знайдено».
• Якщо значення прогресу або максимум не можуть бути визначені, використовується діапазон 0–100%.
• Деякі застосунки використовують власні UI-елементи, які не завжди виявляються стандартними методами.

4) Історія версій

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 (.NET технології Microsoft)
• 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

Умови ліцензії:

• Цей додаток є вільним програмним забезпеченням і може поширюватися, змінюватися та передаватися далі, поки він залишається відкритим кодом.
• Будь-які зміни мають публікуватися під тією ж ліцензією (GPLv3).
• Використання у пропрієтарному чи комерційному ПЗ заборонене.

Відмова від відповідальності:

Додаток надається «як є» без жодних гарантій. Автор не несе відповідальності за будь-які пошкодження чи втрату даних, що можуть виникнути внаслідок його використання.

(C) 2025, Imam Kahraman

Ліцензія: GNU General Public License v3 (GPL-3.0) (див. LICENSE: https://www.gnu.org/licenses/gpl-3.0.txt)

Підтримати через PayPal