QWidgetAction Class

Descripción detallada

La mayoría de las acciones en una aplicación se representan como elementos en menús o botones en barras de herramientas. Sin embargo, a veces son necesarios widgets más complejos. Por ejemplo, una acción de zoom en un procesador de textos puede realizarse utilizando un QComboBox en un QToolBar, presentando un rango de diferentes niveles de zoom. QToolBar proporciona QToolBar::insertWidget() como función de conveniencia para insertar un único widget. Sin embargo, si quieres implementar una acción que utilice widgets personalizados para la visualización en múltiples contenedores, entonces tienes que subclasificar QWidgetAction.

Si se añade un QWidgetAction por ejemplo a QToolBar entonces se llama a QWidgetAction::createWidget(). Las reimplementaciones de esa función deberían crear un nuevo widget personalizado con el padre especificado.

Si la acción se elimina de un widget contenedor, entonces se llama a QWidgetAction::deleteWidget() con el widget personalizado creado previamente como argumento. La implementación por defecto oculta el widget y lo elimina utilizando QObject::deleteLater().

Si sólo tienes un widget personalizado, puedes establecerlo como widget predeterminado utilizando setDefaultWidget(). Ese widget se usará entonces si la acción se añade a QToolBar, o en general a un contenedor de acciones que soporte QWidgetAction. Si una QWidgetAction con sólo un widget por defecto se añade a dos barras de herramientas al mismo tiempo, entonces el widget por defecto se muestra sólo en la primera barra de herramientas a la que se añadió la acción. QWidgetAction asume la propiedad del widget por defecto.

Ten en cuenta que depende del widget activar la acción, por ejemplo reimplementando manejadores de eventos de ratón y llamando a QAction::trigger().

macOS: Si añades un widget a un menú de la barra de menús de la aplicación en macOS, el widget se añadirá y funcionará pero con algunas limitaciones:

1. El widget se reasigna desde QMenu a la vista nativa del menú. Si muestra el menú en algún otro lugar (por ejemplo, como un menú emergente), el widget no estará allí.
2. No es posible manejar el widget desde el foco/teclado.
3. Debido al diseño de Apple, actualmente no funciona el seguimiento del ratón en el widget.
4. Conectar la señal triggered() a una ranura que abre un diálogo modal provocará un fallo en macOS 10.4 (error conocido reconocido por Apple), una solución es utilizar una QueuedConnection en lugar de una DirectConnection.