Utilisation de widgets personnalisés avec le Designer d'Qt Widgets

Qt Widgets Designer peut afficher des widgets personnalisés grâce à son mécanisme de plugins extensible, ce qui permet à l’utilisateur et à des tiers d’élargir la gamme de widgets personnalisables. Il est également possible d’utiliser des widgets existants comme espaces réservés pour des classes de widgets fournissant des API similaires.

Gestion des widgets personnalisés

Bien que Designer d’ Qt Widgets prenne en charge tous les widgets Qt standard, certains widgets spécialisés peuvent ne pas être disponibles en standard pour plusieurs 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 plateforme, et les concepteurs peuvent développer l’interface utilisateur sur une plateforme différente de celle des utilisateurs finaux.
• Le code source d’un widget personnalisé n’est pas disponible, ou les concepteurs d’interface utilisateur ne peuvent pas utiliser ce widget pour des raisons non techniques.

Dans les situations ci-dessus, il est tout de même possible de concevoir des formulaires en vue d’utiliser des widgets personnalisés dans l’application. Pour ce faire, nous pouvons utiliser la fonctionnalité de promotion des widgets de Designer d’ Qt Widgets.

Dans tous les autres cas, lorsque le code source des widgets personnalisés est disponible, nous pouvons adapter le widget personnalisé pour qu’il soit utilisé 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 les remplacer par des widgets similaires afin de représenter les widgets manquants. Par exemple, nous pourrions représenter des instances d’une classe de bouton personnalisée, ` MyPushButton`, par des instances de ` QPushButton ` et les promouvoir en ` MyPushButton `, afin que `uic` génère le code approprié pour cette classe manquante.

Lors du choix d’un widget à utiliser comme espace réservé, il est utile de comparer l’API du widget manquant avec celles des widgets Qt standard. Pour les widgets spécialisés qui héritent de classes standard, le choix évident d’espace réservé est la classe de base du widget personnalisé ; par exemple, QSlider pourrait ê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 Qt standard, il vaut la peine d’envisager d’adapter un widget personnalisé pour une utilisation dans l’ Qt Widgets Designer. Si cela n’est pas possible, alors QWidget est le choix évident pour un widget de remplacement, car il s’agit du plus petit dénominateur commun à 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, cliquez sur « Ajouter ». La classe de l’espace réservé apparaîtra alors aux côtés de la classe de base dans la liste supérieure. Cliquez sur le bouton « Promouvoir » pour valider ce choix.

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

Un widget promu peut être ramené à sa classe de base en sélectionnant « Rétrograder vers » dans le menu contextuel du formulaire.

Widgets personnalisés définis par l’utilisateur

Les widgets personnalisés peuvent être adaptés pour être utilisés avec 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 que des 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 plug-in ainsi créé, il est nécessaire de s’assurer que celui-ci se trouve sur un chemin d’accès où Qt Widgets Designer recherche les plug-ins. En règle générale, les plug-ins stockés dans $QTDIR/plugins/designer seront chargés au démarrage d’ Qt Widgets Designer. Vous trouverez ici de plus amples informations sur la création et l’installation de plug-ins. Vous pouvez également consulter le document « Plugins HOWTO » pour obtenir des informations sur la création de plug-ins.