Uso de widgets personalizados con Qt Widgets Designer

Qt Widgets Designer puede mostrar widgets personalizados a través de su mecanismo de plugin extensible, permitiendo que el rango de widgets diseñables sea extendido por el usuario y terceras partes. Alternativamente, es posible usar widgets existentes como marcadores de posición para clases de widgets que proporcionan APIs similares.

Manejo de widgets personalizados

Aunque Qt Widgets Designer soporta todos los widgets estándar de Qt, algunos widgets especializados pueden no estar disponibles de forma estándar por varias razones:

• Los widgets personalizados pueden no estar disponibles en el momento de diseñar la interfaz de usuario.
• Los widgets personalizados pueden ser específicos de una plataforma, y los diseñadores pueden estar desarrollando la interfaz de usuario en una plataforma diferente a la de los usuarios finales.
• El código fuente de un widget personalizado no está disponible, o los diseñadores de la interfaz de usuario no pueden utilizar el widget por razones no técnicas.

En las situaciones anteriores, aún es posible diseñar formularios con el objetivo de utilizar widgets personalizados en la aplicación. Para ello, podemos utilizar la función de promoción de widgets de Qt Widgets Designer.

En todos los demás casos, cuando el código fuente de los widgets personalizados está disponible, podemos adaptar el widget personalizado para su uso con Qt Widgets Designer.

Promoción de widgets

Si algunos formularios deben ser diseñados, pero ciertos widgets personalizados no están disponibles para el diseñador, podemos sustituir widgets similares para representar los widgets que faltan. Por ejemplo, podemos representar instancias de una clase personalizada de botón pulsador, MyPushButton, con instancias de QPushButton y promoverlas a MyPushButton para que uic genere el código adecuado para esta clase que falta.

Al elegir un widget para utilizarlo como marcador de posición, es útil comparar la API del widget que falta con las de los widgets Qt estándar. Para widgets especializados que subclasifican clases estándar, la elección obvia de marcador de posición es la clase base del widget personalizado; por ejemplo, QSlider podría utilizarse para subclases especializadas de QSlider.

Para widgets especializados que no comparten una API común con los widgets Qt estándar, merece la pena considerar la adaptación de un widget personalizado para su uso en Qt Widgets Designer. Si esto no es posible, QWidget es la elección obvia para un widget marcador de posición, ya que es el mínimo común denominador para todos los widgets.

Para añadir un marcador de posición, seleccione un objeto de una clase base adecuada y elija Promover a... en el menú contextual del formulario. Tras introducir el nombre de la clase y el archivo de cabecera en la parte inferior del cuadro de diálogo, seleccione Añadir. La clase del marcador de posición aparecerá ahora junto con la clase base en la lista superior. Haga clic en el botón Promover para aceptar esta elección.

Ahora, cuando el menú contextual del formulario se abra sobre los objetos de la clase base, la clase del marcador de posición aparecerá en el submenú Promover a, permitiendo una cómoda promoción de objetos a esa clase.

Un widget promocionado puede ser revertido a su clase base seleccionando Desmotivar a en el menú contextual del formulario.

Widgets personalizados definidos por el usuario

Los widgets personalizados pueden adaptarse para su uso con Qt Widgets Designer, dando a los diseñadores la oportunidad de configurar la interfaz de usuario utilizando los widgets reales que se utilizarán en una aplicación en lugar de widgets de marcador de posición. El proceso de creación de un plugin de widgets personalizados se describe en el capítulo Creación de widgets personalizados para Qt Widgets Designer de este manual.

Para utilizar un plugin creado de esta forma, es necesario asegurarse de que el plugin se encuentra en una ruta en la que Qt Widgets Designer busque plugins. Generalmente, los plugins almacenados en $QTDIR/plugins/designer se cargarán cuando se inicie Qt Widgets Designer. Puede encontrar más información sobre la creación e instalación de plugins aquí. También puede consultar el documento Plugins HOWTO para obtener información sobre la creación de plugins.