Класс QDesignerFormWindowManagerInterface
Класс QDesignerFormWindowManagerInterface позволяет управлять набором окон форм в Qt Designer и контролировать действия редактирования форм в Qt Designer. Подробнее...
| Заголовок: | #include <QDesignerFormWindowManagerInterface> |
| CMake: | find_package(Qt6 COMPONENTS Designer REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::Designer) |
| qmake: | QT += designer |
| Наследует: | QObject |
Типы публичного доступа
| перечисление | Action { CutAction, CopyAction, PasteAction, DeleteAction, SelectAllAction, …, FormWindowSettingsDialogAction } |
| перечисление | ActionGroup { StyledPreviewActionGroup } |
Функции публичного доступа
| QDesignerFormWindowManagerInterface(QObject *parent = nullptr) | |
| виртуальный | ~QDesignerFormWindowManagerInterface() |
| виртуальный QAction * | action(QDesignerFormWindowManagerInterface::Action action) const = 0 |
| виртуальный QActionGroup * | actionGroup(QDesignerFormWindowManagerInterface::ActionGroup actionGroup) const = 0 |
| виртуальный QDesignerFormWindowInterface * | activeFormWindow() const = 0 |
| виртуальный QDesignerFormEditorInterface * | core() const = 0 |
| виртуальный QDesignerFormWindowInterface * | createFormWindow(QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags()) = 0 |
| виртуальный QPixmap | createPreviewPixmap() const = 0 |
| виртуальный QDesignerFormWindowInterface * | formWindow(int index) const = 0 |
| виртуальный int | formWindowCount() const = 0 |
Свойства публичного доступа
| виртуальный void | addFormWindow(QDesignerFormWindowInterface *formWindow) = 0 |
| виртуальный void | closeAllPreviews() = 0 |
| виртуальный void | removeFormWindow(QDesignerFormWindowInterface *formWindow) = 0 |
| виртуальный void | setActiveFormWindow(QDesignerFormWindowInterface *formWindow) = 0 |
| виртуальный void | showPluginDialog() = 0 |
| виртуальный void | showPreview() = 0 |
Сигналы
| void | activeFormWindowChanged(QDesignerFormWindowInterface *formWindow) |
| void | formWindowAdded(QDesignerFormWindowInterface *formWindow) |
| void | formWindowRemoved(QDesignerFormWindowInterface *formWindow) |
| void | formWindowSettingsChanged(QDesignerFormWindowInterface *formWindow) |
Подробное описание
Класс QDesignerFormWindowManagerInterface не предназначен для прямого создания экземпляров. Qt Designer использует менеджер окон форм для управления различными окнами форм в своем рабочем пространстве. Вы можете получить интерфейс к менеджеру окон форм Qt Designer с помощью функции QDesignerFormEditorInterface::formWindowManager(). Например:
QDesignerFormWindowManagerInterface *manager = 0;
QDesignerFormWindowInterface *formWindow = 0;
manager = formEditor->formWindowManager();
formWindow = manager->formWindow(0);
manager->setActiveFormWindow(formWindow); При реализации плагина пользовательского виджета указатель на текущий объект QDesignerFormEditorInterface Qt Designer (formEditor в примере выше) предоставляется в качестве параметра функции QDesignerCustomWidgetInterface::initialize(). Вы должны унаследовать класс QDesignerCustomWidgetInterface, чтобы предоставить свой плагин Qt Designer.
Интерфейс менеджера окон форм предоставляет функцию createFormWindow(), которая позволяет создавать новое окно формы, которое можно добавить к набору окон форм, которые поддерживает менеджер, используя слот addFormWindow(). Он также предоставляет функцию formWindowCount() для получения количества окон форм, находящихся под управлением менеджера, функцию formWindow() для возвращения окна формы, связанного с заданным индексом, и функцию activeFormWindow() для возвращения текущего выбранного окна формы. Слот removeFormWindow() позволяет уменьшить количество окон форм, которые должен поддерживать менеджер, а слот setActiveFormWindow() позволяет изменить фокус окна формы в рабочем пространстве Qt Designer.
Кроме того, QDesignerFormWindowManagerInterface содержит набор функций, позволяющих вмешиваться и управлять действиями редактирования форм Qt Designer. Все эти функции возвращают исходное действие, что позволяет продолжить выполнение функции после вмешательства.
Наконец, интерфейс предоставляет три сигнала, которые испускаются, когда добавляется окно формы, когда изменяется текущее выбранное окно формы или когда окно формы удаляется соответственно. Все сигналы передают соответствующее окно формы в качестве параметра.
См. также QDesignerFormEditorInterface и QDesignerFormWindowInterface.
Документация по типам членов
[since 5.0] перечисление QDesignerFormWindowManagerInterface::Action
Определяет действие в Qt Designer.
| Константа | Значение | Описание |
|---|---|---|
QDesignerFormWindowManagerInterface::CutAction |
100 |
Вырезать в буфер обмена |
QDesignerFormWindowManagerInterface::CopyAction |
101 |
Копировать в буфер обмена |
QDesignerFormWindowManagerInterface::PasteAction |
102 |
Вставить из буфера обмена |
QDesignerFormWindowManagerInterface::DeleteAction |
103 |
Удалить из буфера обмена |
QDesignerFormWindowManagerInterface::SelectAllAction |
104 |
Выделить всё |
QDesignerFormWindowManagerInterface::LowerAction |
200 |
Опустить текущий виджет |
QDesignerFormWindowManagerInterface::RaiseAction |
201 |
Поднять текущий виджет |
QDesignerFormWindowManagerInterface::UndoAction |
300 |
Отменить |
QDesignerFormWindowManagerInterface::RedoAction |
301 |
Повторить |
QDesignerFormWindowManagerInterface::HorizontalLayoutAction |
400 |
Разметка с помощью QHBoxLayout |
QDesignerFormWindowManagerInterface::VerticalLayoutAction |
401 |
Разметка с помощью QVBoxLayout |
QDesignerFormWindowManagerInterface::SplitHorizontalAction |
402 |
Разметка по горизонтали с QSplitter |
QDesignerFormWindowManagerInterface::SplitVerticalAction |
403 |
Разметка по вертикали с QSplitter |
QDesignerFormWindowManagerInterface::GridLayoutAction |
404 |
Разметка с помощью QGridLayout |
QDesignerFormWindowManagerInterface::FormLayoutAction |
405 |
Разметка с помощью QFormLayout |
QDesignerFormWindowManagerInterface::BreakLayoutAction |
406 |
Прервать существующую разметку |
QDesignerFormWindowManagerInterface::AdjustSizeAction |
407 |
Настройка размера |
QDesignerFormWindowManagerInterface::SimplifyLayoutAction |
408 |
Упрощение QGridLayout или QFormLayout |
QDesignerFormWindowManagerInterface::DefaultPreviewAction |
500 |
Создание предварительного просмотра в стандартном стиле |
QDesignerFormWindowManagerInterface::FormWindowSettingsDialogAction |
600 |
Показать диалог с настройками формы |
Этот перечисление был введён или изменён в Qt 5.0.
См. также action().
[since 5.0] перечисление QDesignerFormWindowManagerInterface::ActionGroup
Определяет группу действий Qt Designer.
| Константа | Значение | Описание |
|---|---|---|
QDesignerFormWindowManagerInterface::StyledPreviewActionGroup |
100 |
Группа действий, содержащая действия предварительного просмотра со стилями |
Этот перечисление был введён или изменён в Qt 5.0.
См. также actionGroup().
Документация по членам-функциям
QDesignerFormWindowManagerInterface::QDesignerFormWindowManagerInterface(QObject *parent = nullptr)
Создаёт интерфейс с заданным parent для менеджера окна формы.
[signal] void QDesignerFormWindowManagerInterface::activeFormWindowChanged(QDesignerFormWindowInterface *formWindow)
Этот сигнал генерируется при изменении содержимого активного окна формы в рабочем пространстве Qt Designer. В качестве аргумента передаётся указатель на текущее активное formWindow.
См. также activeFormWindow().
[pure virtual slot] void QDesignerFormWindowManagerInterface::addFormWindow(QDesignerFormWindowInterface *formWindow)
Добавляет заданное formWindow в коллекцию окон, которые поддерживает менеджер окон формы Qt Designer.
См. также formWindowAdded().
[pure virtual slot, since 5.0] void QDesignerFormWindowManagerInterface::closeAllPreviews()
Закрыть все открытые в данный момент предварительные просмотры.
Эта функция была добавлена в Qt 5.0.
См. также showPreview().
[signal] void QDesignerFormWindowManagerInterface::formWindowAdded(QDesignerFormWindowInterface *formWindow)
Этот сигнал генерируется при добавлении нового окна формы в коллекцию окон, которые поддерживает менеджер окон формы Qt Designer. В качестве аргумента передаётся указатель на новое formWindow.
См. также addFormWindow() и setActiveFormWindow().
[signal] void QDesignerFormWindowManagerInterface::formWindowRemoved(QDesignerFormWindowInterface *formWindow)
Этот сигнал генерируется при удалении окна формы из коллекции окон, которые поддерживает менеджер окон формы Qt Designer. В качестве аргумента передаётся указатель на удалённое formWindow.
См. также removeFormWindow().
[signal] void QDesignerFormWindowManagerInterface::formWindowSettingsChanged(QDesignerFormWindowInterface *formWindow)
Этот сигнал генерируется при изменении настроек окна формы. Он может использоваться для соответствующего обновления заголовков окон и т. д. В качестве аргумента передаётся указатель на formWindow.
См. также FormWindowSettingsDialogAction.
[pure virtual slot] void QDesignerFormWindowManagerInterface::removeFormWindow(QDesignerFormWindowInterface *formWindow)
Удаляет заданное formWindow из коллекции окон, которые поддерживает менеджер окон формы Qt Designer.
См. также formWindow() и formWindowRemoved().
[pure virtual slot] void QDesignerFormWindowManagerInterface::setActiveFormWindow(QDesignerFormWindowInterface *formWindow)
Устанавливает указанное formWindow в качестве текущего активного окна формы в рабочем пространстве Qt Designer.
См. также activeFormWindow() и activeFormWindowChanged().
[pure virtual slot, since 5.0] void QDesignerFormWindowManagerInterface::showPluginDialog()
Открывает диалог, отображающий плагины, загруженные Qt Designer, и его ошибки загрузки плагинов.
Эта функция была добавлена в Qt 5.0.
[pure virtual slot, since 5.0] void QDesignerFormWindowManagerInterface::showPreview()
Показать предварительный просмотр текущей формы с использованием параметров по умолчанию.
Эта функция была добавлена в Qt 5.0.
См. также closeAllPreviews().
[virtual] QDesignerFormWindowManagerInterface::~QDesignerFormWindowManagerInterface()
Уничтожает интерфейс для менеджера окна формы.
[pure virtual, since 5.0] QAction *QDesignerFormWindowManagerInterface::action(QDesignerFormWindowManagerInterface::Action action) const
Возвращает действие, указанное значением перечисления action.
Заменяет функции доступа к действиям Qt 4.X.
Эта функция была добавлена в Qt 5.0.
[pure virtual, since 5.0] QActionGroup *QDesignerFormWindowManagerInterface::actionGroup(QDesignerFormWindowManagerInterface::ActionGroup actionGroup) const
Возвращает группу действий, указанную значением перечисления actionGroup.
Эта функция была добавлена в Qt 5.0.
[pure virtual] QDesignerFormWindowInterface *QDesignerFormWindowManagerInterface::activeFormWindow() const
Возвращает текущее активное окно формы в рабочем пространстве Qt Designer.
См. также setActiveFormWindow() и removeFormWindow().
[pure virtual] QDesignerFormEditorInterface *QDesignerFormWindowManagerInterface::core() const
Возвращает указатель на текущий объект QDesignerFormEditorInterface Qt Designer.
[pure virtual] QDesignerFormWindowInterface *QDesignerFormWindowManagerInterface::createFormWindow(QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())
Создаёт окно формы с заданным parent и флагами окна flags.
См. также addFormWindow().
[pure virtual] QPixmap QDesignerFormWindowManagerInterface::createPreviewPixmap() const
Создаёт пиксель, представляющий предварительный просмотр текущей активной формы.
[pure virtual] QDesignerFormWindowInterface *QDesignerFormWindowManagerInterface::formWindow(int index) const
Возвращает окно формы по заданному index.
См. также setActiveFormWindow() и removeFormWindow().
[pure virtual] int QDesignerFormWindowManagerInterface::formWindowCount() const
Возвращает количество окон форм, управляемых менеджером окон форм Qt Designer.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.0/qdesignerformwindowmanagerinterface.html