Класс QDesignerFormWindowCursorInterface
Класс QDesignerFormWindowCursorInterface позволяет запросить и изменить выделение виджетов в окне формы, а также изменить свойства всех виджетов формы. Подробнее...
| Заголовок: | #include <QDesignerFormWindowCursorInterface> |
| qmake: | QT += designer |
Типы
| Перечисление | MoveMode { MoveAnchor, KeepAnchor } |
| Перечисление | MoveOperation { NoMove, Start, End, Next, ..., Down } |
Общедоступные функции
| виртуальный | ~QDesignerFormWindowCursorInterface() |
| виртуальный QWidget * | current() const = 0 |
| виртуальный QDesignerFormWindowInterface * | formWindow() const = 0 |
| виртуальный bool | hasSelection() const = 0 |
| bool | isWidgetSelected(QWidget *widget) const |
| виртуальный bool | movePosition(MoveOperation operation, 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, 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 позволяет запросить и изменить выделение виджетов в окне формы, а также изменить свойства всех виджетов формы.
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.
После получения интерфейса курсора окна формы, вы можете проверить, есть ли выделение в окне формы с помощью функции 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(MoveOperation operation, 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, 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/archives/qt-5.6/qdesignerformwindowcursorinterface.html