Расширить протокол SCI проверкой содержимого Flash и комплектом RAM-ядер. Добавить утилиту векторизации PDF с OCR, общие диалоги DSView и проверки.
92 lines
14 KiB
Python
92 lines
14 KiB
Python
"""Локальный адаптер самостоятельного приложения для вкладки SETGUI.""" # Qt и OCR остаются в отдельном процессе с собственными зависимостями.
|
|
import ctypes # Встроенному нативному окну Windows требуется восстановление клавиатурного фокуса.
|
|
import json # Строковый протокол сохраняет пути Unicode без оболочки командной строки.
|
|
import sys # Платформенные операции с HWND применяются только в Windows.
|
|
from pathlib import Path # Сопоставляем запрошенный PDF с реально открытым документом.
|
|
from PySide6 import QtCore as C, QtWidgets as W # Адаптер использует тот же Qt, что самостоятельная программа.
|
|
from PySide6.QtNetwork import QLocalSocket # Именованный локальный канал работает также в EXE без консоли.
|
|
from gui import MainWindow # Все операции OCR, предпросмотра и экспорта сохраняют одну реализацию.
|
|
|
|
|
|
class HostedWindow(MainWindow): # Расширяем программу только поведением размещения внутри SETGUI.
|
|
def __init__(self, server, settings_path=None): # Сервер создаёт конкретная вкладка, а профиль можно изолировать для проверки.
|
|
super().__init__(settings_path) # Подготавливаем исходный интерфейс и собственный рабочий каталог.
|
|
self._hosted = True # Признак нужен для сохранения документа при запросе выхода из SETGUI.
|
|
self._closing = False # Вложенный цикл диалога не должен создавать повторный запрос сохранения.
|
|
self.channel = QLocalSocket(self) # Канал принадлежит окну и освобождается вместе с ним.
|
|
self.channel.connected.connect(self._ready) # HWND публикуется только после установления локального соединения.
|
|
self.channel.readyRead.connect(self._read_commands) # Команды обрабатываются в основном потоке приложения.
|
|
self.channel.disconnected.connect(self._disconnected) # Сбой родителя не должен уничтожать несохранённый результат.
|
|
W.QApplication.instance().installEventFilter(self) # Щелчок по встроенной форме возвращает фокус её собственному потоку Windows.
|
|
self.channel.connectToServer(server) # Подключаемся только к каналу запустившей программу вкладки.
|
|
|
|
def send(self, **message): # Одинаковая сериализация используется всеми ответами компонента.
|
|
self.channel.write((json.dumps(message, ensure_ascii=True) + "\n").encode("utf-8")) # ASCII-экранирование сохраняет кириллицу независимо от кодовой страницы.
|
|
self.channel.flush() # Сообщение об отмене выхода сразу возвращает управление пользователю SETGUI.
|
|
|
|
def _ready(self): # Соединение может установиться до первого показа окна.
|
|
self.send(event="ready", window=int(self.winId())) # Созданный HWND позволяет родителю проверить владельца и встроить окно.
|
|
|
|
def eventFilter(self, watched, event): # Отдельные процессы Qt имеют независимые очереди клавиатурного ввода.
|
|
if self._hosted and event.type() == C.QEvent.MouseButtonPress and isinstance(watched, W.QWidget) and watched.window() is self and sys.platform == "win32" and W.QApplication.platformName() != "offscreen": # Исправление применяется только при реальном щелчке внутри встроенного окна Windows.
|
|
from ctypes import wintypes # Разрядность указателей HWND должна соответствовать текущему Python.
|
|
api = ctypes.WinDLL("user32", use_last_error=True) # Используем системный диспетчер окон без сторонних библиотек.
|
|
api.SetFocus.argtypes, api.SetFocus.restype = [wintypes.HWND], wintypes.HWND # Явные типы предотвращают усечение 64-разрядного дескриптора.
|
|
self.activateWindow() # Qt восстанавливает логический фокус дочерних элементов.
|
|
api.SetFocus(int(self.winId())) # Windows направляет ввод потоку самостоятельной программы.
|
|
return super().eventFilter(watched, event) # Обработка исходного щелчка и остальных событий продолжается штатно.
|
|
|
|
def _allow_replace(self): # Проверяем рабочий процесс и несохранённый результат перед закрытием или открытием другого PDF.
|
|
if self.process is not None: # Действующий OCR нельзя молча завершить при выходе родителя.
|
|
answer = W.QMessageBox.question(self, "Преобразование PDF", "Прервать обработку и продолжить?", W.QMessageBox.Yes | W.QMessageBox.Cancel, W.QMessageBox.Cancel) # Отмена по умолчанию сохраняет выполняемую операцию.
|
|
if answer != W.QMessageBox.Yes: # Любой отказ оставляет интерфейс и рабочий процесс открытыми.
|
|
return False # Родитель получает сообщение об отменённом закрытии.
|
|
return True # Штатный closeEvent остановит собственный рабочий процесс перед освобождением ресурсов.
|
|
if self.result is not None and not self.result_saved: # Готовый PDF во временной папке ещё не является пользовательским файлом.
|
|
answer = W.QMessageBox.question(self, "Результат PDF", "Сохранить обработанный PDF перед продолжением?", W.QMessageBox.Save | W.QMessageBox.Discard | W.QMessageBox.Cancel, W.QMessageBox.Save) # Пользователь решает судьбу конкретного результата.
|
|
if answer == W.QMessageBox.Save: # Сохранение использует исходный диалог и атомарную запись программы.
|
|
self.save_pdf() # Ошибка записи или отмена диалога сохраняют прежний признак result_saved.
|
|
return self.result_saved # Продолжаем только после успешной записи пользовательского PDF.
|
|
return answer == W.QMessageBox.Discard # Отмена не уничтожает временный документ.
|
|
return True # Без работающего OCR и несохранённого результата дополнительных действий не требуется.
|
|
|
|
def _read_commands(self): # Неполная строка остаётся в канале до следующего readyRead.
|
|
while self.channel.canReadLine(): # За одно событие обрабатываем все уже полученные команды.
|
|
try: # Неверная команда не должна завершать программу с открытым документом.
|
|
message = json.loads(bytes(self.channel.readLine(1048577)).decode("utf-8")) # Один мегабайт в байтах покрывает тему SETGUI и ограничивает размер отдельной команды.
|
|
command = message.get("command") # Служебные события отличаются явным именем действия.
|
|
if command == "close" and not self._closing: # Повторная команда во время диалога игнорируется.
|
|
self.close() # Закрытие проходит ту же проверку сохранения, что системная кнопка окна.
|
|
elif command == "style": # Тема приходит после встраивания HWND в родительскую вкладку.
|
|
self.setStyleSheet(str(message["stylesheet"])) # Самостоятельная программа получает актуальное оформление SETGUI.
|
|
elif command == "open": # Новый PDF передаётся через канал без перезапуска приложения.
|
|
path = Path(message["path"]).resolve() # Абсолютный путь не зависит от рабочего каталога компонента.
|
|
accepted = self.process is None and self._allow_replace() # Во время OCR документ не заменяется даже после подтверждения прерывания.
|
|
if accepted: # Только подтверждённая замена может очистить прежний результат.
|
|
self.load_pdf(str(path)) # Исходная проверка обрабатывает формат PDF и пароль.
|
|
accepted = self.source_path == path # Сообщаем о фактически открытом документе после возможного отказа диалога.
|
|
self.send(event="opened", accepted=bool(accepted), path=str(path)) # Родитель отображает результат запроса вместо преждевременного успеха.
|
|
except (ValueError, TypeError, KeyError, AttributeError, OSError) as error: # Ошибки формата или файловой системы остаются диагностикой канала.
|
|
self.send(event="error", message=str(error)) # SETGUI показывает причину, сохраняя доступ к другим инструментам.
|
|
|
|
def _disconnected(self): # При аварии SETGUI приложение превращается в самостоятельное окно.
|
|
if self._hosted and not self._closing and self.isVisible(): # Закрытое окно не должно повторно появляться при завершении приложения.
|
|
self._hosted = False # Следующее закрытие не требует отправки сообщения исчезнувшему родителю.
|
|
self.windowHandle().setParent(None) # Убираем принадлежность нативному контейнеру завершившегося процесса.
|
|
self.setWindowFlags(C.Qt.Window) # Возвращаем заголовок и системные кнопки самостоятельного окна.
|
|
self.show() # Пользователь продолжает работу с исходным результатом без повторного OCR.
|
|
|
|
def closeEvent(self, event): # SETGUI ждёт подтверждённого завершения, сохраняя отзывчивый интерфейс.
|
|
if self._closing: # Вложенный цикл вопроса о сохранении может принять ещё одну команду close.
|
|
event.ignore() # Защищаем окно от повторного освобождения открытых PDF и очереди OCR.
|
|
return # Первый запрос остаётся единственным владельцем процедуры закрытия.
|
|
self._closing = True # Фиксируем начало процедуры до показа любого модального диалога.
|
|
try: # Флаг снимается также после отмены сохранения или ошибки диалога.
|
|
if not self._allow_replace(): # Неуспешное сохранение и отмена оставляют процесс работающим.
|
|
event.ignore() # Контейнер SETGUI продолжает показывать тот же документ.
|
|
self.send(event="close_cancelled") # Родитель снимает ожидание выхода и не уничтожает вкладку.
|
|
return # Временная папка и исходный PDF остаются открытыми.
|
|
super().closeEvent(event) # Исходный обработчик завершает OCR, сохраняет профиль и освобождает временные файлы.
|
|
finally: # Результат диалога не должен блокировать следующий запрос закрытия.
|
|
self._closing = False # Повторное действие пользователя снова проходит полноценную проверку.
|