QDesignerFormWindowCursorInterface 类
QDesignerFormWindowCursorInterface 类允许您查询和修改表单窗口的控件选择，并且还可以修改表单中所有控件的属性。[更多信息...](#details)
| 头文件 | #include <QDesignerFormWindowCursorInterface> |
| CMake | find_package(Qt6 REQUIRED COMPONENTS Designer) target_link_libraries(mytarget PRIVATE Qt6::Designer) |
| qmake | QT += designer |
公共类型
| 枚举 | MoveMode { MoveAnchor, KeepAnchor } |
| 枚举 | MoveOperation { NoMove, Start, End, Next, Prev, …, Down } |
公共函数
| 虚拟 | ~QDesignerFormWindowCursorInterface() |
| virtual QWidget * | current() const = 0 |
| virtual QDesignerFormWindowInterface * | formWindow() const = 0 |
| virtual bool | hasSelection() const = 0 |
| bool | isWidgetSelected(QWidget *widget) const |
| virtual bool | movePosition(QDesignerFormWindowCursorInterface::MoveOperation operation, QDesignerFormWindowCursorInterface::MoveMode mode = MoveAnchor) = 0 |
| virtual int | position() const = 0 |
| virtual void | resetWidgetProperty(QWidget *widget, const QString &name) = 0 |
| virtual QWidget * | selectedWidget(int index) const = 0 |
| virtual int | selectedWidgetCount() const = 0 |
| virtual void | setPosition(int position, QDesignerFormWindowCursorInterface::MoveMode mode = MoveAnchor) = 0 |
| virtual void | setProperty(const QString &name, const QVariant &value) = 0 |
| virtual void | setWidgetProperty(QWidget *widget, const QString &name, const QVariant &value) = 0 |
| virtual QWidget * | widget(int index) const = 0 |
| virtual int | widgetCount() const = 0 |
详细描述
QDesignerFormWindowCursorInterface 是一个便利类，它提供了一个与相关表单窗口文本光标的接口；它提供了一系列函数，允许您查询特定表单窗口的选择并按照定义的模式（MoveMode）和移动（MoveOperation）来更改选择焦点。您还可以使用该接口查询表单的控件并更改它们的属性。
该接口不是用于直接实例化的，而是为了提供访问当前Qt Designer表单窗口的选择和工具栏。 QDesignerFormWindowInterface总是提供关联的光标接口。可以使用静态QDesignerFormWindowInterface::findFormWindow()函数来检索指定组件的表单窗口。例如：
auto *formWindow = QDesignerFormWindowInterface::findFormWindow(myWidget); formWindow->cursor()->setProperty(myWidget, myProperty, newValue);
您可以通过Qt Designer的表单窗口管理器检索Qt Designer当前的所有表单窗口。
一旦您有了表单窗口的光标接口，您可以使用hasSelection()函数检查表单窗口是否有选择。您可以查询表单窗口的总widgetCount()和selectedWidgetCount()。您可以使用current()或selectedWidget()函数检索当前选中的组件（或组件集合）。
您可以使用widget()函数检索表单窗口的任何组件，并使用isWidgetSelected()函数检查组件是否被选中。您可以使用setProperty()函数设置所选组件的属性，以及使用setWidgetProperty()或resetWidgetProperty()函数修改任意组件的属性。
最后，您可以通过使用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 | 光标向下移动。 |
成员函数文档
[虚函数 noexcept] QDesignerFormWindowCursorInterface::~QDesignerFormWindowCursorInterface()
销毁光标接口。
[纯虚函数] QWidget *QDesignerFormWindowCursorInterface::current() const
返回窗口中当前选定的窗口小部件。
另请参阅selectedWidget()。
[纯虚函数] QDesignerFormWindowInterface *QDesignerFormWindowCursorInterface::formWindow() const
返回与课程界面关联的表单窗口接口。
[纯虚函数] bool QDesignerFormWindowCursorInterface::hasSelection() const
如果表单窗口包含选择，则返回 true；否则返回 false。
bool QDesignerFormWindowCursorInterface::isWidgetSelected(QWidget *widget) const
如果指定的 widget 被选中，则返回 true；否则返回 false。
[纯虚函数] bool QDesignerFormWindowCursorInterface::movePosition(QDesignerFormWindowCursorInterface::MoveOperation operation, QDesignerFormWindowCursorInterface::MoveMode mode = MoveAnchor)
使用指定的 mode 在光标上执行给定的 operation，如果成功完成，则返回 true；否则返回 false。
另请参阅position() 和 setPosition()。
[纯虚函数] int QDesignerFormWindowCursorInterface::position() const
返回光标位置。
另请参阅setPosition() 和 movePosition()。
[纯虚函数] void QDesignerFormWindowCursorInterface::resetWidgetProperty(QWidget *widget, const QString &name)
将指定 widget 的给定 name 属性重置为其默认值。
另请参阅setProperty() 和 setWidgetProperty()。
[纯虚函数] QWidget *QDesignerFormWindowCursorInterface::selectedWidget(int index) const
返回所选窗口小部件列表中具有给定 index 的窗口小部件。
[纯虚函数] int QDesignerFormWindowCursorInterface::selectedWidgetCount() const
返回表单窗口中选定的窗口小部件的数量。
另请参阅widgetCount()。
[纯虚函数] void QDesignerFormWindowCursorInterface::setPosition(int position, QDesignerFormWindowCursorInterface::MoveMode mode = MoveAnchor)
使用指定的 mode 模式将光标位置设置为给定 position。
[纯虚函数] void QDesignerFormWindowCursorInterface::setProperty(const QString &name, const QVariant &value)
将当前选定的控件设为给定 name 的属性为指定的 value。
[纯虚函数] void QDesignerFormWindowCursorInterface::setWidgetProperty(QWidget *widget, const QString &name, const QVariant &value)
将指定 widget 的 name 属性设置为指定的 value。
[纯虚函数] QWidget *QDesignerFormWindowCursorInterface::widget(int index) const
返回表单窗口控件列表中指定 index 的控件。
另请参阅selectedWidget()。
[纯虚函数] int QDesignerFormWindowCursorInterface::widgetCount() const
返回表单窗口中的控件数量。
另请参阅选择控件数量。
© 2024 Qt 公司。此处包含的文档贡献版权属于各自所有者。本提供的文档受免费软件基金会发布的 GNU 自由文档许可证版本 1.3 的条款所约束。Qt 和相关的标志是芬兰 Qt 公司及其在全球的其他国家/地区的商标。所有其他商标均为各自所有者的财产。
