En esta página

QDesignerFormWindowCursorInterface Class

La clase `QDesignerFormWindowCursorInterface` permite consultar y modificar la selección de widgets de una ventana de formulario, así como modificar las propiedades de todos los widgets del formulario. Más información...

Encabezado: #include <QDesignerFormWindowCursorInterface>
CMake: find_package(Qt6 REQUIRED COMPONENTS Designer)
target_link_libraries(mytarget PRIVATE Qt6::Designer)
qmake: QT += designer

Tipos públicos

enum MoveMode { MoveAnchor, KeepAnchor }
enum MoveOperation { NoMove, Start, End, Next, Prev, …, Down }

Funciones públicas

QDesignerFormWindowCursorInterface()
QDesignerFormWindowCursorInterface(const QDesignerFormWindowCursorInterface &)
QDesignerFormWindowCursorInterface(QDesignerFormWindowCursorInterface &&)
virtual ~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 &operator=(QDesignerFormWindowCursorInterface &&)
QDesignerFormWindowCursorInterface &operator=(const QDesignerFormWindowCursorInterface &)

Descripción detallada

QDesignerFormWindowCursorInterface es una clase de conveniencia que proporciona una interfaz para el cursor de texto de la ventana de formulario asociada; ofrece un conjunto de funciones que permiten consultar la selección de una ventana de formulario determinada y cambiar el foco de la selección según los modos definidos (MoveMode) y los movimientos (MoveOperation). También se puede utilizar la interfaz para consultar los widgets del formulario y modificar sus propiedades.

La interfaz no está pensada para ser instanciada directamente, sino para proporcionar acceso a las selecciones y a los widgets de las ventanas de formulario actuales de ` Qt Widgets Designer`. ` QDesignerFormWindowInterface ` siempre proporciona una interfaz de cursor asociada. La ventana de formulario de un widget determinado se puede recuperar utilizando las funciones estáticas ` QDesignerFormWindowInterface::findFormWindow()`. Por ejemplo:

    auto *formWindow = QDesignerFormWindowInterface::findFormWindow(myWidget);

    formWindow->cursor()->setProperty(myWidget, myProperty, newValue);

Puedes recuperar cualquiera de las ventanas de formulario actuales de Qt Widgets Designer a través de form window manager de Qt Widgets Designer.

Una vez que se dispone de la interfaz del cursor de una ventana de formulario, se puede comprobar si dicha ventana tiene alguna selección mediante la función ` hasSelection()`. Se puede consultar la ventana de formulario para obtener su número total de elementos mediante ` widgetCount()` y ` selectedWidgetCount()`. Se puede recuperar el widget (o widgets) seleccionado actualmente mediante las funciones ` current()` o ` selectedWidget()`.

Se puede recuperar cualquiera de los widgets de la ventana del formulario mediante la función widget(), y comprobar si un widget está seleccionado mediante la función isWidgetSelected(). Se puede utilizar la función setProperty() para establecer las propiedades del widget seleccionado, y las funciones setWidgetProperty() o resetWidgetProperty() para modificar las propiedades de cualquier widget dado.

Por último, puedes cambiar la selección modificando el cursor de texto ( position()) mediante las funciones setPosition() y movePosition().

Véase también « QDesignerFormWindowInterface » y « QDesignerFormWindowManagerInterface ».

Documentación sobre tipos de miembros

enum QDesignerFormWindowCursorInterface::MoveMode

Esta enumeración describe los diferentes modos que se utilizan cuando se desplaza el cursor de texto.

ConstanteValorDescripción
QDesignerFormWindowCursorInterface::MoveAnchor0El ancla se desplaza con el cursor hasta su nueva ubicación.
QDesignerFormWindowCursorInterface::KeepAnchor1El ancla permanece en la ubicación anterior del cursor.

enum QDesignerFormWindowCursorInterface::MoveOperation

Esta enumeración describe los tipos de operaciones del cursor de texto que pueden producirse en una ventana de formulario.

ConstanteValorDescripción
QDesignerFormWindowCursorInterface::NoMove0El cursor no se mueve.
QDesignerFormWindowCursorInterface::Start1Mueve el cursor al inicio de la cadena de foco.
QDesignerFormWindowCursorInterface::End2Mueve el cursor al final de la cadena de enfoque.
QDesignerFormWindowCursorInterface::Next3Mueve el cursor al siguiente widget de la cadena de enfoque.
QDesignerFormWindowCursorInterface::Prev4Mueve el cursor al widget anterior de la cadena de foco.
QDesignerFormWindowCursorInterface::Left5El cursor se desplaza hacia la izquierda.
QDesignerFormWindowCursorInterface::Right6El cursor se desplaza hacia la derecha.
QDesignerFormWindowCursorInterface::Up7El cursor se desplaza hacia arriba.
QDesignerFormWindowCursorInterface::Down8El cursor se desplaza hacia abajo.

