Класс QDesignerFormWindowCursorInterface
Класс QDesignerFormWindowCursorInterface позволяет запросить и изменить выбор виджетов в окне формы, а также изменить свойства всех виджетов формы. Подробнее...
| Заголовок: | #include <QDesignerFormWindowCursorInterface> |
| CMake: | find_package(Qt6 COMPONENTS Designer REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::Designer) |
| qmake: | QT += designer |
Открытые типы
| перечисление | MoveMode { MoveAnchor, KeepAnchor } |
| перечисление | MoveOperation { NoMove, Start, End, Next, Prev, …, Down } |
Открытые функции
| виртуальный | ~QDesignerFormWindowCursorInterface() |
| виртуальный QWidget * | current() const = 0 |
| виртуальный QDesignerFormWindowInterface * | formWindow() const = 0 |
| виртуальный bool | hasSelection() const = 0 |
| bool | isWidgetSelected(QWidget *widget) const |
| виртуальный bool | movePosition(QDesignerFormWindowCursorInterface::MoveOperation operation, QDesignerFormWindowCursorInterface::MoveMode mode = MoveAnchor) = 0 |
| виртуальный int | position() const = 0 |
| виртуальный void | resetWidgetProperty(QWidget *widget, const QString &name) = 0 |
| виртуальный QWidget * | selectedWidget(int index) const = 0 |
| виртуальный int | selectedWidgetCount() const = 0 |
| виртуальный void | setPosition(int position, QDesignerFormWindowCursorInterface::MoveMode mode = MoveAnchor) = 0 |
| виртуальный void | setProperty(const QString &name, const QVariant &value) = 0 |
| виртуальный void | setWidgetProperty(QWidget *widget, const QString &name, const QVariant &value) = 0 |
| виртуальный QWidget * | widget(int index) const = 0 |
| виртуальный int | widgetCount() const = 0 |
Подробное описание
QDesignerFormWindowCursorInterface — это удобный класс, который предоставляет интерфейс к курсору текста связанного окна формы; он предоставляет набор функций, позволяющих запросить выделение данного окна формы и изменить фокус выделения в соответствии с определенными режимами (MoveMode) и перемещениями (MoveOperation). Вы также можете использовать интерфейс для запроса виджетов формы и изменения их свойств.
Интерфейс не предназначен для непосредственного создания экземпляров, но для предоставления доступа к выделениям и виджетам текущих окон формы Qt Designer. QDesignerFormWindowInterface всегда предоставляет связанный интерфейс курсора. Окно формы для данного виджета можно получить с помощью статических функций QDesignerFormWindowInterface::findFormWindow(). Например:
QDesignerFormWindowInterface *formWindow = 0;
formWindow = QDesignerFormWindowInterface::findFormWindow(myWidget);
formWindow->cursor()->setProperty(myWidget, myProperty, newValue); Вы можете получить доступ к любому из текущих окон Qt Designer через менеджер окон формы Qt Designer form window manager.
После получения интерфейса курсора окна формы вы можете проверить, есть ли выделение в окне формы вообще, используя функцию hasSelection(). Вы можете запросить общее количество widgetCount() и selectedWidgetCount() виджетов окна формы. Вы можете получить текущий выделенный виджет (или виджеты) с помощью функций current() или selectedWidget().
Вы можете получить любые виджеты окна формы с помощью функции widget() и проверить, выбран ли виджет, используя функцию isWidgetSelected(). Вы можете использовать функцию setProperty() для установки свойств выделенного виджета и функции setWidgetProperty() или resetWidgetProperty() для изменения свойств любого заданного виджета.
Наконец, вы можете изменить выделение, изменив положение курсора текста с помощью функций position(), setPosition() и movePosition().
См. также QDesignerFormWindowInterface и QDesignerFormWindowManagerInterface.
Документация по типам членов
перечисление QDesignerFormWindowCursorInterface::MoveMode
Это перечисление описывает различные режимы, используемые при перемещении курсора текста.
| Постоянная | Значение | Описание |
|---|---|---|
QDesignerFormWindowCursorInterface::MoveAnchor |
0 |
Якорь перемещается вместе с курсором в его новое положение. |
QDesignerFormWindowCursorInterface::KeepAnchor |
1 |
Якорь остается в старом положении курсора. |
перечисление QDesignerFormWindowCursorInterface::MoveOperation
Это перечисление описывает типы операций с курсором текста, которые могут выполняться в окне формы.
| Постоянная | Значение | Описание |
|---|---|---|
QDesignerFormWindowCursorInterface::NoMove |
0 |
Курсор не перемещается. |
QDesignerFormWindowCursorInterface::Start |
1 |
Перемещает курсор к началу цепочки фокуса. |
QDesignerFormWindowCursorInterface::End |
2 |
Перемещает курсор к концу цепочки фокуса. |
QDesignerFormWindowCursorInterface::Next |
3 |
Перемещает курсор к следующему виджету в цепочке фокуса. |
QDesignerFormWindowCursorInterface::Prev |
4 |
Перемещает курсор к предыдущему виджету в цепочке фокуса. |
QDesignerFormWindowCursorInterface::Left |
5 |
Курсор перемещается влево. |
QDesignerFormWindowCursorInterface::Right |
6 |
Курсор перемещается вправо. |
QDesignerFormWindowCursorInterface::Up |
7 |
Курсор перемещается вверх. |
QDesignerFormWindowCursorInterface::Down |
8 |
Курсор перемещается вниз. |
Документация по функциям-членам
[virtual] QDesignerFormWindowCursorInterface::~QDesignerFormWindowCursorInterface()
Удаляет интерфейс курсора.
[pure virtual] QWidget *QDesignerFormWindowCursorInterface::current() const
Возвращает текущий выделенный виджет в окне формы.
См. также selectedWidget().
[pure virtual] QDesignerFormWindowInterface *QDesignerFormWindowCursorInterface::formWindow() const
Возвращает интерфейс окна формы, связанный с этим интерфейсом курсора.
[pure virtual] bool QDesignerFormWindowCursorInterface::hasSelection() const
Возвращает true, если окно формы содержит выделение; в противном случае возвращает false.
bool QDesignerFormWindowCursorInterface::isWidgetSelected(QWidget *widget) const
Возвращает true, если указанный widget выделен; в противном случае возвращает false.
[pure virtual] bool QDesignerFormWindowCursorInterface::movePosition(QDesignerFormWindowCursorInterface::MoveOperation operation, QDesignerFormWindowCursorInterface::MoveMode mode = MoveAnchor)
Выполняет заданную operation над курсором, используя указанный mode, и возвращает true, если выполнение прошло успешно; в противном случае возвращает false.
См. также position() и setPosition().
[pure virtual] int QDesignerFormWindowCursorInterface::position() const
Возвращает позицию курсора.
См. также setPosition() и movePosition().
[pure virtual] void QDesignerFormWindowCursorInterface::resetWidgetProperty(QWidget *widget, const QString &name)
Сбрасывает свойство с заданным name для указанного widget до его значения по умолчанию.
См. также setProperty() и setWidgetProperty().
[pure virtual] QWidget *QDesignerFormWindowCursorInterface::selectedWidget(int index) const
Возвращает виджет с заданным index в списке выделенных виджетов.
См. также current() и widget().
[pure virtual] int QDesignerFormWindowCursorInterface::selectedWidgetCount() const
Возвращает количество выделенных виджетов в окне формы.
См. также widgetCount().
[pure virtual] void QDesignerFormWindowCursorInterface::setPosition(int position, QDesignerFormWindowCursorInterface::MoveMode mode = MoveAnchor)
Устанавливает позицию курсора в заданное position, используя mode для указания способа перемещения.
См. также position() и movePosition().
[pure virtual] void QDesignerFormWindowCursorInterface::setProperty(const QString &name, const QVariant &value)
Устанавливает свойство с заданным name для текущего выделенного виджета в указанное value.
См. также setWidgetProperty() и resetWidgetProperty().
[pure virtual] void QDesignerFormWindowCursorInterface::setWidgetProperty(QWidget *widget, const QString &name, const QVariant &value)
Устанавливает свойство с заданным name для данного widget в указанное value.
См. также resetWidgetProperty() и setProperty().
[pure virtual] QWidget *QDesignerFormWindowCursorInterface::widget(int index) const
Возвращает виджет с заданным index в списке виджетов в окне формы.
См. также selectedWidget().
[pure virtual] int QDesignerFormWindowCursorInterface::widgetCount() const
Возвращает количество виджетов в окне формы.
См. также selectedWidgetCount().
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.2/qdesignerformwindowcursorinterface.html