Utilisation de widgets personnalisés avec Qt Widgets Designer

Qt Widgets Designer peut afficher des widgets personnalisés grâce à son mécanisme de plugin extensible, ce qui permet à l'utilisateur et à des tiers d'élargir la gamme des widgets concevables. Il est également possible d'utiliser des widgets existants en tant qu'espaces réservés pour des classes de widgets qui fournissent des API similaires.

Gestion des widgets personnalisés

Bien que Qt Widgets Designer prenne en charge tous les widgets Qt Widgets standard, certains widgets spécialisés peuvent ne pas être disponibles en standard pour un certain nombre de raisons :

• Les widgets personnalisés peuvent ne pas être disponibles au moment de la conception de l'interface utilisateur.
• Les widgets personnalisés peuvent être spécifiques à une plate-forme, et les concepteurs peuvent développer l'interface utilisateur sur une plate-forme différente de celle des utilisateurs finaux.
• Le code source d'un widget personnalisé n'est pas disponible, ou les concepteurs de l'interface utilisateur ne peuvent pas utiliser le widget pour des raisons non techniques.

Dans les situations ci-dessus, il est toujours possible de concevoir des formulaires dans le but d'utiliser des widgets personnalisés dans l'application. Pour ce faire, nous pouvons utiliser la fonction de promotion des widgets de Qt Widgets Designer.

Dans tous les autres cas, lorsque le code source des widgets personnalisés est disponible, nous pouvons adapter le widget personnalisé pour l'utiliser avec Qt Widgets Designer.

Promotion des widgets

Si certains formulaires doivent être conçus, mais que certains widgets personnalisés ne sont pas disponibles pour le concepteur, nous pouvons remplacer les widgets manquants par des widgets similaires. Par exemple, nous pouvons représenter les instances d'une classe de bouton-poussoir personnalisée, MyPushButton, par des instances de QPushButton et les promouvoir à MyPushButton afin que l 'uic génère le code approprié pour cette classe manquante.

Lors du choix d'un widget à utiliser comme placeholder, il est utile de comparer l'API du widget manquant avec celle des widgets Qt Widgets standard. Pour les widgets spécialisés qui sous-classent des classes standard, le choix évident de l'espace réservé est la classe de base du widget personnalisé ; par exemple, QSlider peut être utilisé pour les sous-classes spécialisées de QSlider.

Pour les widgets spécialisés qui ne partagent pas d'API commune avec les widgets standard de Qt Widgets, il convient d'envisager d'adapter un widget personnalisé pour l'utiliser dans Qt Widgets Designer. Si cela n'est pas possible, QWidget est le choix évident pour un widget d'espace réservé puisqu'il s'agit du plus petit dénominateur commun pour tous les widgets.

Pour ajouter un espace réservé, sélectionnez un objet d'une classe de base appropriée et choisissez Promouvoir vers ... dans le menu contextuel du formulaire. Après avoir saisi le nom de la classe et le fichier d'en-tête dans la partie inférieure de la boîte de dialogue, sélectionnez Ajouter. La classe de remplacement apparaît alors avec la classe de base dans la liste supérieure. Cliquez sur le bouton Promouvoir pour accepter ce choix.

Désormais, lorsque le menu contextuel du formulaire est ouvert sur des objets de la classe de base, la classe de remplacement apparaît dans le sous-menu Promouvoir vers, ce qui permet de promouvoir facilement des objets dans cette classe.

Un widget promu peut être ramené à sa classe de base en choisissant Demote to dans le menu contextuel du formulaire.

Widgets personnalisés définis par l'utilisateur

Les widgets personnalisés peuvent être adaptés à Qt Widgets Designer, ce qui permet aux concepteurs de configurer l'interface utilisateur à l'aide des widgets réels qui seront utilisés dans une application plutôt qu'à l'aide de widgets de remplacement. Le processus de création d'un plugin de widget personnalisé est décrit dans le chapitre Création de widgets personnalisés pour Qt Widgets Designer de ce manuel.

Pour utiliser un plugin créé de cette manière, il est nécessaire de s'assurer que le plugin se trouve sur un chemin que Qt Widgets Designer recherche pour les plugins. En général, les plugins stockés dans $QTDIR/plugins/designer sont chargés au démarrage de Qt Widgets Designer. De plus amples informations sur la création et l'installation de plugins sont disponibles ici. Vous pouvez également consulter le document Plugins HOWTO pour obtenir des informations sur la création de plugins.