Files
templates/tools/dsview/native/host_dialogs.h
T
Andrey afdf62cfa4 Добавить проверку Flash SCI, системные диалоги и векторизацию PDF
Расширить протокол SCI проверкой содержимого Flash и комплектом RAM-ядер.
Добавить утилиту векторизации PDF с OCR, общие диалоги DSView и проверки.
2026-11-18 16:03:53 +03:00

94 lines
17 KiB
C++

#pragma once // Заголовок подключается один раз независимо от порядка включения исходников встроенного DSView.
#include <QApplication> // Фильтр видит только диалоги текущего процесса DSView.
#include <QDialog> // Настройки и сообщения отделяются от меню, осциллограмм и других самостоятельных окон.
#include <QEvent> // Первое размещение выполняется после события показа диалога.
#include <QPointer> // Отложенная операция не обращается к уже закрытому окну настроек.
#include <QList> // Видимые диалоги упорядочиваются от родительских настроек к вложенным подтверждениям.
#include <QRect> // Геометрия сохраняет отрицательные координаты мониторов слева и сверху от основного.
#include <QTimer> // Нулевая задержка ждёт завершения автоматического размещения окна средствами Qt.
#include <algorithm> // Стабильная сортировка исключает зависимость размещения вложенных окон от порядка topLevelWidgets.
#ifdef Q_OS_WIN // Нативное встраивание DSView и владение окном SETGUI относятся к Windows.
#include <windows.h> // HWND, монитор и рабочая область определяются фактическим окном родителя другого процесса.
#endif // На остальных ОС заголовок не подключает функции WinAPI.
namespace setgui { // Средства интеграции не меняют контракты самостоятельного приложения DSView.
inline QRect host_dialog_geometry(const QRect &anchor, const QRect &work, const QSize &requested) { // Один расчёт применяется к реальным окнам и проверкам нескольких мониторов.
const QSize size(qMin(requested.width(), work.width()), qMin(requested.height(), work.height())); // Диалог ограничивается доступной областью текущего монитора в физических пикселях Windows.
const QPoint center = anchor.center(); // Настройки появляются над анализатором, а не в центре основного экрана компьютера.
const int x = qBound(work.left(), center.x() - size.width() / 2, work.right() - size.width() + 1); // Горизонтальная граница учитывает отрицательные координаты и включительный правый край QRect.
const int y = qBound(work.top(), center.y() - size.height() / 2, work.bottom() - size.height() + 1); // Вертикальная граница оставляет заголовок над рабочей областью, не закрывая его панелью задач.
return QRect(QPoint(x, y), size); // Готовая область описывает положение и размер одного плавающего диалога.
} // Перенос не зависит от сохранённых координат и прежнего монитора DSView.
#ifdef Q_OS_WIN // Владельцем диалогов становится верхнеуровневое окно SETGUI на текущем экране анализатора.
class HostDialogPlacement : public QObject { // QObject без Q_OBJECT не требует дополнительного шага moc при сборке рецепта.
HWND _surface; // Постоянный HWND области захвата сохраняется при отделении DSView и возврате во вкладку.
HWND _root = nullptr; // Верхнеуровневое окно меняется при переносе области в плавающую панель SETGUI.
HMONITOR _monitor = nullptr; // Монитор отслеживается по нативной иерархии, а не по устаревшему QWindow встроенного DSView.
QTimer _watch; // Отдельный таймер продолжает отслеживать экран во время модального exec, открытого внутри обработчика команд основного hostTimer.
static int depth(QWidget *widget) { // Родительские диалоги должны перемещаться раньше вложенных подтверждений.
int count = 0; // Число предков описывает только глубину Qt-иерархии, не экран или размер окна.
for (; widget; widget = widget->parentWidget()) ++count; // Обычные QWidget между диалогами также сохраняют правильный порядок родителей и потомков.
return count; // Корневой диалог всегда расположен выше своего вложенного окна в порядке перемещения.
} // Расчёт выполняется только при смене монитора или нативного владельца.
void place(QDialog *dialog) { // Вызывается только для реально видимого окна настроек текущего процесса DSView.
if (!dialog || !dialog->isVisible() || !_root || !IsWindow(_root)) return; // Закрытые диалоги и исчезнувший хост не получают новые нативные связи.
const HWND window = reinterpret_cast<HWND>(dialog->winId()); // Получаем собственное верхнеуровневое окно Qt после его показа.
if (GetWindowLongPtr(window, GWL_STYLE) & WS_CHILD) return; // Встроенный QMessageBox внутри составного диалога не переносится отдельно от своего содержимого.
HWND anchor = _root; // Обычные настройки размещаются над текущим основным или отделённым окном анализатора.
for (QWidget *parent = dialog->parentWidget(); parent; parent = parent->parentWidget()) { // Вложенное подтверждение должно оставаться поверх уже открытых настроек.
if (qobject_cast<QDialog*>(parent) && parent->isVisible()) { anchor = reinterpret_cast<HWND>(parent->winId()); break; } // Ближайший видимый диалог сохраняет естественную цепочку модальных окон.
} // Обычные QWidget между диалогом и DSView не подменяют владельца плавающего окна.
SetWindowLongPtr(window, GWLP_HWNDPARENT, reinterpret_cast<LONG_PTR>(anchor)); // Связь владельца удерживает настройки над анализатором, не превращая их в дочернюю вкладку или глобально верхнее окно.
RECT host_rect, dialog_rect; // WinAPI возвращает физические координаты обоих окон в одном пространстве нескольких мониторов.
MONITORINFO info = {}; info.cbSize = sizeof(info); // Размер структуры обязателен для чтения рабочей области без панели задач.
const HMONITOR monitor = MonitorFromWindow(_root, MONITOR_DEFAULTTONEAREST); // Экран выбирается по текущему положению анализатора даже после перемещения между мониторами.
if (!GetMonitorInfo(monitor, &info) || !GetWindowRect(anchor, &host_rect) || !GetWindowRect(window, &dialog_rect)) return; // При недоступной геометрии сохраняем безопасную связь владельца без произвольного переноса.
const QRect host(host_rect.left, host_rect.top, host_rect.right - host_rect.left, host_rect.bottom - host_rect.top); // Область владельца используется как центр размещения настроек.
const QRect work(info.rcWork.left, info.rcWork.top, info.rcWork.right - info.rcWork.left, info.rcWork.bottom - info.rcWork.top); // Доступная область относится к фактическому монитору SETGUI или отделённого DSView.
const QRect bounds = host_dialog_geometry(host, work, QSize(dialog_rect.right - dialog_rect.left, dialog_rect.bottom - dialog_rect.top)); // Единый расчёт ограничивает окно целиком текущим монитором.
SetWindowPos(window, nullptr, bounds.x(), bounds.y(), bounds.width(), bounds.height(), SWP_NOZORDER | SWP_NOACTIVATE); // Перемещаем диалог после автоматического центрирования Qt, не перехватывая фокус и не делая его глобально верхним.
} // Пользователь может перемещать плавающее окно вручную после начального размещения.
public: // Родитель-владелец задаётся существующим MainFrame встроенного DSView.
HostDialogPlacement(QObject *parent, HWND surface) : QObject(parent), _surface(surface), _watch(this) { // Область SETGUI уже проверена ShowEmbedded перед установкой фильтра.
_watch.setInterval(100); // Проверка каждые 100 миллисекунд работает только при открытых диалогах и сохраняет отзывчивость при переносе между экранами.
connect(&_watch, &QTimer::timeout, this, [this]() { // Модальный цикл Qt блокирует повторный timeout открывшего его hostTimer, поэтому здесь требуется независимый источник событий.
for (QWidget *widget : QApplication::topLevelWidgets()) { // Наличие видимых настроек проверяется без перечисления всех дочерних контролов DSView.
if (qobject_cast<QDialog*>(widget) && widget->isVisible()) { refresh(); return; } // Пока настройки открыты, следим за реальным монитором и владельцем анализатора.
} // После закрытия последнего окна настроек дополнительное наблюдение больше не требуется.
_watch.stop(); // В обычной работе без диалогов новый периодический опрос отсутствует.
}); // Родитель MainFrame отменяет таймер вместе с фильтром при завершении встроенного DSView.
qApp->installEventFilter(this); // Все настройки DSView обрабатываются одним правилом независимо от конкретного анализатора.
refresh(); // Запоминаем текущего владельца и монитор до первого открытия настроек.
} // Уничтожение QObject автоматически снимает фильтр приложения и отменяет отложенные действия.
void refresh() { // Существующий hostTimer и наблюдение открытых настроек используют один проверяемый маршрут обновления.
const HWND root = IsWindow(_surface) ? GetAncestor(_surface, GA_ROOT) : nullptr; // Корневой HWND следует за отделением, закреплением и переносом SETGUI.
const HMONITOR monitor = root ? MonitorFromWindow(root, MONITOR_DEFAULTTONEAREST) : nullptr; // Один дескриптор монитора обнаруживает реальную смену экрана.
if (root == _root && monitor == _monitor) return; // Ручное перемещение настроек не отменяется каждым тактом таймера.
_root = root; _monitor = monitor; // Обновляем положение владельца до переноса уже открытых диалогов.
QList<QPointer<QDialog>> dialogs; // Безопасные указатели исключают обращение к подтверждению, которое могло закрыться при перемещении родителя.
for (QWidget *widget : QApplication::topLevelWidgets()) { // Просматриваем только окна собственного процесса DSView.
if (auto dialog = qobject_cast<QDialog*>(widget)) dialogs.append(QPointer<QDialog>(dialog)); // Осциллограммы, меню и окна других приложений не участвуют в перемещении.
} // Порядок topLevelWidgets сам по себе не определяет отношения между родителями и потомками.
std::stable_sort(dialogs.begin(), dialogs.end(), [](const QPointer<QDialog> &left, const QPointer<QDialog> &right) { return depth(left.data()) < depth(right.data()); }); // Сначала переносим настройки, затем центрируем вложенные подтверждения над их новым положением.
for (const auto &dialog : dialogs) place(dialog.data()); // При фактической смене экрана все открытые настройки получают согласованные координаты.
} // Встроенный MainFrame больше не должен ошибочно считать основным монитором экран компьютера по умолчанию.
bool eventFilter(QObject *watched, QEvent *event) override { // После первого показа Qt мог использовать координаты невидимого встроенного MainFrame.
if (event->type() == QEvent::Show) { // Переразмещение выполняется один раз на показ, а не при каждом движении пользователя.
if (auto dialog = qobject_cast<QDialog*>(watched)) { // Фильтр не затрагивает раскрывающиеся меню и самостоятельные графики DSView.
_watch.start(); // С этого показа перенос между экранами обслуживается также внутри модального exec диалога.
const QPointer<QDialog> guarded(dialog); // Диалог может закрыться раньше выполнения отложенного события.
QTimer::singleShot(0, this, [this, guarded]() { if (guarded) { refresh(); place(guarded.data()); } }); // Сначала обновляем экран хоста, затем исправляем окончательное положение показанного окна.
} // Вложенные подтверждения получают своего видимого родителя тем же способом.
} // Все обычные события ввода и обработки диалогов остаются у Qt.
return false; // Фильтр меняет только размещение и никогда не подавляет модальный цикл, сохранение или закрытие настроек.
} // Правило применяется только к экземпляру, запущенному через --embed-parent.
}; // MainFrame владеет фильтром на протяжении одной встроенной сессии DSView.
#endif // Самостоятельный DSView на других платформах сохраняет исходное поведение своих диалогов.
} // Пространство имён отделяет интеграцию SETGUI от библиотек и диалогов DSView.