Documentación de funciones de miembro

[constexpr noexcept default] QDesignerFormWindowCursorInterface::QDesignerFormWindowCursorInterface()

Crea por defecto una instancia de ` QDesignerFormWindowCursorInterface`.

[delete] QDesignerFormWindowCursorInterface::QDesignerFormWindowCursorInterface(const QDesignerFormWindowCursorInterface &)

Crea una instancia de ` QDesignerFormWindowCursorInterface` mediante copia. Esta función se ha eliminado.

[delete] QDesignerFormWindowCursorInterface::QDesignerFormWindowCursorInterface(QDesignerFormWindowCursorInterface &&)

Crea una instancia de ` QDesignerFormWindowCursorInterface` mediante la construcción «move». Esta función se ha eliminado.

[virtual constexpr noexcept default] QDesignerFormWindowCursorInterface::~QDesignerFormWindowCursorInterface()

Elimina la interfaz del cursor.

[pure virtual] QWidget *QDesignerFormWindowCursorInterface::current() const

Devuelve el widget seleccionado actualmente en la ventana del formulario.

Véase también selectedWidget().

[pure virtual] QDesignerFormWindowInterface *QDesignerFormWindowCursorInterface::formWindow() const

Devuelve la interfaz de la ventana del formulario asociada a esta interfaz de cursor.

[pure virtual] bool QDesignerFormWindowCursorInterface::hasSelection() const

Devuelve «true» si la ventana del formulario contiene una selección; en caso contrario, devuelve «false».

bool QDesignerFormWindowCursorInterface::isWidgetSelected(QWidget *widget) const

Devuelve «true» si el « widget » especificado está seleccionado; en caso contrario, devuelve «false».

[pure virtual] bool QDesignerFormWindowCursorInterface::movePosition(QDesignerFormWindowCursorInterface::MoveOperation operation, QDesignerFormWindowCursorInterface::MoveMode mode = MoveAnchor)

Ejecuta la instrucción « operation » indicada en el cursor utilizando el « mode » especificado, y devuelve «true» si se ha completado correctamente; en caso contrario, devuelve «false».

Véanse también position() y setPosition().

[pure virtual] int QDesignerFormWindowCursorInterface::position() const

Devuelve la posición del cursor.

Véase también setPosition() y movePosition().

[pure virtual] void QDesignerFormWindowCursorInterface::resetWidgetProperty(QWidget *widget, const QString &name)

Restablece la propiedad con el valor « name » indicado para el « widget » especificado a su valor por defecto.

Véase también setProperty() y setWidgetProperty().

[pure virtual] QWidget *QDesignerFormWindowCursorInterface::selectedWidget(int index) const

Devuelve el widget con el « index » indicado en la lista de widgets seleccionados.

Véase también current() y widget().

[pure virtual] int QDesignerFormWindowCursorInterface::selectedWidgetCount() const

Devuelve el número de widgets seleccionados en la ventana del formulario.

Véase también widgetCount().

[pure virtual] void QDesignerFormWindowCursorInterface::setPosition(int position, QDesignerFormWindowCursorInterface::MoveMode mode = MoveAnchor)

Establece la posición del cursor en el punto dado position utilizando el mode para especificar cómo se desplaza hasta allí.

Véase también position() y movePosition().

[pure virtual] void QDesignerFormWindowCursorInterface::setProperty(const QString &name, const QVariant &value)

Establece la propiedad « name » del widget seleccionado actualmente en el valor especificado « value ».

Véase también setWidgetProperty() y resetWidgetProperty().

[pure virtual] void QDesignerFormWindowCursorInterface::setWidgetProperty(QWidget *widget, const QString &name, const QVariant &value)

Establece la propiedad con el valor « name » para el elemento « widget » en el valor especificado « value ».

Véanse también resetWidgetProperty() y setProperty().

[pure virtual] QWidget *QDesignerFormWindowCursorInterface::widget(int index) const

Devuelve el widget con el « index » indicado en la lista de widgets de la ventana del formulario.

Véase también selectedWidget().

[pure virtual] int QDesignerFormWindowCursorInterface::widgetCount() const

Devuelve el número de widgets que hay en la ventana del formulario.

Véase también selectedWidgetCount().

[delete] QDesignerFormWindowCursorInterface &QDesignerFormWindowCursorInterface::operator=(QDesignerFormWindowCursorInterface &&)

Asigna mediante «move» other a esta instancia de QDesignerFormWindowCursorInterface. Esta función se elimina.

[delete] QDesignerFormWindowCursorInterface &QDesignerFormWindowCursorInterface::operator=(const QDesignerFormWindowCursorInterface &)

Asigna por copia other a esta instancia de QDesignerFormWindowCursorInterface. Esta función se ha eliminado.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.