kgendesignerplugin - En ligne dans le Cloud

PROGRAMME:

Nom

kgendesignerplugin - Génère des plugins de widgets pour Qt(TM) Designer.

SYNOPSIS

plugin kgendesigner [OPTIONS...] filet

DESCRIPTION

Les plugins de widgets personnalisés pour Qt(TM) Designer suivent généralement un modèle standard, et le
les classes fournies par le plugin fournissent principalement des informations statiques, ainsi que des fonctions pour
créer une instance qui n'est normalement qu'un simple appel de constructeur. plugin kgendesigner
permet aux développeurs de bibliothèques qui fournissent de nouveaux widgets de créer un tel plugin sans
créer tout le code passe-partout associé, en fournissant une description simple de style ini
fichier.

plugin kgendesigner choisit des valeurs par défaut sensées pour la plupart des paramètres, donc une configuration minimale
est généralement nécessaire.

OPTIONS

-o filet
Le nom du fichier C++ généré. S'il n'est pas donné, Stdout sera utilisé.

-n nom-plugin
Fourni pour la compatibilité. La valeur par défaut de l'option PluginName dans l'entrée
fichier.

-g groupe
Fourni pour la compatibilité. La valeur par défaut de l'option DefaultGroup dans l'entrée
fichier.

--auteur
Afficher les informations sur l'auteur.

--Licence
Afficher les informations de licence.

-h, --Aidez-moi
Afficher un bref texte d'aide.

-v , --version
Afficher les informations sur la version.

DOSSIER Format

Le fichier d'entrée est un fichier de configuration de style ini (en particulier, il est au format
pris en charge par le framework KConfig) qui décrit un ensemble de widgets. Il contient un
Section [Global], fournissant des informations générales sur le plugin, et une section pour chaque
widget qui devrait être inclus dans le plugin.

La section [Global] peut contenir les entrées suivantes :

Groupe par défaut
La valeur par défaut pour le Réservation de groupe entrée dans les sections de classe (par défaut : "Personnalisé", sauf si
le -g option est donnée).

Inclus
Une liste (séparée par des virgules) des inclusions requises (par défaut : vide). Notez que l'en-tête
les fichiers des widgets spécifiés plus loin dans le fichier ne doivent pas être répertoriés ici ; à la place, ce
est pour les en-têtes spéciaux pour le propre usage du plugin, comme ceux pour les classes fournissant
aperçus.

Nom du plugin
Le nom de la classe C++ principale dans le plugin (par défaut : "WidgetsPlugin", à moins que le -n
option est donnée).

Chaque classe doit avoir son propre [Nom du cours], qui peut inclure les éléments suivants
entrées :

Modèle de code
La valeur renvoyée par la fonction codeTemplate() du plugin, qui est marquée pour
« utilisation future » ​​par Qt(TM) Designer (par défaut : vide).

ConstructeurArgs
Les arguments à passer au constructeur de la classe donnés par ImplClass ; ceux-ci doivent
être entouré de parenthèses (par défaut : "(parent)"). La seule variable garantie d'être
disponible est mère, qui est le parent QWidget transmis par Qt(TM) Designer.

Cette entrée est ignorée si CreateWidget est défini.

CréerWidget
Le code nécessaire pour créer une instance du widget (par défaut : utilise new pour créer un
instance de la classe donnée par l'entrée ImplClass, en passant les arguments spécifiés par
ConstructorArgs). Voir les notes pour ImplClass et ConstructorArgs.

DomXML
Une description XML UI du widget (par défaut : la valeur par défaut fournie par Qt(TM)
En-têtes de plug-in Designer).

Réservation de groupe
Le groupe sous lequel afficher le widget dans Qt(TM) Designer (par défaut : la valeur du
Groupe par défaut dans la section [Global]).

Nom de l'icône
Le fichier image ou le nom de l'icône standard à utiliser comme icône pour ce widget dans Qt(TM)
Liste des widgets du concepteur (par défaut : un fichier PNG nommé avec le nom de la section, avec n'importe quel double
deux-points supprimés, dans le répertoire « pics » d'un fichier de ressources compilé ; par exemple,
:/pics/Foo.png dans la section [Foo], ou :/pics/FooBar.png dans la section [Foo::Bar]).

Classe Impl
La classe qui doit être utilisée pour créer une instance du widget pour l'utilisation de
Qt(TM) Designer (par défaut : le nom de la section). Notez que cela ne doit pas réellement
être la classe qui serait créée pour une application finale : qui est déterminée par le
DomXML.

Cette entrée est ignorée si CreateWidget est défini.

InclureFichier
L'en-tête qui doit être inclus pour utiliser ce widget (par défaut : la minuscule
version du nom de la section, avec les deux points supprimés et ".h" ajouté ; par exemple,
foo.h dans la section [Foo], ou foobar.h dans la section [Foo::Bar]).

EstConteneur
Si ce widget peut contenir d'autres widgets (par défaut : false).

Info-bulle
L'info-bulle à afficher lors du survol du widget dans la liste des widgets de Qt(TM)
Designer (par défaut : le nom de la section, avec « Widget » ajouté ; par exemple, Foo Widget
dans la section [Foo]).

Qu'est-ce que c'est ça
Le texte What's This associé au widget dans Qt(TM) Designer (par défaut : le
nom de la section, avec " Widget" ajouté ; par exemple, Foo Widget dans la section [Foo]).

EXEMPLES

Le fichier de description le plus simple pourrait ressembler à

[Fou]
ToolTip=Affiche les foos
[Bar]
ToolTip=Éditeur de barres

Notez que chaque classe doit avoir au moins un jeu de clés (ToolTip a été utilisé dans cet exemple),
sinon il sera ignoré.

Habituellement, vous souhaitez modifier au moins le texte visible par l'utilisateur, ce qui signifie l'info-bulle,
WhatsThis et les entrées de groupe. De plus, définir le nom du plugin peut être une bonne idée pour
éviter les conflits de symboles possibles et ne pas confondre les débogueurs (à la fois l'application de débogage
et la personne qui fait le débogage) :

[Global]
NomPlugin=FooWidgets
DefaultGroup=Afficher

[Fou]
ToolTip=Affiche les ours
WhatsThis=Un widget image qui affiche des ours dansants

[Bar]
ToolTip=Éditeur de barres
WhatsThis=Une interface d'édition de barres pour ours
Groupe=Modification

Des fichiers plus complexes peuvent être nécessaires si vous avez des classes avec espace de noms ou des options supplémentaires qui
besoin de fournir aux constructeurs, par exemple :

[Global]
NomPlugin=FooWidgets
Groupe par défaut=Foo

[Foo :: Bar]
ToolTip=Affiche les barres
WhatsThis=Un widget qui affiche les barres d'une manière particulière
InclureFichier=foo/bar.h
IconName=:/previews/bar.png

[Foo :: Baz]
InclureFichier=foo/baz.h
ConstructorArgs=(Foo::Baz::SomeOption, parent)
Groupe=Foo (Spécial)
EstContainer=true
IconName=:/previews/baz.png

Parfois, des widgets particulièrement complexes peuvent nécessiter une implémentation spéciale de "classe de prévisualisation"
pour une utilisation dans Qt(TM) Designer ; cela pourrait être une sous-classe du vrai widget qui fait juste
une configuration supplémentaire, ou il peut s'agir d'une implémentation complètement différente.

[Global]
Comprend=foopreviews.h

[Fantaisie Widget]
ImplClass=FancyWidgetAperçu

Utilisez kgendesignerplugin en ligne en utilisant les services onworks.net