Класс 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 (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.1/qdesignerformwindowmanagerinterface.html