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