KGENDESIGNERPLUGI(1) Frameworks de KDE: KDesignerPl KGENDESIGNERPLUGI(1) NOM kgendesignerplugin - Genera connectors de giny per a Qt(TM) Designer. SINOPSI kgendesignerplugin [OPCIONS...] fitxer DESCRIPCIO Els connectors de giny personalitzats per a Qt(TM) Designer solen seguir un patro estandard, i les classes proporcionades pel connector proporcionen principalment informacio estatica, juntament amb la funcio de crear una instancia que normalment nomes es una crida de constructor senzill. kgendesignerplugin permet als desenvolupadors de biblioteques que proporcionen ginys nous, el fet de crear un connector d'este tipus sense necessitat de crear tot el codi repetitiu associat, proporcionant un senzill fitxer de descripcio d'estil ini. kgendesignerplugin tria els valors predeterminats per a la majoria de les opcions de configuracio, de manera que sol ser necessaria una configuracio minima. OPCIONS -o fitxer El nom per al fitxer C++ generat. Si no es dona, s'utilitza l'eixida estandard (stdout). -n nom_del_connector Es proporciona per compatibilitat. El valor predeterminat per a l'opcio PluginName al fitxer d'entrada. -g grup Es proporciona per compatibilitat. El valor predeterminat per a l'opcio DefaultGroup al fitxer d'entrada. --author Mostra informacio sobre l'autoria. --license Mostra informacio sobre la llicencia. -h, --help Mostra un text breu d'ajuda. -v, --version Mostra informacio sobre la versio. FORMAT DEL FITXER El fitxer d'entrada es un fitxer de configuracio d'estil ini (en concret, es el format implementat per l'entorn de treball KConfig), el qual descriu un conjunt de ginys. Conte una seccio [Global], la qual proporciona informacio general sobre el connector, i una seccio per a cada giny que s'ha d'incloure en el connector. La seccio [Global] conte les seguents entrades: DefaultGroup El valor predeterminat per a l'entrada Group en les seccions de classe (predeterminat: <>, a menys que s'indique l'opcio -g). Includes Una llista (separada per comes) dels <> requerits (predeterminat: buida). Cal tindre en compte que els fitxers de capcalera per als ginys especificats mes avant al fitxer no s'han de llistar aci. En canvi, aco es per a les capcaleres especials per a l'us propi del connector, com les de les classes que proporcionen vistes previes. PluginName El nom de la classe de C++ principal en el connector (predeterminat: <>, a menys que s'indique l'opcio -n). Cada classe ha de tindre la seua propia seccio [ClassName], la qual pot incloure les seguents entrades: CodeTemplate El valor retornat per la funcio codeTemplate() del connector, la qual es marcada per a <> per Qt(TM) Designer (predeterminat: buida). ConstructorArgs Els arguments que s'ha de passar al constructor de la classe indicada per ImplClass. Estos han d'estar envoltats entre parentesis (predeterminat: <<(parent)>>). L'unica variable garantida que estara disponible es la parent, la qual es la pare de QWidget passada per Qt(TM) Designer. Esta entrada sera ignorada si s'establix CreateWidget. CreateWidget El codi necessari per a crear una instancia del giny (predeterminat: utilitza new per a crear una instancia de la classe indicada per l'entrada ImplClass, passant els arguments especificats per ConstructorArgs). Vegeu les notes per a ImplClass i ConstructorArgs. DomXML Una descripcio IU en XML del giny (predeterminat: el valor predeterminat proporcionat per les capcaleres al connector de Qt(TM) Designer). Group El grup per a mostrar el giny davall Qt(TM) Designer (predeterminat: el valor de l'entrada DefaultGroup a la seccio [Global]). IconName El fitxer d'imatge o nom d'icona estandard que s'utilitza com a icona per a este giny en la llista de ginys de Qt(TM) Designer (predeterminat: un fitxer PNG anomenat amb el nom de la seccio, eliminant qualsevol caracter de dos punts, al directori <> dins d'un fitxer de recursos compilat. Per exemple, :/pics/Foo.png a la seccio [Foo], o :/pics/FooBar.png a la seccio [Foo::Bar]). ImplClass La classe que s'ha d'utilitzar per a crear una instancia del giny per a l'us de Qt(TM) Designer (predeterminat: el nom de la seccio). Cal tindre en compte que este en realitat no ha de per que ser la classe que es crearia per a una aplicacio final: esta determinat per la DomXML. Esta entrada sera ignorada si s'establix CreateWidget. IncludeFile La capcalera que s'ha d'incloure per a utilitzar-la amb este giny (predeterminat: la versio en minuscules del nom de la seccio, eliminant qualsevol caracter de dos punts i annexant <<*.h>>. Per exemple, foo.h en la seccio [Foo], o foobar.h en la seccio [Foo::Bar]). IsContainer Si este giny pot contindre altres ginys (predeterminat: false). ToolTip El consell d'eina que es mostrara quan es passe per damunt del giny en la llista de ginys de Qt(TM) Designer (predeterminat: el nom de la seccio, amb <> annexat. Per exemple, Foo Widget en la seccio [Foo]). WhatsThis El text de <> associat amb el giny a Qt(TM) Designer (predeterminat: el nom de la seccio, amb <> annexat. Per exemple, Foo Widget en la seccio [Foo]). EXEMPLES El fitxer de descripcio mes senzill podria pareixer-se a aco: [Foo] ToolTip=Displays foos [Bar] ToolTip=Bar editor Cal tindre en compte que cada classe almenys haura de tindre un conjunt de claus (en este exemple s'utilitza ToolTip), en cas contrari s'ignorara. Usualment, voldreu canviar el text a almenys visible per l'usuari, el qual vol dir les entrades ToolTip, WhatsThis i Group. A mes, establir el nom del connector pot ser una bona idea per a evitar possibles col.lisions de simbol i no confondre als depuradors (tant l'aplicacio del depurador com la persona que realitza la depuracio): [Global] PluginName=FooWidgets DefaultGroup=Display [Foo] ToolTip=Displays bears WhatsThis=An image widget that displays dancing bears [Bar] ToolTip=Bar editor WhatsThis=An editor interface for bars for bears Group=Editing Poden ser necessaris fitxers mes complexos si teniu classes d'espais de nom o opcions addicionals que necessiten ser subministrades als constructors, per exemple: [Global] PluginName=FooWidgets DefaultGroup=Foo [Foo::Bar] ToolTip=Displays bars WhatsThis=A widget that displays bars in a particular way IncludeFile=foo/bar.h IconName=:/previews/bar.png [Foo::Baz] IncludeFile=foo/baz.h ConstructorArgs=(Foo::Baz::SomeOption, parent) Group=Foo (Special) IsContainer=true IconName=:/previews/baz.png De vegades els ginys especialment complexos poden necessitar una implementacio <> especial per al seu us en Qt(TM) Designer. Esta podria ser una subclasse del giny real, la qual nomes faria alguna configuracio addicional, o podria ser una implementacio completament diferent. [Global] Includes=foopreviews.h [FancyWidget] ImplClass=FancyWidgetPreview VEGEU TAMBE https://doc.qt.io/qt-5/designer-creating-custom-widgets.html La documentacio de Qt(TM) Designer sobre la creacio de connectors per a ginys personalitzats. ERRORS Utilitzeu el Seguidor d'errors de KDE[1] (escriviu-hi en angles) per a informar-ne, no envieu cap correu directament als autors. AUTORS Johnson, Richard Va escriure la documentacio original. Merry, Alex Ha actualitzat la documentacio al Frameworks 5 de KDE. NOTES 1. Seguidor d'errors de KDE https://bugs.kde.org Frameworks de KDE Frameworks 5 28 de maig de 2014 KGENDESIGNERPLUGI(1)